Поделиться через


MessageBox.Show Метод

Определение

Отображает окно сообщения.

Перегрузки

Show(String)

Отображает окно сообщения с заданным текстом.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки и Ключевое слово справки.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки, HelpNavigator и раздел справки.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки и HelpNavigator.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки и Ключевое слово справки.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст, заголовок, кнопки, значок, кнопку по умолчанию и параметры.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора и кнопкой "Справка".

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки и HelpNavigator.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст, заголовок, кнопки, значок и кнопку по умолчанию.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст, заголовок, кнопки и значок.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком и кнопкой по умолчанию.

Show(IWin32Window, String, String, MessageBoxButtons)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст, заголовок и кнопки.

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Отображает окно сообщения с заданным текстом, заголовком, кнопками и значком.

Show(IWin32Window, String, String)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст и заголовок.

Show(String, String, MessageBoxButtons)

Отображает окно сообщения с заданным текстом, заголовком и кнопками.

Show(IWin32Window, String)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст.

Show(String, String)

Отображает окно сообщения с заданным текстом и заголовком.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию и параметрами для выбора.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки, HelpNavigator и раздел справки.

Show(String)

Отображает окно сообщения с заданным текстом.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text);
public static System.Windows.Forms.DialogResult Show (string text);
public static System.Windows.Forms.DialogResult Show (string? text);
static member Show : string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String) As DialogResult

Параметры

text
String

Текст, отображаемый в окне сообщения.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Примеры

В следующем примере кода отображается простое окно сообщения.

private void DisplayMessageBoxText()
{
         MessageBox.Show("Hello, world.");
}
Private Sub DisplayMessageBoxText()

    MessageBox.Show("Hello, world.")
End Sub

Комментарии

По умолчанию в окне сообщения отображается кнопка ОК . Окно сообщения не содержит подпись в заголовке.

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

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки и Ключевое слово справки.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Параметры

owner
IWin32Window

Реализация IWin32Window, которой будет принадлежать данное модальное диалоговое окно.

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

options
MessageBoxOptions

Одно из значений MessageBoxOptions, указывающее, какие параметры отображения и связи будут использованы для этого окна сообщения. Чтобы использовать значения по умолчанию, следует передать значение 0.

helpFilePath
String

Полный путь к файлу справки, который должен отображаться, когда пользователь щелкнет кнопку "Справка".

keyword
String

Ключевое слово справки, отображаемое по щелчку кнопки "Справка".

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

Заданный объект defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Параметром options задается и DefaultDesktopOnly, и ServiceNotification.

-или-

Параметр buttons задает недопустимое сочетание MessageBoxButtons.

Примеры

