Interaction.MsgBox(Object, MsgBoxStyle, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отображает сообщение в диалоговом окне, ожидает, пока пользователь нажимает кнопку, а затем возвращает целое число, указывающее, какую кнопку щелкнул пользователь.
public static Microsoft.VisualBasic.MsgBoxResult MsgBox(object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, object? Title = default);
public static Microsoft.VisualBasic.MsgBoxResult MsgBox(object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, object Title = default);
static member MsgBox : obj * Microsoft.VisualBasic.MsgBoxStyle * obj -> Microsoft.VisualBasic.MsgBoxResult
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, Optional Title As Object = Nothing) As MsgBoxResult
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, Optional Title As Object = Nothing) As MsgBoxResult
Параметры
- Prompt
- Object
Обязательно.
String выражение, отображаемое как сообщение в диалоговом окне. Максимальная длина Prompt составляет приблизительно 1024 символов в зависимости от ширины используемых символов. Если Prompt состоит из нескольких строк, можно разделить строки с помощью возвращаемого символа каретки (13Chr(), символа канала строки ()Chr(10)) или сочетания символов возврата и линии каретки (Chr(13) и Chr(10)) между каждой строкой.
- Buttons
- MsgBoxStyle
Optional. Числовое выражение, которое представляет собой сумму значений, указывающее число и тип кнопок для отображения, стиль значка, идентификатор кнопки по умолчанию и модальность поля сообщения. Если не указано Buttons, значение по умолчанию равно нулю.
- Title
- Object
Optional.
String выражение, отображаемое в заголовке диалогового окна. Если не указано Title, имя приложения помещается в строку заголовка.
Возвращаемое значение
Одно из следующих значений:
| Константа | Ценность |
|---|---|
OK | 1 |
Cancel | 2 |
Abort | 3 |
Retry | 4 |
Ignore | 5 |
Yes | 6 |
No | 7 |
Исключения
Prompt не является выражением String или Title недопустимым.
Процесс не выполняется в интерактивном режиме пользователя.
Один или несколько параметров не член MsgBoxResult или MsgBoxStyle перечисление.
Примеры
В этом примере функция используется MsgBox для отображения критического сообщения об ошибке в диалоговом окне с кнопками "Да" и "Нет". Кнопка "Нет" активна по умолчанию. Это делается путем объединения константных значений MsgBox в одно числовое выражение. В этом случае добавление 4 (сочетание кнопки "Да/нет") и 16 (окно "Критическое сообщение ") и 256 (вторая кнопка в качестве кнопки по умолчанию) дает в общей сложности 276. Значение, возвращаемое MsgBox функцией, зависит от кнопки, выбранной пользователем: да возвращает значение 6; Значение 7 не возвращается.
' The following example requires that Option Infer be set to On.
' Define the message you want to see inside the message box.
Dim msg = "Do you want to continue?"
' Display a simple message box.
MsgBox(msg)
' Define a title for the message box.
Dim title = "MsgBox Demonstration"
' Add the title to the display.
MsgBox(msg, , title)
' Now define a style for the message box. In this example, the
' message box will have Yes and No buttons, the default will be
' the No button, and a Critical Message icon will be present.
Dim style = MsgBoxStyle.YesNo Or MsgBoxStyle.DefaultButton2 Or
MsgBoxStyle.Critical
' Display the message box and save the response, Yes or No.
Dim response = MsgBox(msg, style, title)
' Take some action based on the response.
If response = MsgBoxResult.Yes Then
MsgBox("YES, continue!!", , title)
Else
MsgBox("NO, stop!!", , title)
End If
Комментарии
Если вы опустите какие-либо позиционные аргументы, необходимо сохранить соответствующий разделитель запятых.
Если в диалоговом окне отображается кнопка "Отмена ", нажатие клавиши ESC имеет тот же эффект, что и нажатие кнопки "Отмена"
Если диалоговое окно содержит кнопку "Справка ", для диалогового окна предоставляется контекстная справка. Однако значение не возвращается, пока не будет выбрана одна из других кнопок. В приложениях формы Windows при выборе кнопки Help выполняется событие HelpRequested для формы.
Note
Функция MsgBox требуется UIPermission на SafeTopLevelWindows уровне, что может повлиять на его выполнение в ситуациях с частичным доверием. Дополнительные сведения см. в разделе UIPermission.
Значения MsgBoxStyle перечисления перечислены в следующей таблице.
| Член | Ценность | Description |
|---|---|---|
| Член | Ценность | Description |
OKOnly |
0 | Отображает только кнопку "ОК". |
OKCancel |
1 | Отображает кнопки "ОК" и "Отмена". |
AbortRetryIgnore |
2 | Отображает кнопки "Прерывание", "Повторные попытки" и "Игнорировать". |
YesNoCancel |
3 | Отображает кнопки "Да", "Нет" и "Отмена". |
YesNo |
4 | Отображает кнопки "Да" и "Нет". |
RetryCancel |
5 | Отображает кнопки повтора и отмены. |
Critical |
16 | Отображает значок критического сообщения. |
Question |
32 | Отображает значок запроса предупреждения. |
Exclamation |
48 | Отображает значок предупреждения о сообщении. |
Information |
64 | Отображает значок "Информационное сообщение". |
DefaultButton1 |
0 | По умолчанию активна первая кнопка. |
DefaultButton2 |
256 | По умолчанию активна вторая кнопка. |
DefaultButton3 |
512 | По умолчанию активна третья кнопка. |
ApplicationModal |
0 | Приложение является модальным. Пользователь должен ответить на поле сообщения, прежде чем продолжить работу в текущем приложении. |
SystemModal |
4096 | Система модальна. Все приложения приостановлены до тех пор, пока пользователь не ответит на сообщение. |
MsgBoxSetForeground |
65536 | Расположение окна сообщения на переднем плане. |
MsgBoxRight |
524288 | Текст выравнивается по правому краю. |
MsgBoxRtlReading |
1048576 | Система чтения справа налево для иврита и арабского языка. |
Первая группа значений (0–5) описывает количество и тип кнопок, отображаемых в диалоговом окне. Вторая группа (16, 32, 48, 64) описывает стиль значка. Третья группа (0, 256, 512) определяет, какая кнопка является значением по умолчанию. Четвертая группа (0, 4096) определяет модальность поля сообщения, а пятая группа определяет, является ли окно поля сообщения окном переднего плана, а также выравниванием и направлением текста. При добавлении чисел для создания окончательного значения аргумента Buttons используйте только одно число из каждой группы.