MessageBox.Show Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Exibe uma caixa de mensagem.

Sobrecargas

Show(String)	Exibe uma caixa de mensagem com o texto especificado.
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.
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.
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.
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`.
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.
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.
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.
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.
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`.
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.
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.
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.
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.
Show(String, String, MessageBoxButtons, MessageBoxIcon)	Exibe uma caixa de mensagem com o texto, legenda, botões e ícone especificados.
Show(IWin32Window, String, String)	Exibe uma caixa de mensagem na frente do objeto especificado e com o texto e a legenda especificados.
Show(String, String, MessageBoxButtons)	Exibe uma caixa de mensagem com o texto, a legenda os botões especificados.
Show(IWin32Window, String)	Exibe uma caixa de mensagem na frente do objeto especificado e com o texto especificado.
Show(String, String)	Exibe uma caixa de mensagem com o texto e a legenda especificados.
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.
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.

Show(String)

Exibe uma caixa de mensagem com o texto especificado.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text);

public static System.Windows.Forms.DialogResult Show (string text);

public static System.Windows.Forms.DialogResult Show (string? text);

static member Show : string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String) As DialogResult

Parâmetros

text: String

O texto a ser exibido na caixa de mensagem.

Retornos

DialogResult

Um dos valores de DialogResult.

Exemplos

O exemplo de código a seguir exibe uma caixa de mensagem simples.

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 . A caixa de mensagem não contém um legenda no título.

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parâmetros

owner: IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

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. Você poderá passar 0 se desejar usar os padrões.

helpFilePath: String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.

keyword: String

A palavra-chave de Ajuda a ser exibida quando o usuário clicar no botão de Ajuda.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

O defaultButton especificado não é membro do MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

ArgumentException

options especificou DefaultDesktopOnly e ServiceNotification.

- ou -

buttons especificou uma combinação inválida de MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem pai para a janela main. A caixa de mensagem exibe um botão Ajuda. Quando o usuário clica no botão Ajuda, o Mspaint.chm arquivo de Ajuda é aberto e o tópico identificado pelo mspaint.chm::/paint_brush.htm palavra-chave é exibido. O exemplo requer que o Mspaint.chm arquivo de Ajuda esteja instalado.

#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 (clique no teclado ou mouse) pode ocorrer, exceto para objetos no formulário modal. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada em outro formulário possa ocorrer. Você pode usar o owner parâmetro para especificar um objeto específico, que implementa a IWin32Window interface , que servirá como o proprietário de nível superior da caixa de diálogo.

Quando o usuário clica no botão Ajuda, o arquivo de Ajuda especificado no helpFilePath parâmetro é aberto e o tópico Ajuda palavra-chave identificado pelo keyword parâmetro é exibido. O formulário que possui a caixa de mensagem (ou o formulário ativo) também recebe o HelpRequested evento.

Confira também

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parâmetros

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

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. Você poderá passar 0 se desejar usar os padrões.

helpFilePath: String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.

navigator: HelpNavigator

Um dos valores de HelpNavigator.

param: Object

A ID numérica e o tópico da Ajuda a ser exibida quando o usuário clica no botão Ajuda.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

O defaultButton especificado não é membro do MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

ArgumentException

options especificou DefaultDesktopOnly e ServiceNotification.

- ou -

buttons especificou uma combinação inválida de MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem com um botão Ajuda. 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 pelo ovals palavra-chave são exibidos. O exemplo requer que o Mspaint.chm arquivo de Ajuda esteja instalado.

#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

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 pelo navigator parâmetro é exibido. O formulário que possui a caixa de mensagem (ou o formulário ativo) também recebe o HelpRequested evento.

Os arquivos de ajuda compilados fornecem um sumário, índice, pesquisa e palavra-chave links em páginas. Você pode usar os seguintes valores para navigator: TableOfContents, Find, Indexou Topic.

Você pode usar param para fornecer mais refinamento do Topic comando. Se o valor especificado no navigator parâmetro for TableOfContents, Indexou Find, esse valor deverá ser null. Se o parâmetro fizer referência Topica navigator , esse valor deverá referenciar um objeto que contém o valor numérico do tópico a ser exibido.

O helpFilePath parâmetro pode ser do formato C:\path\sample.chm ou /folder/file.htm.

Confira também

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parâmetros

owner: IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

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. Você poderá passar 0 se desejar usar os padrões.

helpFilePath: String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

