W bazie danych Access dla komputerów stacjonarnych funkcja MsgBox wyświetla komunikat w oknie dialogowym, czeka na kliknięcie przycisku przez użytkownika i zwraca liczbę całkowitą wskazującą, który przycisk kliknął użytkownik.
Składnia
MsgBox ( monit [, przyciski ] [, tytuł ] [, helpfile ] [, kontekst ] )
W składni funkcji MsgBox występują następujące argumenty:
|
Argument |
Opis |
|---|---|
|
Wierszu |
Argument wymagany. Wyrażenie ciągu wyświetlane jako wiadomość w oknie dialogowym. Maksymalna długość monitu wynosi około 1024 znaków, w zależności od szerokości używanych znaków. Jeśli monit składa się z więcej niż jednego wiersza, możesz rozdzielić linie za pomocą znaku powrotu karetki (Chr(13)), znaku kanału wiersza (Chr(10)) lub powrotu karetki — kombinacji znaków ze znakiem linii (Chr(13) & Chr(10)) między poszczególnymi wierszami. |
|
przyciski |
Argument opcjonalny. wyrażenie numeryczne to suma wartości określających liczbę i typ wyświetlanych przycisków, styl ikony do użycia, tożsamość przycisku domyślnego oraz modalność pola wiadomości. W przypadku pominięcia wartością domyślną przycisków jest 0. |
|
Tytuł |
Argument opcjonalny. Wyrażenie ciągu wyświetlane na pasku tytułu okna dialogowego. Jeśli tytuł zostanie pominięty, nazwa aplikacji zostanie umieszczona na pasku tytułu. |
|
Helpfile |
Argument opcjonalny. Wyrażenie ciągu identyfikujące plik Pomocy, który ma być używany w celu zapewnienia kontekstowej Pomocy dla tego okna dialogowego. Jeśli podano plik pomocy, kontekst również musi być podany. |
|
Kontekście |
Argument opcjonalny. Wyrażenie liczbowe będące numerem kontekstowym Pomocy przypisanym do odpowiedniego tematu Pomocy przez autora Pomocy. Jeśli kontekst jest podany, plik pomocy również musi być podany. |
Ustawienia
Przyciskiargument ustawieniach to:
|
Stała |
Value (Wartość) |
Opis |
|---|---|---|
|
vbOKOnly |
0 |
Tylko przycisk Wyświetl OK . |
|
vbOKCancel |
1 |
Wyświetlanie przycisków OK i Anuluj . |
|
vbAbortRetryIgnore |
2 |
Wyświetlanie przycisków Przerwanie, Ponów próbę i Ignoruj . |
|
vbYesNoCancel |
3 |
Wyświetlanie przycisków Tak, Nie i Anuluj . |
|
vbYesNo |
4 |
Wyświetlanie przycisków Tak i Nie . |
|
vbRetryCancel |
5 |
Wyświetlanie przycisków Ponów próbę i Anuluj . |
|
vbCritical |
16 |
Wyświetl ikonę Wiadomość krytyczna . |
|
vbQuestion |
32 |
Ikona Wyświetl zapytanie ostrzegawcze . |
|
vbExclamation |
48 |
Ikona Wyświetl komunikat ostrzegawczy . |
|
vbInformacja |
64 |
Ikona Komunikat o wyświetlaniu informacji . |
|
vbDefaultButton1 |
0 |
Pierwszy przycisk jest domyślny. |
|
vbDefaultButton2 |
256 |
Drugi przycisk jest domyślny. |
|
vbDefaultButton3 |
512 |
Trzeci przycisk jest domyślny. |
|
vbDefaultButton4 |
768 |
Czwarty przycisk jest domyślny. |
|
vbApplicationModal |
0 |
Modalna aplikacja; użytkownik musi odpowiedzieć na pole komunikatu przed kontynuowaniem pracy w bieżącej aplikacji. |
|
vbSystemModal |
4096 |
Modalny system; wszystkie aplikacje zostaną zawieszone, dopóki użytkownik nie odpowie na to pole wiadomości. |
|
vbMsgBoxHelpButton |
16384 |
Dodaje przycisk Pomoc do okna wiadomości |
|
VbMsgBoxSetForeground |
65536 |
Określa okno okna okna wiadomości jako okno pierwszego planu |
|
vbMsgBoxRight |
524288 |
Wyrównanie tekstu do prawej |
|
vbMsgBoxRtlReading |
1048576 |
Określa, że tekst powinien być wyświetlany jako odczyt od prawej do lewej w systemach hebrajskim i arabskim |
Pierwsza grupa wartości (0–5) opisuje liczbę i typ przycisków wyświetlanych w oknie dialogowym. Druga grupa (16, 32, 48, 64) opisuje styl ikony; Trzecia grupa (0, 256, 512) określa, który przycisk jest domyślny; a czwarta grupa (0, 4096) określa modalność pola wiadomości. Podczas dodawania liczb w celu utworzenia wartości końcowej dla argumentu przycisków należy użyć tylko jednej liczby z każdej grupy.
Uwaga: Stałe te są określane przez Visual Basic for Applications. W związku z tym nazwy mogą być używane w dowolnym miejscu w kodzie zamiast rzeczywistych wartości.
Zwracane wartości
|
Stała |
Value (Wartość) |
Opis |
|---|---|---|
|
vbOK |
1 |
OK |
|
vbCancel |
2 |
Anuluj |
|
vbAbort |
3 |
Przerwać |
|
vbRetry |
4 |
Ponów próbę |
|
vbIgnore |
5 |
Ignoruj |
|
vbYes |
6 |
Tak |
|
vbNo |
7 |
Nie |
Uwagi
Po podaniu zarówno pliku pomocy , jak i kontekstu użytkownik może nacisnąć klawisz F1 (Windows) lub HELP (macOS), aby wyświetlić temat Pomocy odpowiadający kontekstowi. Niektóre aplikacje hosta, na przykład program Microsoft Excel, również automatycznie dodają przycisk Pomoc do okna dialogowego.
Jeśli w oknie dialogowym jest wyświetlany przycisk Anuluj , naciśnięcie klawisza ESC działa tak samo jak kliknięcie przycisku Anuluj. Jeśli okno dialogowe zawiera przycisk Pomoc , dla tego okna dialogowego jest dostępna pomoc kontekstowa. Jednak żadna wartość nie jest zwracana do momentu kliknięcia jednego z pozostałych przycisków.
Uwaga: Aby określić więcej niż pierwszy nazwany argument, należy użyć usługi MsgBox w wyrażenie. Aby pominąć niektóre argumenty pozycyjne, należy uwzględnić odpowiadający im ogranicznik przecinka.
Przykład
Uwaga: Poniższe przykłady przedstawiają sposób użycia tej funkcji w module języka Visual Basic for Applications (VBA).
W tym przykładzie użyto funkcji MsgBox w celu wyświetlenia komunikatu o błędzie krytycznym w oknie dialogowym z przyciskami Tak i Nie. Domyślną odpowiedzią jest przycisk Nie. Wartość zwracana przez funkcję MsgBox zależy od przycisku wybranego przez użytkownika. W tym przykładzie założono, że DEMO.HLP to plik Pomocy zawierający temat z numerem kontekstowym Pomocy równym 1000.
Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then ' User chose Yes.
MyString = "Yes" ' Perform some action.
Else ' User chose No.
MyString = "No" ' Perform some action.
End If