В следующем примере кода показано, как отобразить окно сообщения, родительское для окна main. В окне сообщения отображается кнопка Справка. Когда пользователь нажимает кнопку Справка, Mspaint.chm открывается файл справки и отображается раздел, определенный mspaint.chm::/paint_brush.htm ключевое слово. Для этого примера требуется, чтобы файл справки Mspaint.chm был установлен.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r8 = MessageBox::Show( this, "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r8 = MessageBox.Show (this, "Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r8 As DialogResult = MessageBox.Show(Me, "Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Комментарии

Окно сообщения — это модальное диалоговое окно, которое означает, что ввод (нажатие клавиатуры или мыши) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя). С помощью owner параметра можно указать конкретный объект, реализующий IWin32Window интерфейс , который будет служить владельцем верхнего уровня диалогового окна.

Когда пользователь нажимает кнопку Справка, открывается файл справки, указанный helpFilePath в параметре , и отображается раздел справки ключевое слово, определенный keyword параметром . Форма, владеющая окном сообщения (или активной формой), также получает HelpRequested событие.

См. также раздел

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

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки, HelpNavigator и раздел справки.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Параметры

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

options
MessageBoxOptions

Одно из значений MessageBoxOptions, указывающее, какие параметры отображения и связи будут использованы для этого окна сообщения. Чтобы использовать значения по умолчанию, следует передать значение 0.

helpFilePath
String

Полный путь к файлу справки, который должен отображаться, когда пользователь щелкнет кнопку "Справка".

navigator
HelpNavigator

Одно из значений перечисления HelpNavigator.

param
Object

Числовой идентификатор раздела справки, отображаемый по щелчку кнопки "Справка".

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

Заданный объект defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Параметром options задается и DefaultDesktopOnly, и ServiceNotification.

-или-

Параметр buttons задает недопустимое сочетание MessageBoxButtons.

Примеры

В следующем примере кода показано, как отобразить окно сообщения с кнопкой "Справка". Когда пользователь нажимает кнопку Справка, Mspaint.chm открывается файл справки и отображается вкладка "Индекс справки" и тема, определяемая ovals ключевое слово. Для этого примера требуется, чтобы файл справки Mspaint.chm был установлен.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r5 = MessageBox::Show( "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r5 = MessageBox.Show ("Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");
' Display a message box. The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r5 As DialogResult = MessageBox.Show("Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Комментарии

Окно сообщения — это модальное диалоговое окно. Это означает, что ввод (нажатие клавиатурой или мышью) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя).

Когда пользователь нажимает кнопку Справка, открывается файл справки, указанный helpFilePath в параметре navigator , и отображается содержимое справки, определяемое параметром . Форма, владеющая окном сообщения (или активной формой), также получает HelpRequested событие.

Скомпилированные файлы справки содержат оглавление, индекс, поиск и ключевое слово ссылки на страницах. Для можно использовать следующие значения navigator: TableOfContents, Find, Indexили Topic.

Вы можете использовать для param дальнейшего Topic уточнения команды. Если в параметре navigatorTableOfContentsуказано значение , Indexили Find, это значение должно иметь значение null. navigator Если параметр ссылается на Topic, это значение должно ссылаться на объект, содержащий числовое значение отображаемого раздела.

Параметр helpFilePath может иметь форму C:\path\sample.chm или /folder/file.htm.

См. также раздел

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

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Параметры

owner
IWin32Window

Реализация IWin32Window, которой будет принадлежать данное модальное диалоговое окно.

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

options
MessageBoxOptions

Одно из значений MessageBoxOptions, указывающее, какие параметры отображения и связи будут использованы для этого окна сообщения. Чтобы использовать значения по умолчанию, следует передать значение 0.

helpFilePath
String

Полный путь к файлу справки, который должен отображаться, когда пользователь щелкнет кнопку "Справка".

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

Заданный объект defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Параметром options задается и DefaultDesktopOnly, и ServiceNotification.

-или-

Параметр buttons задает недопустимое сочетание MessageBoxButtons.

Примеры

В следующем примере кода показано, как отобразить окно сообщения, которое является родительским элементом формы main. В окне сообщения отображается кнопка Справка. Когда пользователь нажимает кнопку Справка, открывается файл справки Mspaint.chm . В этом примере требуется, чтобы был установлен файл справки Mspaint.chm .

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r2 = MessageBox::Show( this, "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r2 = MessageBox.Show (this, "Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file.
Dim r2 As DialogResult = MessageBox.Show(Me, "Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Комментарии

Окно сообщения — это модальное диалоговое окно. Это означает, что ввод (нажатие клавиатурой или мышью) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя). С помощью owner параметра можно указать конкретный объект, реализующий IWin32Window интерфейс , который будет служить окном верхнего уровня диалогового окна и владельцем.

Когда пользователь нажимает кнопку Справка, открывается файл справки, указанный в параметре helpFilePath . Форма, владеющая окном сообщения (или активной формой), также получает HelpRequested событие.

Параметр helpFilePath может иметь форму C:\path\sample.chm или /folder/file.htm.

См. также раздел

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

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки и HelpNavigator.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Параметры

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

options
MessageBoxOptions

Одно из значений MessageBoxOptions, указывающее, какие параметры отображения и связи будут использованы для этого окна сообщения. Чтобы использовать значения по умолчанию, следует передать значение 0.

helpFilePath
String

Полный путь к файлу справки, который должен отображаться, когда пользователь щелкнет кнопку "Справка".

navigator
HelpNavigator

Одно из значений перечисления HelpNavigator.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

Заданный объект defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Параметром options задается и DefaultDesktopOnly, и ServiceNotification.

-или-

Параметр buttons задает недопустимое сочетание MessageBoxButtons.

Примеры

В следующем примере кода показано, как отобразить окно сообщения с кнопкой "Справка". Когда пользователь нажимает кнопку Справка, открывается файл справки Mspaint.chm и отображается вкладка "Индекс справки". В этом примере требуется, чтобы был установлен файл справки Mspaint.chm .

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
System::Windows::Forms::DialogResult r3 = MessageBox::Show( "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
DialogResult r3 = MessageBox.Show ("Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);
' Display a message box. The Help button opens 
' the Mspaint.chm Help file and shows the Help contents 
' on the Index tab.
Dim r3 As DialogResult = MessageBox.Show("Message with Help file and Help navigator.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.Index)

Комментарии

Окно сообщения — это модальное диалоговое окно. Это означает, что ввод (нажатие клавиатурой или мышью) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя).

Когда пользователь нажимает кнопку Справка, открывается файл справки, указанный helpFilePath в параметре navigator , и отображается содержимое справки, определяемое параметром . Форма, владеющая окном сообщения (или активной формой), также получает HelpRequested событие.

Скомпилированные файлы справки содержат оглавление, индекс, поиск и ключевое слово ссылки на страницах. Для можно использовать следующие значения navigator: TableOfContents, Find, Indexили Topic.

Параметр helpFilePath может иметь форму C:\path\sample.chm или /folder/file.htm.

См. также раздел

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

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки и Ключевое слово справки.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Параметры

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

options
MessageBoxOptions

Одно из значений MessageBoxOptions, указывающее, какие параметры отображения и связи будут использованы для этого окна сообщения. Чтобы использовать значения по умолчанию, следует передать значение 0.

helpFilePath
String

Полный путь к файлу справки, который должен отображаться, когда пользователь щелкнет кнопку "Справка".

keyword
String

Ключевое слово справки, отображаемое по щелчку кнопки "Справка".

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

Заданный объект defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Параметром options задается и DefaultDesktopOnly, и ServiceNotification.

-или-

Параметр buttons задает недопустимое сочетание MessageBoxButtons.

Примеры

В следующем примере кода показано, как отобразить окно сообщения с кнопкой "Справка". Когда пользователь нажимает кнопку Справка, Mspaint.chm открывается файл справки и отображается тема, определяемая mspaint.chm::/paint_brush.htm ключевое слово. В этом примере требуется, чтобы был установлен файл справки Mspaint.chm .

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r7 = MessageBox::Show( "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r7 = MessageBox.Show ("Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display a message box. The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r7 As DialogResult = MessageBox.Show("Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Комментарии

Окно сообщения — это модальное диалоговое окно, которое означает, что ввод (нажатие клавиатуры или мыши) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя).

Когда пользователь нажимает кнопку Справка, открывается файл справки, указанный helpFilePath в параметре , и отображается раздел справки ключевое слово, определенный keyword параметром . Форма, владеющая окном сообщения (или активной формой), также получает HelpRequested событие.

См. также раздел

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

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст, заголовок, кнопки, значок, кнопку по умолчанию и параметры.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Параметры

owner
IWin32Window

Реализация IWin32Window, которой будет принадлежать данное модальное диалоговое окно.

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

options
MessageBoxOptions

Одно из значений MessageBoxOptions, указывающее, какие параметры отображения и связи будут использованы для этого окна сообщения. Чтобы использовать значения по умолчанию, следует передать значение 0.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Параметром options задается и DefaultDesktopOnly, и ServiceNotification.

-или-

Параметр options задает DefaultDesktopOnly или ServiceNotification и определяет значение в параметре owner. Эти два варианта следует использовать только в том случае, если вызывается версия этого метода, которая не получает параметр owner.

-или-

Параметр buttons задает недопустимое сочетание MessageBoxButtons.

Примеры

В следующем примере кода показано, как отобразить MessageBox с параметрами, поддерживаемыми этой перегрузкой Show. После проверки того, ServerNameчто строковая переменная, , пуста, в примере отображается MessageBox, предлагающая пользователю возможность отменить операцию. Show Если возвращаемое значение метода имеет значение Yes, форма, отображающая MessageBox объект , закрывается.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Комментарии

С помощью owner параметра можно указать конкретный объект, реализующий IWin32Window интерфейс , который будет служить окном верхнего уровня диалогового окна и владельцем. Окно сообщения — это модальное диалоговое окно, которое означает, что ввод (нажатие клавиатуры или мыши) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя).

В окне сообщения можно использовать не более трех кнопок.

См. также раздел

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

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Параметры

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

options
MessageBoxOptions

Одно из значений MessageBoxOptions, указывающее, какие параметры отображения и связи будут использованы для этого окна сообщения. Чтобы использовать значения по умолчанию, следует передать значение 0.

helpFilePath
String

Полный путь к файлу справки, который должен отображаться, когда пользователь щелкнет кнопку "Справка".

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

Заданный объект defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Параметром options задается и DefaultDesktopOnly, и ServiceNotification.

-или-

Параметр buttons задает недопустимое сочетание MessageBoxButtons.

Примеры

В следующем примере кода показано, как отобразить окно сообщения с кнопкой "Справка". Когда пользователь нажимает кнопку Справка, открывается файл справки Mspaint.chm . Для этого примера требуется, чтобы файл справки Mspaint.chm был установлен.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r1 = MessageBox::Show( "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r1 = MessageBox.Show ("Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box with a help button. 
' The Help button opens the Mspaint.chm Help file.
Dim r1 As DialogResult = MessageBox.Show("Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Комментарии

Окно сообщения — это модальное диалоговое окно, которое означает, что ввод (нажатие клавиатуры или мыши) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя).

Когда пользователь нажимает кнопку Справка, открывается файл справки, указанный в параметре helpFilePath . Форма, владеющая окном сообщения (или активной формой), также получает HelpRequested событие.

Параметр helpFilePath может иметь форму C:\path\sample.chm или /folder/file.htm.

См. также раздел

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

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора и кнопкой "Справка".

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, bool displayHelpButton);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * bool -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, displayHelpButton As Boolean) As DialogResult

Параметры

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

options
MessageBoxOptions

Одно из значений MessageBoxOptions, указывающее, какие параметры отображения и связи будут использованы для этого окна сообщения. Чтобы использовать значения по умолчанию, следует передать значение 0.

displayHelpButton
Boolean

Значение true, если требуется отобразить кнопку "Справка"; в противном случае — значение false. Значение по умолчанию — false.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

Заданный объект defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Параметром options задается и DefaultDesktopOnly, и ServiceNotification.

-или-

Параметр buttons задает недопустимое сочетание MessageBoxButtons.

Примеры

В следующем примере кода показано, как отобразить окно сообщения с кнопкой "Справка", обработать Control.HelpRequested событие и отобразить пользовательское окно справки в ответ на событие.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
System::Windows::Forms::DialogResult AlertMessageWithCustomHelpWindow()
{
   
   // Handle the HelpRequested event for the following message.
   this->HelpRequested += gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   this->Tag = "Message with Help button.";
   
   // Show a message box with OK and Help buttons.
   System::Windows::Forms::DialogResult r = MessageBox::Show( "Message with Help button.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, true );
   
   // Remove the HelpRequested event handler to keep the event
   // from being handled for other message boxes.
   this->HelpRequested -= gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   
   // Return the dialog box result.
   return r;
}

void Form1_HelpRequested( System::Object^ sender, System::Windows::Forms::HelpEventArgs^ hlpevent )
{
   
   // Create a custom Help window in response to the HelpRequested event.
   Form^ helpForm = gcnew Form;
   
   // Set up the form position, size, and title caption.
   helpForm->StartPosition = FormStartPosition::Manual;
   helpForm->Size = System::Drawing::Size( 200, 400 );
   helpForm->DesktopLocation = Point(this->DesktopBounds.X + this->Size.Width,this->DesktopBounds.Top);
   helpForm->Text = "Help Form";
   
   // Create a label to contain the Help text.
   Label^ helpLabel = gcnew Label;
   
   // Add the label to the form and set its text.
   helpForm->Controls->Add( helpLabel );
   helpLabel->Dock = DockStyle::Fill;
   
   // Use the sender parameter to identify the context of the Help request.
   // The parameter must be cast to the Control type to get the Tag property.
   Control^ senderControl = dynamic_cast<Control^>(sender);
   helpLabel->Text = String::Format( "Help information shown in response to user action on the '{0}' message.", dynamic_cast<String^>(senderControl->Tag) );
   
   // Set the Help form to be owned by the main form. This helps
   // to ensure that the Help form is disposed of.
   this->AddOwnedForm( helpForm );
   
   // Show the custom Help window.
   helpForm->Show();
   
   // Indicate that the HelpRequested event is handled.
   hlpevent->Handled = true;
}
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
private DialogResult AlertMessageWithCustomHelpWindow ()
{
    // Handle the HelpRequested event for the following message.
    this.HelpRequested += new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    this.Tag = "Message with Help button.";

    // Show a message box with OK and Help buttons.
    DialogResult r = MessageBox.Show ("Message with Help button.", 
                                      "Help Caption", MessageBoxButtons.OK, 
                                      MessageBoxIcon.Question, 
                                      MessageBoxDefaultButton.Button1, 
                                      0, true);

    // Remove the HelpRequested event handler to keep the event
    // from being handled for other message boxes.
    this.HelpRequested -= new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    // Return the dialog box result.
    return r;
}

private void Form1_HelpRequested (System.Object sender, System.Windows.Forms.HelpEventArgs hlpevent)
{
    // Create a custom Help window in response to the HelpRequested event.
    Form helpForm = new Form ();

    // Set up the form position, size, and title caption.
    helpForm.StartPosition = FormStartPosition.Manual;
    helpForm.Size = new Size (200, 400);
    helpForm.DesktopLocation = new Point (this.DesktopBounds.X + 
                                          this.Size.Width, 
                                          this.DesktopBounds.Top);
    helpForm.Text = "Help Form";

    // Create a label to contain the Help text.
    Label helpLabel = new Label ();

    // Add the label to the form and set its text.
    helpForm.Controls.Add (helpLabel);
    helpLabel.Dock = DockStyle.Fill;

    // Use the sender parameter to identify the context of the Help request.
    // The parameter must be cast to the Control type to get the Tag property.
    Control senderControl = sender as Control;

    helpLabel.Text = "Help information shown in response to user action on the '" + 
                      (string)senderControl.Tag + "' message.";

    // Set the Help form to be owned by the main form. This helps
    // to ensure that the Help form is disposed of.
    this.AddOwnedForm (helpForm);

    // Show the custom Help window.
    helpForm.Show ();

    // Indicate that the HelpRequested event is handled.
    hlpevent.Handled = true;
}
' Display a message box with a Help button. Show a custom Help window
' by handling the HelpRequested event.
Private Function AlertMessageWithCustomHelpWindow() As DialogResult

    ' Handle the HelpRequested event for the following message.
    AddHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    Me.Tag = "Message with Help button."

    ' Show a message box with OK and Help buttons.
    Dim r As DialogResult = MessageBox.Show("Message with Help button.", _
                                          "Help Caption", MessageBoxButtons.OK, _
                                          MessageBoxIcon.Question, _
                                          MessageBoxDefaultButton.Button1, _
                                          0, True)

    ' Remove the HelpRequested event handler to keep the event
    ' from being handled for other message boxes.
    RemoveHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    ' Return the dialog box result.
    Return r
End Function

Private Sub Form1_HelpRequested(ByVal sender As System.Object, ByVal hlpevent As System.Windows.Forms.HelpEventArgs)

    ' Create a custom Help window in response to the HelpRequested event.
    Dim helpForm As Form = New Form

    ' Set up the form position, size, and title caption.
    With helpForm
        .StartPosition = FormStartPosition.Manual
        .Size = New Size(200, 400)
        .DesktopLocation = New Point(Me.DesktopBounds.X + _
                                     Me.Size.Width, Me.DesktopBounds.Top)
        .Text = "Help Form"
    End With

    ' Create a label to contain the Help text.
    Dim helpLabel As Label = New Label

    ' Add the label to the form and set its text.
    helpForm.Controls.Add(helpLabel)
    helpLabel.Dock = DockStyle.Fill

    ' Use the sender parameter to identify the context of the Help request.
    ' The parameter must be cast to the Control type to get the Tag property.
    Dim senderControl As Control = CType(sender, Control)

    helpLabel.Text = "Help information shown in response to user action on the '" & _
                      CStr(senderControl.Tag) & "' message."

    ' Set the Help form to be owned by the main form. This helps
    ' to ensure that the Help form is disposed of.
    Me.AddOwnedForm(helpForm)

    ' Show the custom Help window.
    helpForm.Show()

    ' Indicate that the HelpRequested event is handled.
    hlpevent.Handled = True
End Sub

Комментарии

Окно сообщения — это модальное диалоговое окно, которое означает, что ввод (нажатие клавиатуры или мыши) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя).

Когда пользователь нажимает кнопку Справка, форма, владеющая окном сообщения (или активной формой), получает HelpRequested событие. HelpRequested Обработка события для выполнения пользовательских действий справки.

См. также раздел

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

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки и HelpNavigator.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Параметры

owner
IWin32Window

Реализация IWin32Window, которой будет принадлежать данное модальное диалоговое окно.

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

options
MessageBoxOptions

Одно из значений MessageBoxOptions, указывающее, какие параметры отображения и связи будут использованы для этого окна сообщения. Чтобы использовать значения по умолчанию, следует передать значение 0.

helpFilePath
String

Полный путь к файлу справки, который должен отображаться, когда пользователь щелкнет кнопку "Справка".

navigator
HelpNavigator

Одно из значений перечисления HelpNavigator.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

Заданный объект defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Параметром options задается и DefaultDesktopOnly, и ServiceNotification.

-или-

Параметр buttons задает недопустимое сочетание MessageBoxButtons.

Примеры

В следующем примере кода показано, как отобразить окно сообщения, родительское для окна main. В окне сообщения отображается кнопка Справка. Когда пользователь нажимает кнопку "Справка", Mspaint.chm открывается файл справки и отображается вкладка "Индекс справки". Для этого примера требуется, чтобы файл справки Mspaint.chm был установлен.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
System::Windows::Forms::DialogResult r4 = MessageBox::Show( this, "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
DialogResult r4 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file
' and shows the Help contents on the Index tab.
Dim r4 As DialogResult = MessageBox.Show(Me, _
                                      "Message with Help file and Help navigator.", _
                                      "Help Caption", MessageBoxButtons.OK, _
                                      MessageBoxIcon.Question, _
                                      MessageBoxDefaultButton.Button1, _
                                      0, "mspaint.chm", _
                                      HelpNavigator.Index)

Комментарии

Окно сообщения — это модальное диалоговое окно, которое означает, что ввод (нажатие клавиатуры или мыши) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя). С помощью owner параметра можно указать конкретный объект, реализующий IWin32Window интерфейс , который будет служить окном верхнего уровня диалогового окна и владельцем.

Когда пользователь нажимает кнопку Справка, открывается файл справки, указанный helpFilePath в параметре , и отображается содержимое справки, определенное navigator параметром . Форма, владеющая окном сообщения (или активной формой), также получает HelpRequested событие.

Скомпилированные файлы справки содержат оглавление, индекс, поиск и ключевое слово ссылки на страницах. Для можно использовать следующие значения navigator: TableOfContents, Find, Index, или Topic.

Параметр helpFilePath может иметь форму C:\path\sample.chm или /folder/file.htm.

См. также раздел

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

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст, заголовок, кнопки, значок и кнопку по умолчанию.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Параметры

owner
IWin32Window

Реализация IWin32Window, которой будет принадлежать данное модальное диалоговое окно.

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Примеры

В следующем примере кода показано, как отобразить MessageBox с параметрами, поддерживаемыми этой перегрузкой Show. После проверки того, ServerNameчто строковая переменная, , пуста, в примере отображается MessageBox, предлагающая пользователю возможность отменить операцию. Show Если возвращаемое значение метода имеет значение Yes, форма, отображающая MessageBox объект , закрывается.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Комментарии

С помощью owner параметра можно указать конкретный объект, реализующий IWin32Window интерфейс , который будет служить окном верхнего уровня диалогового окна и владельцем. Окно сообщения — это модальное диалоговое окно, которое означает, что ввод (нажатие клавиатуры или мыши) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя).

В окне сообщения можно использовать не более трех кнопок.

См. также раздел

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

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст, заголовок, кнопки и значок.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Параметры

owner
IWin32Window

Реализация IWin32Window, которой будет принадлежать данное модальное диалоговое окно.

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Примеры

В следующем примере кода показано, как отобразить MessageBox с параметрами, поддерживаемыми этой перегрузкой Show. После проверки того, ServerNameчто строковая переменная, , пуста, в примере отображается MessageBox, предлагающая пользователю возможность отменить операцию. Show Если возвращаемое значение метода имеет значение Yes, форма, отображающая MessageBox объект , закрывается.

private:
   void validateUserEntry4()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry4()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry4()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Комментарии

С помощью owner параметра можно указать конкретный объект, реализующий IWin32Window интерфейс , который будет служить окном верхнего уровня диалогового окна и владельцем. Окно сообщения — это модальное диалоговое окно, которое означает, что ввод (нажатие клавиатуры или мыши) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя).

В окне сообщения можно использовать не более трех кнопок.

См. также раздел

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

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком и кнопкой по умолчанию.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Параметры

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Примеры

В следующем примере кода показано, как отобразить MessageBox с параметрами, поддерживаемыми этой перегрузкой Show. После проверки того, ServerNameчто строковая переменная, , пуста, в примере отображается MessageBox со значком поля вопроса, предлагая пользователю возможность отменить операцию. Show Если возвращаемое значение метода имеет значение Yes, форма, отображающая MessageBox объект , закрывается.

private:
   void validateUserEntry3()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1 );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry3()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
        MessageBoxIcon.Question, MessageBoxDefaultButton.Button1);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry3()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question, _
            MessageBoxDefaultButton.Button1)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If
