MessageBox.Show Método

Definição

Exibe uma caixa de mensagem.Displays a message box.

Sobrecargas

Show(String)

Exibe uma caixa de mensagem com o texto especificado.Displays a message box with specified text.

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

Exibe uma caixa de mensagem com o texto, a legenda, os botões, o ícone, o botão padrão, as opções e o botão de Ajuda especificados, usando o arquivo de Ajuda e a palavra-chave de Ajuda especificados.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado, HelpNavigator e o tópico da Ajuda.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado e HelpNavigator.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

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

Exibe uma caixa de mensagem com o texto, a legenda, os botões, o ícone, o botão padrão, as opções e o botão de Ajuda especificados, usando o arquivo de Ajuda e a palavra-chave de Ajuda especificados.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

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

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto, legenda, botões, ícone, botão padrão e opções especificados.Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, default button, and options.

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button.

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado e HelpNavigator.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

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

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto, legenda, botões, ícone e o botão padrão.Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, and default button.

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

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto especificado, legenda, botões e ícone.Displays a message box in front of the specified object and with the specified text, caption, buttons, and icon.

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

Exibe uma caixa de mensagem com o texto, a legenda, os botões, o ícone e o botão padrão especificados.Displays a message box with the specified text, caption, buttons, icon, and default button.

Show(IWin32Window, String, String, MessageBoxButtons)

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto, a legenda e os botões especificados.Displays a message box in front of the specified object and with the specified text, caption, and buttons.

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Exibe uma caixa de mensagem com o texto, legenda, botões e ícone especificados.Displays a message box with specified text, caption, buttons, and icon.

Show(IWin32Window, String, String)

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto e a legenda especificados.Displays a message box in front of the specified object and with the specified text and caption.

Show(String, String, MessageBoxButtons)

Exibe uma caixa de mensagem com o texto, a legenda os botões especificados.Displays a message box with specified text, caption, and buttons.

Show(IWin32Window, String)

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto especificado.Displays a message box in front of the specified object and with the specified text.

Show(String, String)

Exibe uma caixa de mensagem com o texto e a legenda especificados.Displays a message box with specified text and caption.

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

Exibe uma caixa de mensagem com o texto, legenda, botões, ícone, botão padrão e opções especificados.Displays a message box with the specified text, caption, buttons, icon, default button, and options.

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado, HelpNavigator e o tópico da Ajuda.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

Show(String)

Exibe uma caixa de mensagem com o texto especificado.Displays a message box with specified text.

public:
 static System::Windows::Forms::DialogResult Show(System::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

Parâmetros

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exemplos

O exemplo de código a seguir exibe uma caixa de mensagem simples.The following code example displays a simple message box.

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

Private Sub DisplayMessageBoxText()

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

Comentários

Por padrão, a caixa de mensagem exibe um botão OK .By default, the message box displays an OK button. A caixa de mensagem não contém uma legenda no título.The message box does not contain a caption in the title.

Segurança

UIPermission
para subjanelas seguras para definir essa propriedade.for safe subwindows to set this property. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

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

Exibe uma caixa de mensagem com o texto, a legenda, os botões, o ícone, o botão padrão, as opções e o botão de Ajuda especificados, usando o arquivo de Ajuda e a palavra-chave de Ajuda especificados.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

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);
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

Parâmetros

owner
IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.An implementation of IWin32Window that will own the modal dialog box.

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Um dos valores MessageBoxOptions que especifica quais opções de exibição e associação serão usadas para a caixa de mensagem.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Você poderá passar 0 se desejar usar os padrões.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.The path and name of the Help file to display when the user clicks the Help button.

keyword
String

A palavra-chave de Ajuda a ser exibida quando o usuário clicar no botão de Ajuda.The Help keyword to display when the user clicks the Help button.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- O defaultButton especificado não é membro do MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

options especificou DefaultDesktopOnly e ServiceNotification.options specified both DefaultDesktopOnly and ServiceNotification.

- ou --or- buttons especificou uma combinação inválida de MessageBoxButtons.buttons specified an invalid combination of MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem pai para a janela principal.The following code example demonstrates how to show a message box parented to the main window. A caixa de mensagem exibe um botão de ajuda.The message box displays a Help button. Quando o usuário clica no botão ajuda, o Mspaint.chm arquivo de ajuda é aberto e o tópico identificado mspaint.chm::/paint_brush.htm pela palavra-chave é exibido.When the user clicks the Help button, the Mspaint.chm Help file is opened and the topic identified by the mspaint.chm::/paint_brush.htm keyword is displayed. O exemplo requer que o Mspaint.chm arquivo de ajuda esteja instalado.The example requires that the Mspaint.chm Help file is installed.

