Interaction.MsgBox(Object, MsgBoxStyle, Object) Метод

Определение

Отображает сообщение в диалоговом окне, ожидает нажатия кнопки и возвращает целое число, показывающее, какая кнопка была нажата.Displays a message in a dialog box, waits for the user to click a button, and then returns an integer indicating which button the user clicked.

public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, object Title = null);
static member MsgBox : obj * Microsoft.VisualBasic.MsgBoxStyle * obj -> Microsoft.VisualBasic.MsgBoxResult
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, Optional Title As Object = null) As MsgBoxResult

Параметры

Prompt
Object

Обязательный.Required. Выражение типа String, отображаемое в диалоговом окне в виде сообщения.String expression displayed as the message in the dialog box. Максимальная длина параметра Prompt составляет примерно 1024 знака и зависит от ширины используемых знаков.The maximum length of Prompt is approximately 1024 characters, depending on the width of the characters used. Если Prompt состоит из нескольких строк, то строки можно разделить с помощью знака возврата каретки (Chr(13)), знака перевода строки (Chr(10)) или сочетания возврата каретки и перевода строки (Chr(13) & Chr(10)) после каждой строки.If Prompt consists of more than one line, you can separate the lines using a carriage return character (Chr(13)), a line feed character (Chr(10)), or a carriage return/linefeed character combination (Chr(13) & Chr(10)) between each line.

Buttons
MsgBoxStyle

Необязательный параметр.Optional. Числовое выражение, являющееся суммой значений, задающих номер и тип отображаемых кнопок, стиль используемого значка, тип кнопки по умолчанию и признак модальности окна сообщения.Numeric expression that is the sum of values specifying the number and type of buttons to display, the icon style to use, the identity of the default button, and the modality of the message box. Если параметр Buttons опущен, по умолчанию используется нулевое значение.If you omit Buttons, the default value is zero.

Title
Object

Необязательный параметр.Optional. Выражение типа String, отображаемое в строке заголовка диалогового окна.String expression displayed in the title bar of the dialog box. Если параметр Title опущен, в строку заголовка помещается имя приложения.If you omit Title, the application name is placed in the title bar.

Возвраты

КонстантаConstant ЗначениеValue
OK 11
Cancel 22
Abort 33
Retry 44
Ignore 55
Yes 66
No 77
..

Исключения

Либо Prompt — это не выражение типа String, либо параметр Title имеет недопустимое значение.Prompt is not a String expression, or Title is invalid.

Процесс не выполняется в режиме интерактивного взаимодействия с пользователем.Process is not running in User Interactive mode.

Один или несколько параметров не являются членами перечислений MsgBoxResult или MsgBoxStyle.One or more parameters not a member of MsgBoxResult or MsgBoxStyle enumeration.

Примеры

В этом примере функция MsgBox используется для вывода сообщения о критической ошибке в диалоговом окне с кнопками Да и нет.This example uses the MsgBox function to display a critical-error message in a dialog box with Yes and No buttons. В качестве ответа по умолчанию указана кнопка нет.The No button is specified as the default response. Это делается путем объединения постоянных значений MsgBox в одно числовое выражение.This is done by combining the MsgBox constant values into one numeric expression. В этом случае добавление 4 (сочетание кнопки Да/нет) и 16 (окно Критическое сообщение ) и 256 (кнопка по умолчанию) дает сумму 276.In this case, adding 4 (the Yes/No button combination) and 16 (the Critical Message window) and 256 (the second button as default button) gives a total of 276. Значение, возвращаемое функцией MsgBox, зависит от выбранной пользователем кнопки. Да возвращает значение 6; No возвращает значение 7.The value returned by the MsgBox function depends on the button chosen by the user: Yes returns a value of 6; No returns a value of 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

Комментарии

Если вы не пропускаете какие либо аргументы, то должны быть сохранены соответствующие разделители.If you omit any positional arguments, you must retain the corresponding comma delimiter.

Если в диалоговом окне отображается кнопка Отмена , нажатие клавиши Esc приведет к тому же результату, что и при нажатии кнопки Отмена .If the dialog box displays a Cancel button, pressing the ESC key has the same effect as clicking Cancel

