В базе данных Access для настольных компьютеров функция MsgBox отображает сообщение в диалоговом окне, ждет нажатия кнопки пользователем и возвращает integer, указывающее, какую кнопку нажал пользователь.
Синтаксис
MsgBox ( сообщение [, кнопки ] [, заголовок ] [, файл_справки ] [, контекст ])
Функция MsgBox имеет следующие аргументы:
|
Аргумент |
Описание |
|
сообщение |
Обязательный аргумент. Строковое выражение, отображаемое как сообщение в диалоговом окне. Максимальная длина строки аргумента сообщение составляет приблизительно 1024 знаков и зависит от их ширины. Если аргумент сообщение содержит несколько строк, их можно разделить с помощью знака возврата каретки (Chr(13)), знака перевода строки (Chr(10)) или сочетания этих знаков (Chr(13) & Chr(10)) |
|
кнопки |
Необязательный. числовое выражение, которая является суммой значений, которая указывает число и тип отображаемой кнопки, стиль значка, идентификатор кнопки по умолчанию и модальность окна сообщения. Если этот вопрос опущен, значение по умолчанию для кнопок — 0. |
|
заголовок |
Необязательный аргумент. Строковое выражение, отображаемое в заголовке диалогового окна. Если аргумент заголовок опущен, в заголовке выводится имя приложения. |
|
файл_справки |
Необязательный аргумент. Строковое выражение, определяющее файл, в котором содержится контекстная справка для данного диалогового окна. Если задан аргумент файл_справки, необходимо также указать аргумент контекст. |
|
контекст |
Необязательный аргумент. Числовое выражение, представляющее собой номер контекста, присвоенный автором справки соответствующему разделу. Если задан аргумент контекст, необходимо также указать аргумент файл_справки. |
Параметры
Аргумент кнопкиаргумент имеет следующие параметры:
|
Константа |
Значение |
Описание |
|
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 |
Текст сообщения выводится справа налево. Эта возможность предназначена для систем, в которых используется арабский язык или иврит. |
Совет: В Access 2010 построитель выражений включает функцию IntelliSense, которая указывает требуемые аргументы.
Первая группа значений (0–5) описывает количество и тип кнопок, отображаемого в диалоговом окне; Вторая группа (16, 32, 48, 64) описывает стиль значков. Третья группа (0, 256, 512) определяет, какая кнопка является кнопкой по умолчанию; и четвертая группа (0, 4096) определяет модальность окна сообщения. При добавлении чисел для создания конечного значения для аргумента кнопок используйте только одно число из каждой группы.
Примечание: Эти константы заданы Visual Basic для приложений. Таким образом, их можно использовать в любом месте кода, а не фактические значения.
Возвращаемые значения
|
Константа |
Значение |
Описание |
|
vbOK |
1 |
ОК |
|
vbCancel |
2 |
Отмена |
|
vbAbort |
3 |
Прервать |
|
vbRetry |
4 |
Повторить |
|
vbIgnore |
5 |
Пропустить |
|
vbYes |
6 |
Да |
|
vbNo |
7 |
Нет |
Примечания
Если указаны аргументы файл_справки и контекст, пользователь может, нажав клавишу F1 (Windows) или HELP (Макинтош), открыть раздел справки, заданный аргументом контекст. Некоторые принимающие приложения, например 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