#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")

Comentários

Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. Você pode usar o owner parâmetro para especificar um objeto específico, que implementa a IWin32Window interface, que funcionará como o proprietário de nível superior da caixa de diálogo.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level owner.

Quando o usuário clica no botão ajuda, o arquivo de ajuda especificado no helpFilePath parâmetro é aberto e o tópico de palavra-chave da keyword ajuda identificado pelo parâmetro é exibido.When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help keyword topic identified by the keyword parameter is displayed. O formulário que possui a caixa de mensagem (ou o formulário ativo) também recebe HelpRequested o evento.The form that owns the message box (or the active form) also receives the HelpRequested event.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
para acessar um arquivo de ajuda HTML por meio de uma solicitação HTTP.to access a HTML help file through a HTTP request. Enumeração associada: ConnectAssociated enumeration: Connect

SecurityPermission
para acessar um arquivo de ajuda HTML não atendido de um servidor HTTP.to access a HTML help file not served from a HTTP server. Enumeração associada: UnmanagedCodeAssociated enumeration: UnmanagedCode

Veja também

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado, HelpNavigator e o tópico da Ajuda.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

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);
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

Parâmetros

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Um dos valores MessageBoxOptions que especifica quais opções de exibição e associação serão usadas para a caixa de mensagem.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Você poderá passar 0 se desejar usar os padrões.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.The path and name of the Help file to display when the user clicks the Help button.

navigator
HelpNavigator

Um dos valores de HelpNavigator.One of the HelpNavigator values.

param
Object

A ID numérica e o tópico da Ajuda a ser exibida quando o usuário clica no botão Ajuda.The numeric ID of the Help topic to display when the user clicks the Help button.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- O defaultButton especificado não é membro do MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

options especificou DefaultDesktopOnly e ServiceNotification.options specified both DefaultDesktopOnly and ServiceNotification.

- ou --or- buttons especificou uma combinação inválida de MessageBoxButtons.buttons specified an invalid combination of MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem com um botão ajuda.The following code example demonstrates how to show a message box with a Help button. Quando o usuário clica no botão ajuda, o Mspaint.chm arquivo de ajuda é aberto e a guia Índice de ajuda e o tópico identificado ovals pela palavra-chave são exibidos.When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab and the topic identified by the ovals keyword are displayed. O exemplo requer que o Mspaint.chm arquivo de ajuda esteja instalado.The example requires that the Mspaint.chm Help file is installed.

#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")

Comentários

Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Quando o usuário clica no botão ajuda, o arquivo de ajuda especificado no helpFilePath parâmetro é aberto e o conteúdo da ajuda identificado navigator pelo parâmetro é exibido.When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. O formulário que possui a caixa de mensagem (ou o formulário ativo) também recebe HelpRequested o evento.The form that owns the message box (or the active form) also receives the HelpRequested event.

Os arquivos de ajuda compilados fornecem Sumário, índice, pesquisa e links de palavra-chave em páginas.Compiled help files provide table of contents, index, search, and keyword links in pages. Você pode usar os seguintes valores para navigator: TableOfContents, Find Index, ou Topic.You can use the following values for navigator: TableOfContents, Find, Index, or Topic.

Você pode usar param o Topic para fornecer mais refinamento do comando.You can use param to provide further refinement of the Topic command. Se navigator o valor especificado no parâmetro for TableOfContents, Indexou Find, esse valor deverá ser null.If the value specified in the navigator parameter is TableOfContents, Index, or Find, this value should be null. Se o navigator parâmetro fizer Topicreferência, esse valor deverá fazer referência a um objeto que contém o valor numérico do tópico a ser exibido.If the navigator parameter references Topic, this value should reference an object that contains the numeric value of the topic to display.

O helpFilePath parâmetro pode estar no formato C:\path\sample.chm ou/folder/file.htm.The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
para acessar um arquivo de ajuda HTML por meio de uma solicitação HTTP.to access a HTML help file through a HTTP request. Enumeração associada: ConnectAssociated enumeration: Connect

SecurityPermission
para acessar um arquivo de ajuda HTML não atendido de um servidor HTTP.to access a HTML help file not served from a HTTP server. Enumeração associada: UnmanagedCodeAssociated enumeration: UnmanagedCode

Veja também

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

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);
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

Parâmetros

owner
IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.An implementation of IWin32Window that will own the modal dialog box.

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Um dos valores MessageBoxOptions que especifica quais opções de exibição e associação serão usadas para a caixa de mensagem.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Você poderá passar 0 se desejar usar os padrões.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.The path and name of the Help file to display when the user clicks the Help button.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- O defaultButton especificado não é membro do MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