End Sub

Комментарии

В окне сообщения можно использовать не более трех кнопок.

См. также раздел

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

Show(IWin32Window, String, String, MessageBoxButtons)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст, заголовок и кнопки.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Параметры

owner
IWin32Window

Реализация IWin32Window, которой будет принадлежать данное модальное диалоговое окно.

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Примеры

В следующем примере кода показано, как отобразить MessageBox с параметрами, поддерживаемыми этой перегрузкой Show. После проверки того, ServerNameчто строковая переменная, , пуста, в примере отображается MessageBox, предлагающая пользователю возможность отменить операцию. Show Если возвращаемое значение метода имеет значение Yes, форма, отображающая MessageBox объект , закрывается.

private:
   void validateUserEntry5()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry5()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry5()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Комментарии

С помощью owner параметра можно указать конкретный объект, реализующий IWin32Window интерфейс , который будет служить окном верхнего уровня диалогового окна и владельцем. Окно сообщения — это модальное диалоговое окно, которое означает, что ввод (нажатие клавиатуры или мыши) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя).

В окне сообщения можно использовать не более трех кнопок.

См. также раздел

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

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Отображает окно сообщения с заданным текстом, заголовком, кнопками и значком.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Параметры

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

Задаваемый параметр buttons не является членом MessageBoxButtons.

