Datora Access bāzē funkcija MsgBox dialoglodziņā parāda ziņojumu, uzgaida, līdz lietotājs noklikšķina uz pogas, un atgriež veselu skaitli, kas norāda, uz kuras pogas lietotājs ir noklikšķinājis.
Sintakse
MsgBox ( uzvedne [, pogas ] [, virsraksts ] [, helpfile ] [, konteksts ] )
Funkcijas MsgBox sintaksē ir šādi argumenti:
|
Arguments |
Apraksts |
|---|---|
|
uzvedne |
Obligāts arguments. Virknes izteiksme, kas parādīta kā ziņojums dialoglodziņā. Uzvednes maksimālais garums ir aptuveni 1024 rakstzīmes atkarībā no izmantoto rakstzīmju platuma. Ja uzvednē ir vairāk nekā viena rindiņa, rindiņas var atdalīt, izmantojot rakstatgriezes rakstzīmi (Chr(13)), rindiņu plūsmas rakstzīmi (Chr(10)) vai rakstatgriezes rakstzīmju kombināciju (Chr(13) & Chr(10)) starp rindiņām. |
|
buttons |
Neobligāts arguments. skaitliska izteiksme ir vērtību summa, kas norāda parādāmo pogu skaitu un tipu, izmantojamais ikonu stils, noklusējuma pogas identitāte un ziņojuma lodziņa modalitāte. Ja tā tiek izlaista, pogu noklusējuma vērtība ir 0. |
|
virsraksts |
Neobligāts arguments. Virknes izteiksme, kas parādīta dialoglodziņa virsrakstjoslā. Ja virsraksts tiek izlaists, lietojumprogrammas nosaukums tiek ievietots virsrakstjoslā. |
|
helpfile |
Neobligāts arguments. Virknes izteiksme, kas identificē palīdzības failu, ko izmantot, lai dialoglodziņā sniegtu kontekstjutīgu palīdzību. Ja ir nodrošinātspalīdzībasfails , ir jānorāda arī konteksts. |
|
konteksts |
Neobligāts arguments. Skaitliska izteiksme, kas ir palīdzības konteksta numurs, kuru palīdzības autors ir piešķīris atbilstošai palīdzības tēmai. Ja ir sniegts konteksts, ir jānorāda arī palīdzībasfails. |
Iestatījumi
Iestatījumuarguments ir:
|
Konstante |
Vērtība |
Apraksts |
|---|---|---|
|
vbOKOnly |
0 |
Rādīt tikai pogu Labi. |
|
vbOKCancel |
1 |
Pogas Labi un Atcelt tiek rādītas . |
|
vbAbortRetryIgnore |
2 |
Rādīt pogas Pārtrauktpriekšlaikus, Atkārtot un Ignorēt . |
|
vbYesNoCancel |
3 |
Rādīt pogas Jā, Nēun Atcelt. |
|
vbYesNo |
4 |
Pogas Jā unNē parādīšana . |
|
vbRetryCancel |
5 |
Pogas Atkārtot mēģināšanuun Atcelt. |
|
vbCritical |
16 |
Kritiska ziņojuma parādīšanas ikona. |
|
vbQuestion |
32 |
Display Warning Query icon. |
|
vbExclamation |
48 |
Display Warning Message icon. |
|
vbInformation |
64 |
Display Information Message icon. |
|
vbDefaultButton1 |
0 |
Pirmā poga ir noklusējuma poga. |
|
vbDefaultButton2 |
256 |
Otrā poga ir noklusējuma poga. |
|
vbDefaultButton3 |
512 |
Trešā poga ir noklusējuma poga. |
|
vbDefaultButton4 |
768 |
Ceturtā poga ir noklusējuma poga. |
|
vbApplicationModal |
0 |
Lietojumprogrammas modālais; lietotājam ir jāatbild uz ziņojuma lodziņu, pirms turpināt darbu pašreizējā lietojumprogrammā. |
|
vbSystemModal |
4096 |
Sistēmas modāls; Visas lietojumprogrammas tiek aizturētas, līdz lietotājs reaģē uz ziņojuma lodziņu. |
|
vbMsgBoxHelpButton |
16384 |
Adds Help button to the message box |
|
VbMsgBoxSetForeground |
65536 |
Norāda ziņojuma lodziņa logu kā priekšplāna logu |
|
vbMsgBoxRight |
524288 |
Teksts ir līdzināts pa labi |
|
vbMsgBoxRtlReading |
1048576 |
Norāda tekstu, kas ivritā un arābu sistēmā jālasa kā no labās puses uz kreiso |
Pirmā vērtību grupa (0–5) apraksta dialoglodziņā redzamo pogu skaitu un tipu; otrā grupa (16, 32, 48, 64) apraksta ikonas stilu; trešā grupa (0, 256, 512) nosaka, kura poga ir noklusējuma poga. un ceturtā grupa (0, 4096) nosaka ziņojuma lodziņa modalitāti. Pievienojot skaitļus, lai izveidotu beigu vērtību pogu argumentam , izmantojiet tikai vienu skaitli no katras grupas.
Piezīme.: Šīs konstantes norāda Visual Basic for Applications. Rezultātā šos nosaukumus var izmantot jebkur kodu atrašanās vietā faktisko vērtību vietā.
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āts gan palīdzībasfails, gan konteksts, lietotājs var nospiest taustiņu F1 (Windows) vai HELP (macOS), lai skatītu kontekstam atbilstošo palīdzības tēmu. Dažas resursdatoru lietojumprogrammas, piemēram, Microsoft Excel, automātiski pievienot dialoglodziņam palīdzības pogu.
Ja dialoglodziņā redzama poga Atcelt , nospiežot taustiņu ESC, ir tāds pats efekts kā noklikšķinot uz Atcelt. Ja dialoglodziņā ir poga Palīdzība, dialoglodziņā ir pieejama kontekstjutīga palīdzība. Tomēr netiek atgriezta vērtība, kamēr netiek noklikšķināts uz vienas no citām pogām.
Piezīme.: Lai norādītu vairāk nekā pirmo argumentu ar nosaukumu, jāizmanto MsgBoxizteiksme. Lai izlaistu dažus pozicionālos argumentus, ir jāiekļauj atbilstošs komatatdalītājs.
Piemērs
Piezīme.: Turpmākajos piemēros redzama šīs funkcijas izmantošana Visual Basic for Applications (VBA) modulī.
Šajā piemērā izmantota funkcija MsgBox , lai dialoglodziņā ar pogām Jā un Nē parādītu kritiskas kļūdas ziņojumu. Poga Nē tiek norādīta kā noklusējuma atbilde. Funkcijas MsgBox atgrieztā vērtība ir atkarīga no lietotāja izvēlētās pogas. Šajā piemērā tiek pieņemts DEMO.HLP ka šis ir palīdzības fails, kurā ir tēma ar palīdzības konteksta numuru, kas 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