options especificou DefaultDesktopOnly e ServiceNotification.options specified both DefaultDesktopOnly and ServiceNotification.

- ou --or- buttons especificou uma combinação inválida de MessageBoxButtons.buttons specified an invalid combination of MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem que tem como pai o formulário principal.The following code example demonstrates how to show a message box that parented to the main form. A caixa de mensagem exibe um botão de ajuda.The message box displays a Help button. Quando o usuário clica no botão ajuda, o Mspaint.chm arquivo de ajuda é aberto.When the user clicks the Help button, the Mspaint.chm Help file is opened. O exemplo requer que o Mspaint.chm arquivo de ajuda esteja instalado.The example requires that the Mspaint.chm Help file is installed.

#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")

Comentários

Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. Você pode usar o owner parâmetro para especificar um objeto específico, que implementa a IWin32Window interface, que servirá como a janela de nível superior e o proprietário da caixa de diálogo.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner.

Quando o usuário clica no botão ajuda, o arquivo de ajuda especificado no helpFilePath parâmetro é aberto.When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened. O formulário que possui a caixa de mensagem (ou o formulário ativo) também recebe HelpRequested o evento.The form that owns the message box (or the active form) also receives the HelpRequested event.

O helpFilePath parâmetro pode estar no formato C:\path\sample.chm ou/folder/file.htm.The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
para acessar um arquivo de ajuda HTML por meio de uma solicitação HTTP.to access a HTML help file through a HTTP request. Enumeração associada: ConnectAssociated enumeration: Connect

SecurityPermission
para acessar um arquivo de ajuda HTML não atendido de um servidor HTTP.to access a HTML help file not served from a HTTP server. Enumeração associada: UnmanagedCodeAssociated enumeration: UnmanagedCode

Veja também

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado e HelpNavigator.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and 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);
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

Parâmetros

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Um dos valores MessageBoxOptions que especifica quais opções de exibição e associação serão usadas para a caixa de mensagem.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Você poderá passar 0 se desejar usar os padrões.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.The path and name of the Help file to display when the user clicks the Help button.

navigator
HelpNavigator

Um dos valores de HelpNavigator.One of the HelpNavigator values.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- O defaultButton especificado não é membro do MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

options especificou DefaultDesktopOnly e ServiceNotification.options specified both DefaultDesktopOnly and ServiceNotification.

- ou --or- buttons especificou uma combinação inválida de MessageBoxButtons.buttons specified an invalid combination of MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem com um botão ajuda.The following code example demonstrates how to show a message box with a Help button. Quando o usuário clica no botão ajuda, o Mspaint.chm arquivo de ajuda é aberto e a guia Índice de ajuda é exibida.When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab is displayed. O exemplo requer que o Mspaint.chm arquivo de ajuda esteja instalado.The example requires that the Mspaint.chm Help file is installed.

#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)

Comentários

Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Quando o usuário clica no botão ajuda, o arquivo de ajuda especificado no helpFilePath parâmetro é aberto e o conteúdo da ajuda identificado navigator pelo parâmetro é exibido.When the user clicks the Help button, the help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. O formulário que possui a caixa de mensagem (ou o formulário ativo) também recebe HelpRequested o evento.The form that owns the message box (or the active form) also receives the HelpRequested event.

Os arquivos de ajuda compilados fornecem Sumário, índice, pesquisa e links de palavra-chave em páginas.Compiled Help files provide table of contents, index, search, and keyword links in pages. Você pode usar os seguintes valores para navigator: TableOfContents, Find Index, ou Topic.You can use the following values for navigator: TableOfContents, Find, Index, or Topic.

O helpFilePath parâmetro pode estar no formato C:\path\sample.chm ou/folder/file.htm.The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
para acessar um arquivo de ajuda HTML por meio de uma solicitação HTTP.to access a HTML help file through a HTTP request. Enumeração associada: ConnectAssociated enumeration: Connect

SecurityPermission
para acessar um arquivo de ajuda HTML não atendido de um servidor HTTP.to access a HTML help file not served from a HTTP server. Enumeração associada: UnmanagedCodeAssociated enumeration: UnmanagedCode

Veja também

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

Exibe uma caixa de mensagem com o texto, a legenda, os botões, o ícone, o botão padrão, as opções e o botão de Ajuda especificados, usando o arquivo de Ajuda e a palavra-chave de Ajuda especificados.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

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);
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