O defaultButton especificado não é membro do MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

ArgumentException

options especificou DefaultDesktopOnly e ServiceNotification.

- ou -

buttons especificou uma combinação inválida de MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem que é pai do formulário de main. A caixa de mensagem exibe um botão Ajuda. Quando o usuário clica no botão Ajuda, o Mspaint.chm arquivo de Ajuda é aberto. O exemplo requer que o arquivo de Mspaint.chm Ajuda esteja instalado.

#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 (clique no teclado ou mouse) pode ocorrer, exceto para objetos no formulário modal. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada em outro formulário possa ocorrer. 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.

Quando o usuário clica no botão Ajuda, o arquivo de Ajuda especificado no helpFilePath parâmetro é aberto. O formulário que possui a caixa de mensagem (ou o formulário ativo) também recebe o HelpRequested evento.

O helpFilePath parâmetro pode ser do formato C:\path\sample.chm ou /folder/file.htm.

Confira também

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parâmetros

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

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. Você poderá passar 0 se desejar usar os padrões.

helpFilePath: String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.

navigator: HelpNavigator

Um dos valores de HelpNavigator.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

O defaultButton especificado não é membro do MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

ArgumentException

options especificou DefaultDesktopOnly e ServiceNotification.

- ou -

buttons especificou uma combinação inválida de MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem com um botão Ajuda. Quando o usuário clica no botão Ajuda, o Mspaint.chm arquivo de Ajuda é aberto e a guia Índice de Ajuda é exibida. O exemplo requer que o arquivo de Mspaint.chm Ajuda esteja instalado.

#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

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 pelo navigator parâmetro é exibido. O formulário que possui a caixa de mensagem (ou o formulário ativo) também recebe o HelpRequested evento.

Os arquivos de Ajuda compilados fornecem um sumário, índice, pesquisa e palavra-chave links em páginas. Você pode usar os seguintes valores para navigator: TableOfContents, Find, Indexou Topic.

O helpFilePath parâmetro pode ser do formato C:\path\sample.chm ou /folder/file.htm.

Confira também

Aplica-se a

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

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parâmetros

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

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. Você poderá passar 0 se desejar usar os padrões.

helpFilePath: String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.

keyword: String

A palavra-chave de Ajuda a ser exibida quando o usuário clicar no botão de Ajuda.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

O defaultButton especificado não é membro do MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

ArgumentException

options especificou DefaultDesktopOnly e ServiceNotification.

- ou -

buttons especificou uma combinação inválida de MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem com um botão Ajuda. Quando o usuário clica no botão Ajuda, o Mspaint.chm arquivo de Ajuda é aberto e o tópico identificado pelo mspaint.chm::/paint_brush.htm palavra-chave é exibido. O exemplo requer que o arquivo de Mspaint.chm Ajuda esteja instalado.

#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

Confira também

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parâmetros

owner: IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

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. Você poderá passar 0 se desejar usar os padrões.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

defaultButton não é membro de MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

ArgumentException

options especificou DefaultDesktopOnly e ServiceNotification.

- ou -

options especificou DefaultDesktopOnly ou ServiceNotification e especificou um valor no parâmetro owner. 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.

- ou -

buttons especificou uma combinação inválida de MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como exibir um MessageBox com as opções compatíveis com essa sobrecarga de Show. Depois de verificar se uma variável de cadeia de caracteres, ServerName, está vazia, o exemplo exibe um MessageBox, oferecendo ao usuário a opção de cancelar a operação. Se o Show valor retornado do método for avaliado como Yes, o formulário que exibiu o MessageBox será fechado.

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. Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (clique no teclado ou mouse) pode ocorrer, exceto para objetos no formulário modal. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada em outro formulário possa ocorrer.

Você pode ter no máximo três botões na caixa de mensagem.

Confira também

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parâmetros

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

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. Você poderá passar 0 se desejar usar os padrões.

helpFilePath: String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

O defaultButton especificado não é membro do MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

ArgumentException

options especificou DefaultDesktopOnly e ServiceNotification.

- ou -

buttons especificou uma combinação inválida de MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem com um botão Ajuda. Quando o usuário clica no botão Ajuda, o Mspaint.chm arquivo de Ajuda é aberto. O exemplo requer que o Mspaint.chm arquivo de Ajuda esteja instalado.

#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

O helpFilePath parâmetro pode ser do formulário C:\path\sample.chm ou /folder/file.htm.