-или-

Задаваемый параметр icon не является членом MessageBoxIcon.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Примеры

В следующем примере кода демонстрируется один из Show методов обработки ComboBox.DropDown события . Чтобы запустить пример, вставьте следующий код в форму и вызовите InitializeComboBox метод из конструктора или Load метода формы.

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^ e )
   {
      MessageBox::Show( "Typical installation is strongly recommended.",
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }

// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128, 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100, 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text	= "Typical";
    string[] installs = new string[]{"Typical", "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}

' Declare ComboBox1.
Friend WithEvents ComboBox1 As System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128, 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100, 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String = New String() _
        {"Typical", "Compact", "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object, ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.", _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

Комментарии

В окне сообщения можно использовать не более трех кнопок.

См. также раздел

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

Show(IWin32Window, String, String)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст и заголовок.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption);
static member Show : System.Windows.Forms.IWin32Window * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String) As DialogResult

Параметры

owner
IWin32Window

Реализация IWin32Window, которой будет принадлежать данное модальное диалоговое окно.

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Комментарии

С помощью owner параметра можно указать конкретный объект, реализующий IWin32Window интерфейс , который будет служить окном верхнего уровня диалогового окна и владельцем. Окно сообщения — это модальное диалоговое окно, которое означает, что ввод (нажатие клавиатуры или мыши) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя).

