Funkcja MsgBox

Wyświetla okno dialogowe zawierające komunikat i zwraca wartość.

Składnia:


MsgBox (Prompt As String [,Buttons = MB_OK [,Title As String]]) As Integer

Parametry:

prompt: wyrażenie w postaci ciągu wyświetlane jako komunikat w oknie dialogowym. Znak Chr$(13) w ciągu powoduje podział wiersza.

title: ciąg wyświetlany w postaci komunikatu w oknie dialogowym. W przypadku braku tego ciągu na pasku tytułowym jest wyświetlana nazwa odpowiedniej aplikacji.

buttons: dowolne wyrażenie w postaci liczby całkowitej określające typ okna dialogowego, a także typ i liczbę wyświetlanych przycisków oraz typ ikony. buttons oznacza kombinację ciągów binarnych czyli kombinację elementów definiowanych poprzez dodanie odpowiadających im wartości:

Nazwa stała

Wartość całkowita (integer)

Definicja

MB_OK

0

Wyświetlanie tylko przycisku OK.

MB_OKCANCEL

1

Wyświetlanie przycisku OK i przycisku Anuluj.

MB_ABORTRETRYIGNORE

2

Wyświetlanie przycisku Anuluj, Ponów i przycisku Ignoruj.

MB_YESNOCANCEL

3

Wyświetlanie przycisków Tak, Nie i Anuluj.

MB_YESNO

4

Wyświetlanie przycisków Tak i Nie.

MB_RETRYCANCEL

5

Wyświetlanie przycisków Ponów próbę i Anuluj.

MB_ICONSTOP

16

Dodanie do okna dialogowego ikony Stop.

MB_ICONQUESTION

32

Dodanie do okna dialogowego ikony Pytanie.

MB_ICONEXCLAMATION

48

Dodanie do okna dialogowego ikony Wykrzyknik.

MB_ICONINFORMATION

64

Dodanie do okna dialogowego ikony Informacja.

128

Przyciskiem domyślnym jest pierwszy przycisk okna dialogowego.

MB_DEFBUTTON2

256

Przyciskiem domyślnym jest drugi przycisk okna dialogowego.

MB_DEFBUTTON3

512

Przyciskiem domyślnym jest trzeci przycisk okna dialogowego.


Zwracana wartość:

Liczba całkowita

Nazwana stała

Wartość całkowita

Definicja

IDOK

1

OK

IDCANCEL

2

Anuluj

IDABORT

3

Przerwij

IDRETRY

4

Ponów

IDIGNORE

5

Ignoruj

IDYES

6

Tak

IDNO

7

Nie


Kody błędów:

5 Nieprawidłowe wywołanie procedury

Przykład:


Sub ExampleMsgBox
Dim sVar As Integer
 sVar = MsgBox("Las Vegas")
 sVar = MsgBox("Las Vegas",1)
 sVar = MsgBox( "Las Vegas",256 + 16 + 2,"Nazwa okna dialogowego")
 sVar = MsgBox("Las Vegas", MB_DEFBUTTON2 + MB_ICONSTOP + MB_ABORTRETRYIGNORE, "Tytuł okna dialogowego")
End Sub

Prosimy o wsparcie!