В классической базе данных MsgBox Access функция отображает сообщение в диалоговом окне, ожидает, пока пользователь выберет кнопку, и возвращает 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 аргумента:
| Константа | Значение | Описание |
|---|---|---|
vbOKOnly |
0 |
Отображать только ОК . |
vbOKCancel |
1 |
Отображение ОК и Отмена. |
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, , 512) определяет, 256какая кнопка используется по умолчанию. Четвертая группа (0, 4096) определяет модальность окна сообщения. При добавлении чисел для создания окончательного значения аргумента buttons используйте только одно число из каждой группы.
Примечание
Эти константы задаются Visual Basic для приложений. В результате имена можно использовать в любом месте кода вместо фактических значений.
Возвращаемые значения
| Константа | Значение | Описание |
|---|---|---|
vbOK |
1 |
ОК |
vbCancel |
2 |
Отмена |
vbAbort |
3 |
Прервать |
vbRetry |
4 |
Повторить |
vbIgnore |
5 |
Игнорировать |
vbYes |
6 |
Да |
vbNo |
7 |
Нет |
Замечания
Если указаны и helpfilecontext , пользователь может нажать клавишу F1 в Windows или Справка в macOS, чтобы просмотреть раздел справки, соответствующий context. Некоторые хост-приложения, такие как Microsoft Excel, также автоматически добавляют в диалоговое окно кнопку Справка .
Если в диалоговом окне отображается кнопка Отмена , нажатие клавиши ESC имеет тот же эффект, что и при нажатии кнопки Отмена. Если диалоговое окно содержит кнопку "Справка ", для диалогового окна предоставляется контекстная справка. Однако значение не возвращается, пока пользователь не выберет одну из других кнопок.
Примечание
Чтобы указать больше первого именованного аргумента, необходимо использовать MsgBox в выражении. Чтобы опустить некоторые позиционные аргументы, необходимо включить соответствующий разделитель запятых.
Пример
Примечание
В следующем примере показано, как использовать эту функцию в модуле Visual Basic для приложений (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