По умолчанию в окне сообщения отображается кнопка ОК .

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

Show(String, String, MessageBoxButtons)

Отображает окно сообщения с заданным текстом, заголовком и кнопками.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Параметры

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

Задаваемый параметр buttons не является членом MessageBoxButtons.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Примеры

В следующем примере кода показано, как отобразить MessageBox с параметрами, поддерживаемыми этой перегрузкой Show. После проверки того, ServerNameчто строковая переменная, , пуста, в примере отображается MessageBox, предлагающая пользователю возможность отменить операцию. Show Если возвращаемое значение метода имеет значение Yes, форма, отображающая MessageBox объект , закрывается.

private:
   void validateUserEntry()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry()
{
    // Checks the value of the text.
    if(serverName.Text.Length == 0)
    {
        // Initializes the variables to pass to the MessageBox.Show method.
        string message = "You did not enter a server name. Cancel this operation?";
     string caption = "Error Detected in Input";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.
        result = MessageBox.Show(message, caption, buttons);
        if (result == System.Windows.Forms.DialogResult.Yes)
        {
            // Closes the parent form.
            this.Close();
        }
    }
}
Private Sub ValidateUserEntry()
    ' Checks the value of the text.
    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.
        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "Error Detected in Input"
        Dim Buttons As MessageBoxButtons = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays the MessageBox
        Result = MessageBox.Show(Message, Caption, Buttons)

        ' Gets the result of the MessageBox display.
        If Result = System.Windows.Forms.DialogResult.Yes Then
            ' Closes the parent form.
            Me.Close()
        End If
    End If