Если диалоговое окно содержит кнопку Справка , для диалогового окна предоставляется контекстная справка.If the dialog box contains a Help button, context-sensitive Help is provided for the dialog box. Однако значение не возвращается до тех пор, пока не будет выбрана одна из других кнопок.However, no value is returned until one of the other buttons is chosen. В приложениях Windows Forms при нажатии кнопки " Справка " выполняется событие HelpRequested для формы.In Windows Form applications, choosing the Help button executes the HelpRequested event for the form.

Примечание

Функция MsgBox требует UIPermission на уровне SafeTopLevelWindows, что может повлиять на выполнение в ситуациях частичного доверия.The MsgBox function requires UIPermission at the SafeTopLevelWindows level, which may affect its execution in partial-trust situations. Для получения дополнительной информации см. UIPermission.For more information, see UIPermission.

Значения перечисления MsgBoxStyle перечислены в следующей таблице.The MsgBoxStyle enumeration values are listed in the following table.

ЧленMember ЗначениеValue ОписаниеDescription
ЧленMember ЗначениеValue ОписаниеDescription
OKOnly 00 Отображает только кнопку ОК.Displays OK button only.
OKCancel 11 Отображает кнопки ОК и Отмена.Displays OK and Cancel buttons.
AbortRetryIgnore 22 Отображает кнопки прервать, повторить и пропустить.Displays Abort, Retry, and Ignore buttons.
YesNoCancel 33 Отображает кнопки Да, нет и Отмена.Displays Yes, No, and Cancel buttons.
YesNo 44 Отображает кнопки Да и нет.Displays Yes and No buttons.
RetryCancel 55 Отображает кнопки повторить и Отмена.Displays Retry and Cancel buttons.
Critical 1616 Отображается значок критического сообщения.Displays Critical Message icon.
Question 3232 Отображается значок запроса предупреждения.Displays Warning Query icon.
Exclamation 4848 Отображается значок сообщения с предупреждением.Displays Warning Message icon.
Information 6464 Отображает значок информационного сообщения.Displays Information Message icon.
DefaultButton1 00 По умолчанию используется первая кнопка.First button is default.
DefaultButton2 256256 По умолчанию используется вторая кнопка.Second button is default.
DefaultButton3 512512 По умолчанию используется третья кнопка.Third button is default.
ApplicationModal 00 Приложение является модальным.Application is modal. Перед продолжением работы в текущем приложении пользователь должен ответить на окно сообщения.The user must respond to the message box before continuing work in the current application.
SystemModal 40964096 Система является модальной.System is modal. Все приложения приостанавливаются до тех пор, пока пользователь не ответит на окно сообщения.All applications are suspended until the user responds to the message box.
MsgBoxSetForeground 6553665536 Задает окно сообщения в качестве окна переднего плана.Specifies the message box window as the foreground window.
MsgBoxRight 524288524288 Текст выровняйтеся по правому краю.Text is right-aligned.
MsgBoxRtlReading 10485761048576 Указывает, что текст должен отображаться как чтение справа налево в системах на иврите и арабском языке.Specifies text should appear as right-to-left reading on Hebrew and Arabic systems.

Первая группа значений (0-5) описывает число и тип кнопок, отображаемых в диалоговом окне.The first group of values (0-5) describes the number and type of buttons displayed in the dialog box. Вторая группа (16, 32, 48, 64) описывает стиль значка.The second group (16, 32, 48, 64) describes the icon style. Третья группа (0, 256, 512) определяет, какая кнопка является кнопкой по умолчанию.The third group (0, 256, 512) determines which button is the default. Четвертая группа (0, 4096) определяет модальность окна сообщения, а пятая группа указывает, является ли окно сообщения окном переднего плана вместе с выравниванием и направлением текста.The fourth group (0, 4096) determines the modality of the message box, and the fifth group specifies whether or not the message box window is the foreground window, along with the alignment and direction of the text. При добавлении чисел для создания конечного значения для аргумента Buttons используйте только одно число из каждой группы.When adding numbers to create a final value for the Buttons argument, use only one number from each group.

Применяется к

Дополнительно