Parâmetros

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Um dos valores MessageBoxOptions que especifica quais opções de exibição e associação serão usadas para a caixa de mensagem.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Você poderá passar 0 se desejar usar os padrões.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.The path and name of the Help file to display when the user clicks the Help button.

keyword
String

A palavra-chave de Ajuda a ser exibida quando o usuário clicar no botão de Ajuda.The Help keyword to display when the user clicks the Help button.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- O defaultButton especificado não é membro do MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

options especificou DefaultDesktopOnly e ServiceNotification.options specified both DefaultDesktopOnly and ServiceNotification.

- ou --or- buttons especificou uma combinação inválida de MessageBoxButtons.buttons specified an invalid combination of MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem com um botão ajuda.The following code example demonstrates how to show a message box with a Help button. Quando o usuário clica no botão ajuda, o Mspaint.chm arquivo de ajuda é aberto e o tópico identificado mspaint.chm::/paint_brush.htm pela palavra-chave é exibido.When the user clicks the Help button, the Mspaint.chm Help file is opened and the topic identified by the mspaint.chm::/paint_brush.htm keyword is displayed. O exemplo requer que o Mspaint.chm arquivo de ajuda esteja instalado.The example requires that the Mspaint.chm Help file is installed.

#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")

Comentários

Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Quando o usuário clica no botão ajuda, o arquivo de ajuda especificado no helpFilePath parâmetro é aberto e o tópico de palavra-chave da keyword ajuda identificado pelo parâmetro é exibido.When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help keyword topic identified by the keyword parameter is displayed. O formulário que possui a caixa de mensagem (ou o formulário ativo) também recebe HelpRequested o evento.The form that owns the message box (or the active form) also receives the HelpRequested event.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
para acessar um arquivo de ajuda HTML por meio de uma solicitação HTTP.to access a HTML help file through a HTTP request. Enumeração associada: ConnectAssociated enumeration: Connect

SecurityPermission
para acessar um arquivo de ajuda HTML não atendido de um servidor HTTP.to access a HTML help file not served from a HTTP server. Enumeração associada: UnmanagedCodeAssociated enumeration: UnmanagedCode

Veja também

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

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto, legenda, botões, ícone, botão padrão e opções especificados.Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, default button, and options.

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);
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

Parâmetros

owner
IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.An implementation of IWin32Window that will own the modal dialog box.

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values the specifies the default button for the message box.

options
MessageBoxOptions

Um dos valores MessageBoxOptions que especifica quais opções de exibição e associação serão usadas para a caixa de mensagem.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Você poderá passar 0 se desejar usar os padrões.You may pass in 0 if you wish to use the defaults.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- defaultButton não é membro de MessageBoxDefaultButton.defaultButton is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

options especificou DefaultDesktopOnly e ServiceNotification.options specified both DefaultDesktopOnly and ServiceNotification.

- ou --or- options especificou DefaultDesktopOnly ou ServiceNotification e especificou um valor no parâmetro owner.options specified DefaultDesktopOnly or ServiceNotification and specified a value in the owner parameter. Essas duas opções devem ser usadas somente se você invoca a versão desse método que não usa um parâmetro owner.These two options should be used only if you invoke the version of this method that does not take an owner parameter.

- ou --or- buttons especificou uma combinação inválida de MessageBoxButtons.buttons specified an invalid combination of MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como exibir MessageBox um com as opções suportadas por Showessa sobrecarga de.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Depois de verificar se uma variável de cadeia ServerNamede caracteres,, está vazia, o MessageBoxexemplo exibe um, oferecendo ao usuário a opção de cancelar a operação.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. Se o Show valor de retorno do método for avaliado Yescomo, o formulário que exibiu o MessageBox será fechado.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

Comentários

Você pode usar o owner parâmetro para especificar um objeto específico, que implementa a IWin32Window interface, que servirá como a janela de nível superior e o proprietário da caixa de diálogo.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Você pode ter um máximo de três botões na caixa de mensagem.You can have a maximum of three buttons on the message box.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Veja também

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

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);
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

Parâmetros

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Um dos valores MessageBoxOptions que especifica quais opções de exibição e associação serão usadas para a caixa de mensagem.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Você poderá passar 0 se desejar usar os padrões.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.The path and name of the Help file to display when the user clicks the Help button.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- O defaultButton especificado não é membro do MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

options especificou DefaultDesktopOnly e ServiceNotification.options specified both DefaultDesktopOnly and ServiceNotification.