End Sub

Комментарии

В окне сообщения можно использовать не более трех кнопок.

См. также раздел

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

Show(IWin32Window, String)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text);
static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

Параметры

owner
IWin32Window

Реализация IWin32Window, которой будет принадлежать данное модальное диалоговое окно.

text
String

Текст, отображаемый в окне сообщения.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Комментарии

С помощью owner параметра можно указать конкретный объект, реализующий IWin32Window интерфейс , который будет служить окном верхнего уровня диалогового окна и владельцем. Окно сообщения — это модальное диалоговое окно, которое означает, что ввод (нажатие клавиатуры или мыши) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя).

По умолчанию в окне сообщения отображается кнопка ОК . Окно сообщения не содержит подпись в заголовке.

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

Show(String, String)

Отображает окно сообщения с заданным текстом и заголовком.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show (string text, string caption);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption);
static member Show : string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String) As DialogResult

Параметры

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Комментарии

По умолчанию в окне сообщения отображается кнопка ОК .

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

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию и параметрами для выбора.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Параметры

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

options
MessageBoxOptions

Одно из значений MessageBoxOptions, указывающее, какие параметры отображения и связи будут использованы для этого окна сообщения. Чтобы использовать значения по умолчанию, следует передать значение 0.

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

Заданный объект defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Параметром options задается и DefaultDesktopOnly, и ServiceNotification.

