В базе данных Access для настольных компьютеров MsgBox эта функция выводит сообщение в диалоговом окне, ожидает нажатия кнопки пользователем и возвращает кнопку Integer , указывающую, какую кнопку нажал пользователь.
Синтаксис
MsgBox(prompt[, buttons][, title][, helpfile][, context])
Аргументы функции MsgBox описаны ниже.
| Аргумент | Описание |
|---|---|
prompt |
Обязательный аргумент. Строковое выражение, отображаемое как сообщение в диалоговом окне. Максимальная длина prompt составляет около 1024 символов, в зависимости от ширины используемых символов. Если prompt строка состоит из нескольких строк, их можно разделить с помощью символа возврата каретки (Chr(13)), символа перевода строки (Chr(10)) или комбинации возврата каретки (Chr(13) & Chr(10)) между строками. |
buttons |
— необязательный аргумент. Числовое выражение, представляющее собой сумму значений, определяющих количество и тип отображаемых кнопок, используемый стиль значков, идентификатор стандартной кнопки и модальность окна сообщения. Если аргумент опущен, значением по умолчанию является buttons0. |
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, 256) 512определяет, какая кнопка является кнопкой по умолчанию. Четвертая группа (0, 4096) определяет модальность окна сообщения. При сложении чисел для получения окончательного значения аргумента buttons используйте только одно число из каждой группы.
Примечание
Эти константы задаются в Visual Basic для приложений. В результате вместо фактических значений в коде можно использовать имена в любом месте.
Возвращаемые значения
| Константа | Значение | Описание |
|---|---|---|
vbOK |
1 |
ОК |
vbCancel |
2 |
Отмена |
vbAbort |
3 |
Прервать |
vbRetry |
4 |
Повторить |
vbIgnore |
5 |
Игнорировать |
vbYes |
6 |
Да |
vbNo |
7 |
Нет |
Замечания
Если предоставлены оба вариантаcontext, пользователь может нажать клавишуhelpfile 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