- ou --or- buttons especificou uma combinação inválida de MessageBoxButtons.buttons specified an invalid combination of MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem com um botão ajuda.The following code example demonstrates how to show a message box with a Help button. Quando o usuário clica no botão ajuda, o Mspaint.chm arquivo de ajuda é aberto.When the user clicks the Help button, the Mspaint.chm Help file is opened. O exemplo requer que o Mspaint.chm arquivo de ajuda esteja instalado.The example requires that the Mspaint.chm Help file is installed.

#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")

Comentários

Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Quando o usuário clica no botão ajuda, o arquivo de ajuda especificado helpFilePath no parâmetro é aberto.When the user clicks Help button, the Help file specified in the helpFilePath parameter is opened. O formulário que possui a caixa de mensagem (ou o formulário ativo) também recebe HelpRequested o evento.The form that owns the message box (or the active form) also receives the HelpRequested event.

O helpFilePath parâmetro pode estar no formato C:\path\sample.chm ou/folder/file.htm.The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
para acessar um arquivo de ajuda HTML por meio de uma solicitação HTTP.to access a HTML help file through a HTTP request. Enumeração associada: ConnectAssociated enumeration: Connect

SecurityPermission
para acessar um arquivo de ajuda HTML não atendido de um servidor HTTP.to access a HTML help file not served from a HTTP server. Enumeração associada: UnmanagedCodeAssociated enumeration: UnmanagedCode

Veja também

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button.

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);
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

Parâmetros

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Um dos valores MessageBoxOptions que especifica quais opções de exibição e associação serão usadas para a caixa de mensagem.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Você poderá passar 0 se desejar usar os padrões.You may pass in 0 if you wish to use the defaults.

displayHelpButton
Boolean

true para mostrar o botão Ajuda; caso contrário, false.true to show the Help button; otherwise, false. O padrão é false.The default is false.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- O defaultButton especificado não é membro do MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

options especificou DefaultDesktopOnly e ServiceNotification.options specified both DefaultDesktopOnly and ServiceNotification.

- ou --or- buttons especificou uma combinação inválida de MessageBoxButtons.buttons specified an invalid combination of MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem com um botão ajuda, Control.HelpRequested manipular o evento e mostrar uma janela de ajuda personalizada em resposta ao evento.The following code example demonstrates how to show a message box with a Help button, handle the Control.HelpRequested event, and show a custom help window in response to the event.

#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

Comentários

Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Quando o usuário clica no botão ajuda, o formulário que possui a caixa de mensagem (ou o formulário ativo) recebe HelpRequested o evento.When the user clicks the Help button, the form that owns the message box (or the active form) receives the HelpRequested event. Manipule o HelpRequested evento para executar ações de ajuda personalizadas.Handle the HelpRequested event to perform custom Help actions.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Veja também

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado e HelpNavigator.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and 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);
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

Parâmetros

owner
IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.An implementation of IWin32Window that will own the modal dialog box.

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Um dos valores MessageBoxOptions que especifica quais opções de exibição e associação serão usadas para a caixa de mensagem.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Você poderá passar 0 se desejar usar os padrões.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.The path and name of the Help file to display when the user clicks the Help button.

navigator
HelpNavigator

Um dos valores de HelpNavigator.One of the HelpNavigator values.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- O defaultButton especificado não é membro do MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

options especificou DefaultDesktopOnly e ServiceNotification.options specified both DefaultDesktopOnly and ServiceNotification.

- ou --or- buttons especificou uma combinação inválida de MessageBoxButtons.buttons specified an invalid combination of MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem pai para a janela principal.The following code example demonstrates how to show a message box parented to the main window. A caixa de mensagem exibe um botão de ajuda.The message box displays a Help button. Quando o usuário clica no botão ajuda, o Mspaint.chm arquivo de ajuda é aberto e a guia Índice de ajuda é exibida.When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab is displayed. O exemplo requer que o Mspaint.chm arquivo de ajuda esteja instalado.The example requires that the Mspaint.chm Help file is installed.

#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)

Comentários

Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. Você pode usar o owner parâmetro para especificar um objeto específico, que implementa a IWin32Window interface, que servirá como a janela de nível superior e o proprietário da caixa de diálogo.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner.

Quando o usuário clica no botão ajuda, o arquivo de ajuda especificado no helpFilePath parâmetro é aberto e o conteúdo da ajuda identificado navigator pelo parâmetro é exibido.When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. O formulário que possui a caixa de mensagem (ou o formulário ativo) também recebe HelpRequested o evento.The form that owns the message box (or the active form) also receives the HelpRequested event.