-или-

Параметр buttons задает недопустимое сочетание MessageBoxButtons.

Примеры

В следующем примере кода показано, как отобразить MessageBox с параметрами, поддерживаемыми этой перегрузкой Show. После проверки того, ServerNameчто строковая переменная, , пуста, в примере отображается MessageBox со значком поля вопроса, предлагая пользователю возможность отменить операцию. В примере используется RightAlign элемент перечисления MessageBoxOptions для выравнивания текста по правому краю диалогового окна. Show Если возвращаемое значение метода имеет значение Yes, форма, отображающая MessageBox объект , закрывается.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Комментарии

В окне сообщения можно использовать не более трех кнопок.

См. также раздел

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

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой "Справка", используя заданный файл справки, HelpNavigator и раздел справки.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Параметры

owner
IWin32Window

Реализация IWin32Window, которой будет принадлежать данное модальное диалоговое окно.

text
String

Текст, отображаемый в окне сообщения.

caption
String

Текст для отображения в строке заголовка окна сообщения.

buttons
MessageBoxButtons

Одно из значений MessageBoxButtons, указывающее, какие кнопки отображаются в окне сообщения.

icon
MessageBoxIcon

Одно из значений MessageBoxIcon, указывающее, какой значок отображается в окне сообщения.

defaultButton
MessageBoxDefaultButton