Confira também

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, bool displayHelpButton);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * bool -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, displayHelpButton As Boolean) As DialogResult

Parâmetros

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

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. Você poderá passar 0 se desejar usar os padrões.

displayHelpButton: Boolean

true para mostrar o botão Ajuda; caso contrário, false. O padrão é false.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

O defaultButton especificado não é membro do MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

ArgumentException

options especificou DefaultDesktopOnly e ServiceNotification.

- ou -

buttons especificou uma combinação inválida de MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem com um botão Ajuda, manipular o Control.HelpRequested evento e mostrar uma janela de ajuda personalizada em resposta ao evento.

#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

Quando o usuário clica no botão Ajuda, o formulário que possui a caixa de mensagem (ou o formulário ativo) recebe o HelpRequested evento. Manipule o HelpRequested evento para executar ações personalizadas de Ajuda.

Confira também

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parâmetros

owner: IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

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. Você poderá passar 0 se desejar usar os padrões.

helpFilePath: String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.

navigator: HelpNavigator

Um dos valores de HelpNavigator.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

O defaultButton especificado não é membro do MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

ArgumentException

options especificou DefaultDesktopOnly e ServiceNotification.

- ou -

buttons especificou uma combinação inválida de MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem pai para a janela main. A caixa de mensagem exibe um botão Ajuda. Quando o usuário clica no botão Ajuda, o Mspaint.chm arquivo de Ajuda é aberto e a guia Índice de Ajuda é exibida. O exemplo requer que o Mspaint.chm arquivo de Ajuda esteja instalado.

#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 (clique no teclado ou mouse) pode ocorrer, exceto para objetos no formulário modal. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada em outro formulário possa ocorrer. 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.

Os arquivos de Ajuda compilados fornecem um sumário, índice, pesquisa e links de palavra-chave em páginas. Você pode usar os seguintes valores para navigator: TableOfContents, Find, Indexou Topic.

O helpFilePath parâmetro pode ser do formulário C:\path\sample.chm ou /folder/file.htm.

Confira também

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parâmetros

owner: IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

defaultButton não é membro de MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

Exemplos

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 no máximo três botões na caixa de mensagem.

Confira também

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parâmetros

owner: IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

Exemplos

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 ter no máximo três botões na caixa de mensagem.

Confira também

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parâmetros

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

defaultButton não é membro de MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

Exemplos

O exemplo de código a seguir demonstra como exibir um MessageBox com as opções compatíveis com essa sobrecarga de Show. Depois de verificar se uma variável de cadeia de caracteres, ServerName, está vazia, o exemplo exibe um MessageBox com um ícone de caixa de perguntas, oferecendo ao usuário a opção de cancelar a operação. Se o Show valor retornado do método for avaliado como Yes, o formulário que exibiu o MessageBox será fechado.

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 no máximo três botões na caixa de mensagem.

Confira também

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parâmetros

owner: IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

Exemplos

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 ter no máximo três botões na caixa de mensagem.

Confira também

MessageBoxButtons

Aplica-se a

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Exibe uma caixa de mensagem com o texto, legenda, botões e ícone especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parâmetros

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

O parâmetro buttons especificado não é membro de MessageBoxButtons.

- ou -

O parâmetro icon especificado não é membro de MessageBoxIcon.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

Exemplos

O exemplo de código a Show seguir demonstra um dos métodos ao manipular o ComboBox.DropDown evento. Para executar o exemplo, cole o código a seguir em um formulário e chame o InitializeComboBox método do construtor ou Load método do formulário.

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 no máximo três botões na caixa de mensagem.

Confira também

Aplica-se a

Show(IWin32Window, String, String)

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto e a legenda especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption);

static member Show : System.Windows.Forms.IWin32Window * string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String) As DialogResult

Parâmetros

owner: IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

Retornos

DialogResult

Um dos valores de DialogResult.

Comentários

Por padrão, a caixa de mensagem exibe um botão OK .

Aplica-se a

Show(String, String, MessageBoxButtons)

Exibe uma caixa de mensagem com o texto, a legenda os botões especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parâmetros

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

O parâmetro buttons especificado não é membro de MessageBoxButtons.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

Exemplos

O exemplo de código a seguir demonstra como exibir um MessageBox com as opções compatíveis com essa sobrecarga de Show. Depois de verificar se uma variável de cadeia de caracteres, ServerName, está vazia, o exemplo exibe um MessageBox, oferecendo ao usuário a opção de cancelar a operação. Se o Show valor retornado do método for avaliado Yescomo , o formulário que exibiu o MessageBox será fechado.

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 no máximo três botões na caixa de mensagem.