Os arquivos de ajuda compilados fornecem Sumário, índice, pesquisa e links de palavra-chave em páginas.Compiled Help files provide table of contents, index, search, and keyword links in pages. Você pode usar os seguintes valores para navigator: TableOfContents, Find Index, ou Topic.You can use the following values for navigator: TableOfContents, Find, Index, or Topic.

O helpFilePath parâmetro pode estar no formato C:\path\sample.chm ou/folder/file.htm.The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
para acessar um arquivo de ajuda HTML por meio de uma solicitação HTTP.to access a HTML help file through a HTTP request. Enumeração associada: ConnectAssociated enumeration: Connect

SecurityPermission
para acessar um arquivo de ajuda HTML não atendido de um servidor HTTP.to access a HTML help file not served from a HTTP server. Enumeração associada: UnmanagedCodeAssociated enumeration: UnmanagedCode

Veja também

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

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto, legenda, botões, ícone e o botão padrão.Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, and default button.

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);
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

Parâmetros

owner
IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.An implementation of IWin32Window that will own the modal dialog box.

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- defaultButton não é membro de MessageBoxDefaultButton.defaultButton is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

Exemplos

O exemplo de código a seguir demonstra como exibir MessageBox um com as opções suportadas por Showessa sobrecarga de.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Depois de verificar se uma variável de cadeia ServerNamede caracteres,, está vazia, o MessageBoxexemplo exibe um, oferecendo ao usuário a opção de cancelar a operação.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. Se o Show valor de retorno do método for avaliado Yescomo, o formulário que exibiu o MessageBox será fechado.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

Comentários

Você pode usar o owner parâmetro para especificar um objeto específico, que implementa a IWin32Window interface, que servirá como a janela de nível superior e o proprietário da caixa de diálogo.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Você pode ter um máximo de três botões na caixa de mensagem.You can have a maximum of three buttons on the message box.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Veja também

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

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto especificado, legenda, botões e ícone.Displays a message box in front of the specified object and with the specified text, caption, buttons, and icon.

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);
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

Parâmetros

owner
IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.An implementation of IWin32Window that will own the modal dialog box.

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

Exemplos

O exemplo de código a seguir demonstra como exibir MessageBox um com as opções suportadas por Showessa sobrecarga de.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Depois de verificar se uma variável de cadeia ServerNamede caracteres,, está vazia, o MessageBoxexemplo exibe um, oferecendo ao usuário a opção de cancelar a operação.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. Se o Show valor de retorno do método for avaliado Yescomo, o formulário que exibiu o MessageBox será fechado.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

Comentários

Você pode usar o owner parâmetro para especificar um objeto específico, que implementa a IWin32Window interface, que servirá como a janela de nível superior e o proprietário da caixa de diálogo.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Você pode ter um máximo de três botões na caixa de mensagem.You can have a maximum of three buttons on the message box.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Veja também

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

Exibe uma caixa de mensagem com o texto, a legenda, os botões, o ícone e o botão padrão especificados.Displays a message box with the specified text, caption, buttons, icon, and default button.

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);
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

Parâmetros

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- defaultButton não é membro de MessageBoxDefaultButton.defaultButton is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

Exemplos

O exemplo de código a seguir demonstra como exibir MessageBox um com as opções suportadas por Showessa sobrecarga de.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Depois de verificar se uma variável de cadeia ServerNamede caracteres,, está vazia, o MessageBox exemplo exibe um ícone com uma caixa de pergunta, oferecendo ao usuário a opção de cancelar a operação.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox with a question box icon, offering the user the option to cancel the operation. Se o Show valor de retorno do método for avaliado Yescomo, o formulário que exibiu o MessageBox será fechado.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

Comentários

Você pode ter um máximo de três botões na caixa de mensagem.You can have a maximum of three buttons on the message box.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Veja também

Show(IWin32Window, String, String, MessageBoxButtons)

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto, a legenda e os botões especificados.Displays a message box in front of the specified object and with the specified text, caption, and buttons.

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);
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

Parâmetros

owner
IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.An implementation of IWin32Window that will own the modal dialog box.

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

Exemplos

O exemplo de código a seguir demonstra como exibir MessageBox um com as opções suportadas por Showessa sobrecarga de.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Depois de verificar se uma variável de cadeia ServerNamede caracteres,, está vazia, o MessageBoxexemplo exibe um, oferecendo ao usuário a opção de cancelar a operação.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. Se o Show valor de retorno do método for avaliado Yescomo, o formulário que exibiu o MessageBox será fechado.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

Comentários

