Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método MessageBox.Show (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

.NET Framework (current version)
 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

C#
C++
F#
VB
Copiar 
public static DialogResult Show(
	IWin32Window owner,
	string text,
	string caption,
	MessageBoxButtons buttons,
	MessageBoxIcon icon,
	MessageBoxDefaultButton defaultButton,
	MessageBoxOptions options,
	string helpFilePath,
	HelpNavigator navigator
)

Parâmetros

owner
Type: System.Windows.Forms.IWin32Window

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

text
Type: System.String

O texto a ser exibido na caixa de mensagem.

caption
Type: System.String

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

buttons
Type: System.Windows.Forms.MessageBoxButtons

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

icon
Type: System.Windows.Forms.MessageBoxIcon

Uma da MessageBoxIcon valores que especifica qual ícone será exibido na caixa de mensagem.

defaultButton
Type: System.Windows.Forms.MessageBoxDefaultButton

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

options
Type: System.Windows.Forms.MessageBoxOptions

Uma da MessageBoxOptions valores que especifica quais opções de exibição e associação serão usadas para a caixa de mensagem. Você pode passar 0 se você quiser usar os padrões.

helpFilePath
Type: System.String

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

navigator
Type: System.Windows.Forms.HelpNavigator

Um dos valores de HelpNavigator.

Valor Retornado

Type: System.Windows.Forms.DialogResult

Um dos valores de DialogResult.

Exception Condition
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 SystemInformation.UserInteractive.

ArgumentException

optionsespecificado ambos DefaultDesktopOnly e ServiceNotification.

-ou-

buttonsespecificada uma combinação inválida de MessageBoxButtons.

Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (clique de mouse ou teclado) pode ocorrer exceto para objetos no formulário modal. O programa deve ocultar ou fechar um formulário restrito (normalmente em resposta a uma ação do usuário) antes de entrada para outra forma pode ocorrer. Você pode usar o owner parâmetro para especificar um determinado objeto que implementa o 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 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 a HelpRequested eventos.

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

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

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

C#
C++
VB
Copiar 
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
C#
C++
VB
Copiar 
// 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);

UIPermission

for safe subwindows to call this method. Associated enumeration: F:System.Security.Permissions.UIPermissionWindow.SafeSubWindows

WebPermission

to access a HTML help file through a HTTP request. Associated enumeration: F:System.Net.NetworkAccess.Connect

SecurityPermission

to access a HTML help file not served from a HTTP server. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode

UIPermission

for safe subwindows to call this method. Associated enumeration: F:System.Security.Permissions.UIPermissionWindow.SafeSubWindows

.NET Framework
Disponível desde 2.0
Retornar ao início
Mostrar: