Access datora datu bāzē funkcija parāda ziņojumu dialoglodziņā, gaida, līdz lietotājs atlasa pogu, un atgriež ziņojumuInteger, MsgBox kas norāda, kuru pogu lietotājs ir izvēlējies.
Sintakse
MsgBox(prompt[, buttons][, title][, helpfile][, context])
Funkcijas MsgBox sintaksei ir šādi argumenti:
| Arguments | Apraksts |
|---|---|
prompt |
Obligāts arguments. Virknes izteiksme, kas tiek parādīta dialoglodziņā kā ziņojums. Maksimālais garums prompt ir aptuveni 1024 rakstzīmes atkarībā no izmantoto rakstzīmju platuma. Ja prompt ir vairākas rindas, tās var atdalīt, izmantojot rakstatgriezes rakstzīmi (Chr(13)), rindiņas padeves rakstzīmi (Chr(10)) vai rakstveža atgriešanās rakstzīmi (Chr(13) & Chr(10)). |
buttons |
Neobligāts arguments. Skaitliska izteiksme, kas ir to vērtību summa, kuras norāda parādāmo pogu skaitu un tipu, izmantojamo ikonas stilu, noklusējuma pogas identitāti un ziņojuma lodziņa modalitāti. Ja šī opcija tiek izlaista, noklusējuma vērtība ir buttons0. |
title |
Neobligāts arguments. Dialoglodziņa virsrakstjoslā parādīta virknes izteiksme. Ja to titleizlaižat, virsrakstjoslā tiek rādīts lietojumprogrammas nosaukums. |
helpfile |
Neobligāts arguments. Virknes izteiksme, kas identificē palīdzības failu, kas jāizmanto kontekstjutīgas palīdzības sniegšanai par dialoglodziņu. Ja helpfile tas ir nodrošināts, context ir jāsniedz arī. |
context |
Neobligāts arguments. Skaitliska izteiksme, kas ir palīdzības konteksta numurs, ko palīdzības autors piešķīris attiecīgajai palīdzības tēmai. Ja context tas ir nodrošināts, helpfile ir jāsniedz arī. |
Iestatījumi
Argumentu buttons iestatījumi ir:
| Konstante | Vērtība | Apraksts |
|---|---|---|
vbOKOnly |
0 |
Rādīt tikai labi . |
vbOKCancel |
1 |
Parādīt Labi un Atcelt. |
vbAbortRetryIgnore |
2 |
Parādīt, pārtraukt, mēģināt vēlreiz un ignorēt. |
vbYesNoCancel |
3 |
Parādīt Yes, No un Atcelt. |
vbYesNo |
4 |
Displejs Jā un Nē. |
vbRetryCancel |
5 |
Rādīt, mēģināt vēlreiz un atcelt. |
vbCritical |
16 |
Parādīt kritiskā ziņojuma ikonu. |
vbQuestion |
32 |
Parādiet brīdinājuma vaicājuma ikonu. |
vbExclamation |
48 |
Parādīt brīdinājuma ziņojuma ikonu. |
vbInformation |
64 |
Parādīt informācijas ziņojuma ikonu. |
vbDefaultButton1 |
0 |
Padariet pirmo pogu par noklusējumu. |
vbDefaultButton2 |
256 |
Padariet otro pogu par noklusējumu. |
vbDefaultButton3 |
512 |
Padariet trešo pogu par noklusējumu. |
vbDefaultButton4 |
768 |
Padariet ceturto pogu par noklusējumu. |
vbApplicationModal |
0 |
Lietojumprogrammas modāls. Lai turpinātu darbu pašreizējā lietojumprogrammā, lietotājam ir jāatbild uz ziņojuma lodziņu. |
vbSystemModal |
4096 |
Sistēmas modālais režīms. Visu lietojumprogrammu darbība tiek apturēta, līdz lietotājs reaģē uz ziņojuma lodziņu. |
vbMsgBoxHelpButton |
16384 |
Pievienojiet ziņojuma lodziņam palīdzības pogu. |
VbMsgBoxSetForeground |
65536 |
Norādiet ziņojuma lodziņa logu kā priekšplāna logu. |
vbMsgBoxRight |
524288 |
Līdziniet tekstu pa labi. |
vbMsgBoxRtlReading |
1048576 |
Teksta parādīšana ivrita un arābu sistēmās lasīšanai no labās puses uz kreiso. |
Pirmā vērtību grupa (0 līdz 5) apraksta dialoglodziņā parādīto pogu skaitu un tipu. Otrā grupa (16, 32, 48, 64) apraksta ikonas stilu. Trešā grupa (0, 256, 512) nosaka, kura poga ir noklusējuma. Ceturtā grupa (0, 4096) nosaka ziņojuma lodziņa modalitāti. Kad saskaitāt skaitļus, lai izveidotu argumenta buttons galīgo vērtību, izmantojiet tikai vienu skaitli no katras grupas.
Piezīme
Šīs konstantes norāda Visual Basic for Applications. Tādējādi nosaukumus varat izmantot jebkurā vietā kodā, nevis faktiskās vērtības.
Atgrieztās vērtības
| Konstante | Vērtība | Apraksts |
|---|---|---|
vbOK |
1 |
Labi |
vbCancel |
2 |
Atcelt |
vbAbort |
3 |
Pārtraukt |
vbRetry |
4 |
Mēģināt vēlreiz |
vbIgnore |
5 |
Ignorēt |
vbYes |
6 |
Jā |
vbNo |
7 |
Nē |
Piezīmes
Ja ir nodrošināti abi helpfile šie punkti context , lietotājs var nospiest taustiņu F1 operētājsistēmā Windows vai Palīdzība operētājsistēmā macOS, lai skatītu atbilstošo contextpalīdzības tēmu. Dažas resursdatora lietojumprogrammas, piemēram, Microsoft Excel, arī automātiski pievieno dialoglodziņam pogu Palīdzība .
Ja dialoglodziņā tiek parādīta poga Atcelt , nospiežot taustiņu Esc , ir tāds pats efekts kā atlasot Atcelt. Ja dialoglodziņā ir poga Palīdzība , šim dialoglodziņam ir nodrošināta kontekstjutīga palīdzība. Tomēr vērtība netiek atgriezta, kamēr lietotājs nav atlasījis kādu no pārējām pogām.
Piezīme
Lai norādītu vairāk nekā pirmo nosaukto argumentu, tas jāizmanto MsgBox izteiksmē. Lai izlaistu dažus pozicionālus argumentus, ir jāiekļauj attiecīgais komatu atdalītājs.
Piemērs
Piezīme
Tālāk esošajā piemērā parādīts, kā izmantot šo funkciju Visual Basic for Applications (VBA) modulī.
Šajā piemērā funkcija izmantota MsgBox , lai dialoglodziņā parādītu kritiskas kļūdas ziņojumu ar pogām Jā un Nē . Poga Nē ir norādīta kā noklusējuma atbilde. Funkcijas atgrieztā MsgBox vērtība ir atkarīga no pogas, ko atlasa lietotājs. Šajā piemērā tiek pieņemts, ka DEMO.HLP palīdzības fails satur tēmu, kuras palīdzības konteksta numurs ir vienāds ar 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