Você pode usar o owner parâmetro para especificar um objeto específico, que implementa a IWin32Window interface, que servirá como a janela de nível superior e o proprietário da caixa de diálogo.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Você pode ter um máximo de três botões na caixa de mensagem.You can have a maximum of three buttons on the message box.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Veja também

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Exibe uma caixa de mensagem com o texto, legenda, botões e ícone especificados.Displays a message box with specified text, caption, buttons, and icon.

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);
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

Parâmetros

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

O parâmetro buttons especificado não é membro de MessageBoxButtons.The buttons parameter specified is not a member of MessageBoxButtons.

- ou --or- O parâmetro icon especificado não é membro de MessageBoxIcon.The icon parameter specified is not a member of MessageBoxIcon.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

Exemplos

O exemplo de código a seguir demonstra um Show dos métodos ao manipular ComboBox.DropDown o evento.The following code example demonstrates one of the Show methods when handling the ComboBox.DropDown event. Para executar o exemplo, Cole o código a seguir em um formulário e chame InitializeComboBox o método do construtor ou Load método do formulário.To run the example, paste the following code in a form and call the InitializeComboBox method from the form's constructor or Load method.

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

Comentários

Você pode ter um máximo de três botões na caixa de mensagem.You can have a maximum of three buttons on the message box.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Veja também

Show(IWin32Window, String, String)

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto e a legenda especificados.Displays a message box in front of the specified object and with the specified text and caption.

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);
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

Parâmetros

owner
IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.An implementation of IWin32Window that will own the modal dialog box.

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Comentários

Você pode usar o owner parâmetro para especificar um objeto específico, que implementa a IWin32Window interface, que servirá como a janela de nível superior e o proprietário da caixa de diálogo.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Por padrão, a caixa de mensagem exibe um botão OK .By default, the message box displays an OK button.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Show(String, String, MessageBoxButtons)

Exibe uma caixa de mensagem com o texto, a legenda os botões especificados.Displays a message box with specified text, caption, and buttons.

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);
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

Parâmetros

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

O parâmetro buttons especificado não é membro de MessageBoxButtons.The buttons parameter specified is not a member of MessageBoxButtons.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

Exemplos

O exemplo de código a seguir demonstra como exibir MessageBox um com as opções suportadas por Showessa sobrecarga de.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Depois de verificar se uma variável de cadeia ServerNamede caracteres,, está vazia, o MessageBoxexemplo exibe um, oferecendo ao usuário a opção de cancelar a operação.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. Se o Show valor de retorno do método for avaliado Yescomo, o formulário que exibiu o MessageBox será fechado.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

Comentários

Você pode ter um máximo de três botões na caixa de mensagem.You can have a maximum of three buttons on the message box.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Veja também

Show(IWin32Window, String)

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto especificado.Displays a message box in front of the specified object and with the specified text.

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);
static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

Parâmetros

owner
IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.An implementation of IWin32Window that will own the modal dialog box.

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Comentários

Você pode usar o owner parâmetro para especificar um objeto específico, que implementa a IWin32Window interface, que servirá como a janela de nível superior e o proprietário da caixa de diálogo.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Por padrão, a caixa de mensagem exibe um botão OK .By default, the message box displays an OK button. A caixa de mensagem não contém uma legenda no título.The message box does not contain a caption in the title.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Show(String, String)

Exibe uma caixa de mensagem com o texto e a legenda especificados.Displays a message box with specified text and caption.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::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

Parâmetros

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Comentários

Por padrão, a caixa de mensagem exibe um botão OK .By default, the message box displays an OK button.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

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

Exibe uma caixa de mensagem com o texto, legenda, botões, ícone, botão padrão e opções especificados.Displays a message box with the specified text, caption, buttons, icon, default button, and options.

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);
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

Parâmetros

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Um dos valores MessageBoxOptions que especifica quais opções de exibição e associação serão usadas para a caixa de mensagem.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Você poderá passar 0 se desejar usar os padrões.You may pass in 0 if you wish to use the defaults.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- O defaultButton especificado não é membro do MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

options especificou DefaultDesktopOnly e ServiceNotification.options specified both DefaultDesktopOnly and ServiceNotification.

- ou --or- buttons especificou uma combinação inválida de MessageBoxButtons.buttons specified an invalid combination of MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como exibir MessageBox um com as opções suportadas por Showessa sobrecarga de.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Depois de verificar se uma variável de cadeia ServerNamede caracteres,, está vazia, o MessageBox exemplo exibe um ícone com uma caixa de pergunta, oferecendo ao usuário a opção de cancelar a operação.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox with a question box icon, offering the user the option to cancel the operation. O exemplo usa o RightAlign membro MessageBoxOptions da enumeração para alinhar o texto à borda direita da caixa de diálogo.The example uses the RightAlign member of the MessageBoxOptions enumeration to align the text to the right edge of the dialog box. Se o Show valor de retorno do método for avaliado Yescomo, o formulário que exibiu o MessageBox será fechado.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

