В настолна база данни на Access MsgBox функцията показва съобщение в диалогов прозорец, изчаква потребителя да избере бутон и връща съобщение Integer , което указва кой бутон е избрал потребителят.
Синтаксис
MsgBox(prompt[, buttons][, title][, helpfile][, context])
Синтаксисът MsgBox на функцията има следните аргументи:
| Аргумент | Описание |
|---|---|
prompt |
Задължително. Израз във формата на низ, показан като съобщение в диалоговия прозорец. Максималната дължина prompt е около 1024 знака в зависимост от ширината на използваните знаци. Ако prompt е повече от един ред, можете да разделите редовете с помощта на знак за нов ред (Chr(13)), знак за нов ред (), знак за нов ред (Chr(10)) или комбинация за нов ред-нов ред (Chr(13) & Chr(10)) между всеки ред. |
buttons |
Незадължително. Числов израз, който е сумата от стойности, указващи броя и типа на бутоните за показване, стила на иконата, който да се използва, идентичността на бутона по подразбиране и модалността на полето за съобщение. Ако липсва, стойността по подразбиране за buttons е 0. |
title |
Незадължително. Израз във формата на низ, показан в заглавната лента на диалоговия прозорец. Ако пропуснете title, името на приложението се показва в заглавната лента. |
helpfile |
Незадължително. Низов израз, който идентифицира помощния файл, който ще се използва за предоставяне на чувствителна към контекста помощ за диалоговия прозорец. Ако helpfile е предоставено, context трябва да се предостави. |
context |
Незадължително. Числов израз, който е номерът на контекста на помощта, присвоен на съответната помощна тема от автора на помощта. Ако context е предоставено, helpfile трябва да се предостави. |
Настройки
Настройките buttons за аргументите са:
| Константа | Value | Описание |
|---|---|---|
vbOKOnly |
0 |
Само показване OK . |
vbOKCancel |
1 |
Показване на OK и "Отказ". |
vbAbortRetryIgnore |
2 |
Показване на "Прекратяване", "Повторен опит" и "Игнорирай". |
vbYesNoCancel |
3 |
Показване на "Да", "Не" и "Отказ". |
vbYesNo |
4 |
Показване на "Да " и "Не". |
vbRetryCancel |
5 |
Показване на "Повтори" и "Отказ". |
vbCritical |
16 |
Показване на иконата за критично съобщение . |
vbQuestion |
32 |
Показване на иконата на заявка с предупреждение . |
vbExclamation |
48 |
Показване на иконата за предупредително съобщение . |
vbInformation |
64 |
Показване на иконата за информационно съобщение . |
vbDefaultButton1 |
0 |
Направете първия бутон по подразбиране. |
vbDefaultButton2 |
256 |
Направете втория бутон по подразбиране. |
vbDefaultButton3 |
512 |
Направете третия бутон по подразбиране. |
vbDefaultButton4 |
768 |
Направете четвъртия бутон по подразбиране. |
vbApplicationModal |
0 |
Модален режим на приложение. Потребителят трябва да отговори на полето за съобщение, преди да продължи работата си в текущото приложение. |
vbSystemModal |
4096 |
Модален систем. Всички приложения се преустановяват, докато потребителят не отговори на прозореца за съобщение. |
vbMsgBoxHelpButton |
16384 |
Добавяне на бутон за помощ към полето за съобщения. |
VbMsgBoxSetForeground |
65536 |
Задайте прозореца в полето за съобщения като прозорец на преден план. |
vbMsgBoxRight |
524288 |
Дясно подравняване на текста. |
vbMsgBoxRtlReading |
1048576 |
Показване на текста с четене от дясно наляво в иврит и арабска система. |
Първата група стойности (0 до 5) описва броя и типа на бутоните, показани в диалоговия прозорец. Втората група (16, 32, 48) 64описва стила на иконата. Третата група (0, 256) 512определя кой бутон е по подразбиране. Четвъртата група (0, 4096) определя модалността на полето за съобщение. Когато събирате числа, за да създадете крайна стойност за аргумента buttons , използвайте само едно число от всяка група.
Забележка
Тези константи са определени от Visual Basic for Applications. В резултат на това можете да използвате имената навсякъде в кода вместо действителните стойности.
Върнати стойности
| Константа | Value | Описание |
|---|---|---|
vbOK |
1 |
OK |
vbCancel |
2 |
Отказ |
vbAbort |
3 |
Прекратяване |
vbRetry |
4 |
Повторен опит |
vbIgnore |
5 |
Игнорирай |
vbYes |
6 |
Да |
vbNo |
7 |
Не |
Забележки
Когато са предоставени и context дветеhelpfile, потребителят може да натисне клавиша F1 в Windows или помощта в macOS, за да види помощната тема, която съответства contextна . Някои хост приложения, като например Microsoft Excel, също автоматично добавят бутон за помощ към диалоговия прозорец.
Ако в диалоговия прозорец се покаже бутон "Отказ ", натискането на клавиша Esc има същия ефект като избирането на "Отказ". Ако диалоговият прозорец съдържа бутон " Помощ ", за диалоговия прозорец се предоставя чувствителна към контекста помощ. Въпреки това не се връща стойност, докато потребителят не избере един от другите бутони.
Забележка
За да зададете повече от първия наименуван аргумент, трябва да използвате MsgBox в израз. За да пропуснете някои позиционни аргументи, трябва да включите съответния разделител точка и запетая.
Пример
Забележка
Примерът по-долу показва как да използвате тази функция във Visual Basic for Applications (VBA).
Този пример използва MsgBox функцията за показване на съобщение за критична грешка в диалогов прозорец с бутони "Да " и "Не ". Бутонът "Не " е зададен като отговор по подразбиране. Стойността, върната от функцията MsgBox , зависи от бутона, който потребителят е избрал. В този пример се предполага, че DEMO.HLP това е помощен файл, съдържащ тема с номер на контекст за помощта, равен на 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