Exportar (0) Imprimir
Expandir Tudo
Expandir Minimizar
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
0 de 1 pessoas classificaram isso como útil - Avalie este tópico

Método MessageBox.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.

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

Parâmetros

text
Tipo: System.String
O texto será exibido na caixa de mensagem.
caption
Tipo: System.String
O texto será exibido na barra de título da caixa de mensagem.
buttons
Tipo: System.Windows.Forms.MessageBoxButtons
Dentre as MessageBoxButtons valores que especifica quais botões serão exibidos na caixa de mensagem.
icon
Tipo: System.Windows.Forms.MessageBoxIcon
Dentre as MessageBoxIcon valores que especifica qual ícone será exibido na caixa de mensagem.
defaultButton
Tipo: System.Windows.Forms.MessageBoxDefaultButton
Dentre as MessageBoxDefaultButton valores que especifica o botão padrão para a caixa de mensagem.
options
Tipo: System.Windows.Forms.MessageBoxOptions
Dentre as MessageBoxOptions valores que especifica quais opções de exibição e a associação serão usadas para a caixa de mensagem. Você pode passar 0 se desejar usar os padrões.
displayHelpButton
Tipo: System.Boolean
true para mostrar o botão de ajuda; Caso contrário, false. O padrão é false.

Valor de retorno

Tipo: System.Windows.Forms.DialogResult
Dentre as DialogResult valores.
ExceçãoCondição
InvalidEnumArgumentException

buttonsnão é um membro do MessageBoxButtons.

- ou -

iconnão é um membro do MessageBoxIcon.

- ou -

O defaultButton especificado não é um membro do MessageBoxDefaultButton.

InvalidOperationException

Foi feita uma tentativa para exibir o MessageBox em um processo que não está sendo executado no modo usuário interativo. Isso é especificado pelo SystemInformation.UserInteractive propriedade.

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

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. Lidar com o HelpRequested evento para executar ações personalizadas de Ajuda.

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


using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;


...


// 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;
}


.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.
Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft. Todos os direitos reservados.