Одно из значений MessageBoxDefaultButton, определяющее кнопку по умолчанию для данного окна сообщения.

options
MessageBoxOptions

Одно из значений MessageBoxOptions, указывающее, какие параметры отображения и связи будут использованы для этого окна сообщения. Чтобы использовать значения по умолчанию, следует передать значение 0.

helpFilePath
String

Полный путь к файлу справки, который должен отображаться, когда пользователь щелкнет кнопку "Справка".

navigator
HelpNavigator

Одно из значений перечисления HelpNavigator.

param
Object

Числовой идентификатор раздела справки, отображаемый по щелчку кнопки "Справка".

Возвращаемое значение

Одно из значений перечисления DialogResult.

Исключения

buttons не является членом MessageBoxButtons.

-или-

icon не является членом MessageBoxIcon.

-или-

Заданный объект defaultButton не является членом MessageBoxDefaultButton.

Была предпринята попытка отобразить MessageBox в процессе, не работающем в режиме интерактивного взаимодействия с пользователем (User Interactive mode). Этот режим задается свойством UserInteractive.

Параметром options задается и DefaultDesktopOnly, и ServiceNotification.

-или-

Параметр buttons задает недопустимое сочетание MessageBoxButtons.

Примеры

В следующем примере кода показано, как отобразить окно сообщения, родительское для окна main. В окне сообщения отображается кнопка Справка. Когда пользователь нажимает кнопку Справка, Mspaint.chm открывается файл справки и отображается вкладка "Индекс справки" и тема, определяемая ovals ключевое слово. Для этого примера требуется, чтобы файл справки Mspaint.chm был установлен.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r6 = MessageBox::Show( this, "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r6 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r6 As DialogResult = MessageBox.Show(Me, _
                                   "Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Комментарии

Окно сообщения — это модальное диалоговое окно, которое означает, что ввод (нажатие клавиатуры или мыши) не может выполняться, кроме объектов в модальной форме. Перед вводом данных в другую форму программа должна скрыть или закрыть модальную форму (обычно в ответ на некоторые действия пользователя). С помощью owner параметра можно указать конкретный объект, реализующий IWin32Window интерфейс , который будет служить окном верхнего уровня диалогового окна и владельцем.

Когда пользователь нажимает кнопку Справка, открывается файл справки, указанный helpFilePath в параметре , и отображается содержимое справки, определенное navigator параметром . Форма, владеющая окном сообщения (или активной формой), также получает HelpRequested событие.

Скомпилированные файлы справки содержат оглавление, индекс, поиск и ключевое слово ссылки на страницах. Для можно использовать следующие значения navigator: TableOfContents, Find, Index, или Topic.

Вы можете использовать для param дальнейшего Topic уточнения команды. Если значение, указанное в параметре navigator , равно TableOfContents, Indexили Find, это значение должно иметь значение null. navigator Если параметр ссылается на Topic, это значение должно ссылаться на объект, содержащий числовое значение отображаемого раздела.

Параметр helpFilePath может иметь форму C:\path\sample.chm или /folder/file.htm.

См. также раздел

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