W bazie danych MsgBox programu Access dla komputerów stacjonarnych funkcja wyświetla komunikat w oknie dialogowym, czeka, aż użytkownik wybierze przycisk, i zwraca wartość wskazującą Integer , który przycisk został wybrany przez użytkownika.
Składnia
MsgBox(prompt[, buttons][, title][, helpfile][, context])
W MsgBox składni funkcji występują następujące argumenty:
| Argument | Opis |
|---|---|
prompt |
Argument wymagany. Wyrażenie tekstowe wyświetlane jako komunikat w oknie dialogowym. Maksymalna długość prompt to około 1024 znaków, w zależności od szerokości użytych znaków. Jeśli prompt wiersz jest dłuższy, można je rozdzielić za pomocą znaku powrotu karetki (Chr(13)), znaku nowego wiersza (Chr(10)) lub kombinacji powrotu karetki-nowego wiersza (Chr(13) & Chr(10)). |
buttons |
Argument opcjonalny. Wyrażenie liczbowe będące sumą wartości określających liczbę i typ przycisków do wyświetlenia, styl ikony do użycia, tożsamość przycisku domyślnego i modalność okna komunikatu. W razie pominięcia domyślnie wartością buttons argumentu jest 0. |
title |
Argument opcjonalny. Wyrażenie ciągu wyświetlane na pasku tytułu okna dialogowego. W przypadku pominięcia titlenazwy aplikacji na pasku tytułu będzie wyświetlana jej nazwa. |
helpfile |
Argument opcjonalny. Wyrażenie tekstowe identyfikujące plik Pomocy, który ma zostać użyty w celu udostępnienia kontekstowej Pomocy dla okna dialogowego. Jeśli helpfile jest podany, context należy również podać. |
context |
Argument opcjonalny. Wyrażenie liczbowe będące numerem kontekstu Pomocy przypisanym do odpowiedniego tematu Pomocy przez autora Pomocy. Jeśli context jest podany, helpfile należy również podać. |
Ustawienia
Ustawienia argumentów buttons są następujące:
| Stała | Value (Wartość) | Opis |
|---|---|---|
vbOKOnly |
0 |
Wyświetlanie tylko OK . |
vbOKCancel |
1 |
Wyświetl OK i Anuluj. |
vbAbortRetryIgnore |
2 |
Wyświetlanie opcji Przerwij, Ponów próbę i Ignoruj. |
vbYesNoCancel |
3 |
Wyświetlanie przycisków Tak, Nie i Anuluj. |
vbYesNo |
4 |
Wyświetlanie opcji Tak i Nie. |
vbRetryCancel |
5 |
Wyświetl Ponów próbę i Anuluj. |
vbCritical |
16 |
Wyświetlanie ikony wiadomości krytycznej . |
vbQuestion |
32 |
Wyświetlanie ikony Kwerenda ostrzegawcza . |
vbExclamation |
48 |
Wyświetlanie ikony komunikatu ostrzegawczego . |
vbInformation |
64 |
Wyświetlanie ikony komunikatu informacyjnego . |
vbDefaultButton1 |
0 |
Ustaw pierwszy przycisk jako domyślny. |
vbDefaultButton2 |
256 |
Ustaw drugi przycisk jako domyślny. |
vbDefaultButton3 |
512 |
Ustaw trzeci przycisk jako domyślny. |
vbDefaultButton4 |
768 |
Ustaw czwarty przycisk jako domyślny. |
vbApplicationModal |
0 |
Modalny aplikacji. Przed kontynuowaniem pracy w bieżącej aplikacji użytkownik musi odpowiedzieć na okno komunikatu. |
vbSystemModal |
4096 |
Modalny systemowy. Wszystkie aplikacje są zawieszone do czasu udzielenia odpowiedzi przez użytkownika na okno komunikatu. |
vbMsgBoxHelpButton |
16384 |
Dodaj przycisk Pomoc do okna wiadomości. |
VbMsgBoxSetForeground |
65536 |
Określ okno komunikatu jako okno pierwszego planu. |
vbMsgBoxRight |
524288 |
Wyrównanie tekstu do prawej. |
vbMsgBoxRtlReading |
1048576 |
Wyświetlanie tekstu z zapisem od prawej do lewej w systemach hebrajskim i arabskim. |
Pierwsza grupa wartości (0 do 5) opisuje liczbę i typ przycisków wyświetlanych w oknie dialogowym. Druga grupa (16, 32, 48, 64) opisuje styl ikony. Trzecia grupa (0, 256512, ) określa, który przycisk jest domyślny. Czwarta grupa (0, 4096) określa modalność okna komunikatu. Podczas dodawania liczb w celu utworzenia ostatecznej wartości buttons argumentu używaj tylko jednej liczby z każdej grupy.
Uwaga
Te stałe są określone przez język Visual Basic for Applications. W związku z tym możesz użyć nazw w dowolnym miejscu kodu zamiast rzeczywistych wartości.
Wartości zwracane
| Stała | Value (Wartość) | Opis |
|---|---|---|
vbOK |
1 |
OK |
vbCancel |
2 |
Anuluj |
vbAbort |
3 |
Przerwij |
vbRetry |
4 |
Ponów próbę |
vbIgnore |
5 |
Ignoruj |
vbYes |
6 |
Tak |
vbNo |
7 |
Nie |
Spostrzeżenia
Po podaniu obu helpfile typów i context użytkownik może nacisnąć klawisz F1 w systemie Windows lub Pomoc w systemie macOS, aby wyświetlić temat Pomocy zgodny contextz regułami. Niektóre aplikacje hosta, takie jak Microsoft Excel, także automatycznie dodają przycisk Pomoc do okna dialogowego.
Jeśli w oknie dialogowym jest wyświetlany przycisk Anuluj , naciśnięcie klawisza Esc ma taki sam skutek, jak wybranie przycisku Anuluj. Jeśli okno dialogowe zawiera przycisk Pomoc , dla tego okna dialogowego jest dostępna pomoc kontekstowa. Jednak żadna wartość nie jest zwracana, dopóki użytkownik nie wybierze jednego z pozostałych przycisków.
Uwaga
Aby określić więcej niż pierwszy nazwany argument, należy użyć MsgBox w wyrażeniu. Aby pominąć niektóre argumenty pozycyjne, należy użyć odpowiadającego im ogranicznika przecinka.
Przykład
Uwaga
W poniższym przykładzie pokazano, jak używać tej funkcji w module języka Visual Basic for Applications (VBA).
W tym przykładzie tej funkcji użyto MsgBox do wyświetlenia komunikatu o błędzie krytycznym w oknie dialogowym z przyciskami Tak i Nie . Przycisk Nie jest określony jako domyślna odpowiedź. Wartość zwracana MsgBox przez funkcję zależy od przycisku wybranego przez użytkownika. W tym przykładzie założono, że DEMO.HLP jest to plik Pomocy zawierający temat o numerze kontekstu 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