Comentários

Você pode ter um máximo de três botões na caixa de mensagem.You can have a maximum of three buttons on the message box.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Veja também

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

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado, HelpNavigator e o tópico da Ajuda.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

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);
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

Parâmetros

owner
IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.An implementation of IWin32Window that will own the modal dialog box.

text
String

O texto a ser exibido na caixa de mensagem.The text to display in the message box.

caption
String

O texto a ser exibido na barra de título da caixa de mensagem.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Um dos valores MessageBoxOptions que especifica quais opções de exibição e associação serão usadas para a caixa de mensagem.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Você poderá passar 0 se desejar usar os padrões.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.The path and name of the Help file to display when the user clicks the Help button.

navigator
HelpNavigator

Um dos valores de HelpNavigator.One of the HelpNavigator values.

param
Object

A ID numérica e o tópico da Ajuda a ser exibida quando o usuário clica no botão Ajuda.The numeric ID of the Help topic to display when the user clicks the Help button.

Retornos

Um dos valores de DialogResult.One of the DialogResult values.

Exceções

buttons não é membro de MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- ou --or- icon não é membro de MessageBoxIcon.icon is not a member of MessageBoxIcon.

- ou --or- O defaultButton especificado não é membro do MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Isso é especificado pela propriedade UserInteractive.This is specified by the UserInteractive property.

options especificou DefaultDesktopOnly e ServiceNotification.options specified both DefaultDesktopOnly and ServiceNotification.

- ou --or- buttons especificou uma combinação inválida de MessageBoxButtons.buttons specified an invalid combination of MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem pai para a janela principal.The following code example demonstrates how to show a message box parented to the main window. A caixa de mensagem exibe um botão de ajuda.The message box displays a Help button. Quando o usuário clica no botão ajuda, o Mspaint.chm arquivo de ajuda é aberto e a guia Índice de ajuda e o tópico identificado ovals pela palavra-chave são exibidos.When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab and the topic identified by the ovals keyword are displayed. O exemplo requer que o Mspaint.chm arquivo de ajuda esteja instalado.The example requires that the Mspaint.chm Help file is installed.

#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")

Comentários

Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou clique no mouse) pode ocorrer exceto para objetos no formulário modal.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada para outro formulário possa ocorrer.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. Você pode usar o owner parâmetro para especificar um objeto específico, que implementa a IWin32Window interface, que servirá como a janela de nível superior e o proprietário da caixa de diálogo.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner.

Quando o usuário clica no botão ajuda, o arquivo de ajuda especificado no helpFilePath parâmetro é aberto e o conteúdo da ajuda identificado navigator pelo parâmetro é exibido.When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. O formulário que possui a caixa de mensagem (ou o formulário ativo) também recebe HelpRequested o evento.The form that owns the message box (or the active form) also receives the HelpRequested event.

Os arquivos de ajuda compilados fornecem Sumário, índice, pesquisa e links de palavra-chave em páginas.Compiled help files provide table of contents, index, search, and keyword links in pages. Você pode usar os seguintes valores para navigator: TableOfContents, Find Index, ou Topic.You can use the following values for navigator: TableOfContents, Find, Index, or Topic.

Você pode usar param o Topic para fornecer mais refinamento do comando.You can use param to provide further refinement of the Topic command. Se navigator o valor especificado no parâmetro for TableOfContents, Indexou Find, esse valor deverá ser null.If the value specified in the navigator parameter is TableOfContents, Index, or Find, this value should be null. Se o navigator parâmetro fizer Topicreferência, esse valor deverá fazer referência a um objeto que contém o valor numérico do tópico a ser exibido.If the navigator parameter references Topic, this value should reference an object that contains the numeric value of the topic to display.

O helpFilePath parâmetro pode estar no formato C:\path\sample.chm ou/folder/file.htm.The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Segurança

UIPermission
para subjanelas seguras para chamar esse método.for safe subwindows to call this method. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
para acessar um arquivo de ajuda HTML por meio de uma solicitação HTTP.to access a HTML help file through a HTTP request. Enumeração associada: ConnectAssociated enumeration: Connect

SecurityPermission
para acessar um arquivo de ajuda HTML não atendido de um servidor HTTP.to access a HTML help file not served from a HTTP server. Enumeração associada: UnmanagedCodeAssociated enumeration: UnmanagedCode

Veja também

Aplica-se a