Confira também

MessageBoxButtons

Aplica-se a

Show(IWin32Window, String)

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto especificado.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text);

static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

Parâmetros

owner: IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.

text: String

O texto a ser exibido na caixa de mensagem.

Retornos

DialogResult

Um dos valores de DialogResult.

Comentários

Por padrão, a caixa de mensagem exibe um botão OK . A caixa de mensagem não contém um legenda no título.

Aplica-se a

Show(String, String)

Exibe uma caixa de mensagem com o texto e a legenda especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption);

public static System.Windows.Forms.DialogResult Show (string text, string caption);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption);

static member Show : string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String) As DialogResult

Parâmetros

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

Retornos

DialogResult

Um dos valores de DialogResult.

Comentários

Por padrão, a caixa de mensagem exibe um botão OK .

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parâmetros

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

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. Você poderá passar 0 se desejar usar os padrões.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

O defaultButton especificado não é membro do MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

ArgumentException

options especificou DefaultDesktopOnly e ServiceNotification.

- ou -

buttons especificou uma combinação inválida de MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como exibir um MessageBox com as opções compatíveis com essa sobrecarga de Show. Depois de verificar se uma variável de cadeia de caracteres, ServerName, está vazia, o exemplo exibe um MessageBox com um ícone de caixa de perguntas, oferecendo ao usuário a opção de cancelar a operação. O exemplo usa o RightAlign membro da MessageBoxOptions enumeração para alinhar o texto à borda direita da caixa de diálogo. Se o Show valor retornado do método for avaliado Yescomo , o formulário que exibiu o MessageBox será fechado.

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 no máximo três botões na caixa de mensagem.

Confira também

Aplica-se a

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.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parâmetros

owner: IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.

text: String

O texto a ser exibido na caixa de mensagem.

caption: String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons: MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

icon: MessageBoxIcon

Um dos valores MessageBoxIcon que especifica qual ícone deve ser exibido na caixa de mensagem.

defaultButton: MessageBoxDefaultButton

Um dos valores MessageBoxDefaultButton que especifica o botão padrão da caixa de mensagem.

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. Você poderá passar 0 se desejar usar os padrões.

helpFilePath: String

O caminho e o nome do arquivo de Ajuda a ser exibido quando o usuário clica no botão Ajuda.

navigator: HelpNavigator

Um dos valores de HelpNavigator.

param: Object

A ID numérica e o tópico da Ajuda a ser exibida quando o usuário clica no botão Ajuda.

Retornos

DialogResult

Um dos valores de DialogResult.

Exceções

InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

- ou -

icon não é membro de MessageBoxIcon.

- ou -

O defaultButton especificado não é membro do MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade UserInteractive.

ArgumentException

options especificou DefaultDesktopOnly e ServiceNotification.

- ou -

buttons especificou uma combinação inválida de MessageBoxButtons.

Exemplos

O exemplo de código a seguir demonstra como mostrar uma caixa de mensagem com pai para a janela main. A caixa de mensagem exibe um botão Ajuda. 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 pela ovals palavra-chave são exibidos. O exemplo requer que o arquivo de Mspaint.chm Ajuda esteja instalado.

#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 (clique no teclado ou mouse) pode ocorrer, exceto para objetos no formulário modal. O programa deve ocultar ou fechar um formulário modal (normalmente em resposta a alguma ação do usuário) antes que a entrada em outro formulário possa ocorrer. 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.

Os arquivos de ajuda compilados fornecem um sumário, índice, pesquisa e links de palavra-chave em páginas. Você pode usar os seguintes valores para navigator: TableOfContents, Find, Indexou Topic.

Você pode usar param para fornecer mais refinamento do Topic comando. Se o valor especificado no navigator parâmetro for TableOfContents, Indexou Find, esse valor deverá ser null. Se o navigator parâmetro fizer referência a Topic, esse valor deverá referenciar um objeto que contém o valor numérico do tópico a ser exibido.

O helpFilePath parâmetro pode ser do formulário C:\path\sample.chm ou /folder/file.htm.

Confira também

Aplica-se a

Compartilhar via

MessageBox.Show Método

Definição

Sobrecargas

Show(String)

Parâmetros

Retornos

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários