MessageBoxIcon Enumeração

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.

Especifica constantes que definem quais informações devem ser exibidas.

public enum class MessageBoxIcon

public enum MessageBoxIcon

type MessageBoxIcon =

Public Enum MessageBoxIcon

Herança: Object

ValueType

Enum
MessageBoxIcon

Campos

Asterisk	64	A caixa de mensagem contém um símbolo que consiste em uma letra i minúscula dentro de um círculo.
Error	16	A caixa de mensagem contém um símbolo que consiste em um X branco dentro de um círculo com fundo vermelho.
Exclamation	48	A caixa de mensagem contém um símbolo que consiste em um ponto de exclamação dentro de um triângulo com fundo amarelo.
Hand	16	A caixa de mensagem contém um símbolo que consiste em um X branco dentro de um círculo com fundo vermelho.
Information	64	A caixa de mensagem contém um símbolo que consiste em uma letra i minúscula dentro de um círculo.
None	0	A caixa de mensagem não contém símbolos.
Question	32	A caixa de mensagem contém um símbolo que consiste em um ponto de interrogação dentro de um círculo. O ícone de mensagem de ponto de interrogação não é recomendado porque não representa claramente um tipo específico de mensagem e porque a elaboração de uma mensagem em formato de pergunta pode se aplicar a qualquer tipo de mensagem. Além disso, os usuários podem confundir o símbolo de ponto de interrogação com um símbolo de informações da Ajuda. Portanto, não use esse símbolo de ponto de interrogação em suas caixas de mensagem. O sistema continua dando suporte à sua inclusão somente por questão de compatibilidade com versões anteriores.
Stop	16	A caixa de mensagem contém um símbolo que consiste em um X branco dentro de um círculo com fundo vermelho.
Warning	48	A caixa de mensagem contém um símbolo que consiste em um ponto de exclamação dentro de um triângulo com fundo amarelo.

Exemplos

O exemplo de código a seguir mostra como usar um MessageBox para informar o usuário de uma entrada ausente em um TextBox. Este exemplo requer que o método seja chamado de um formulário existente com um Button e um TextBox nele.

private void Form1_FormClosing(object sender, FormClosingEventArgs e)  
{  
    const string message =  
        "Are you sure that you would like to close the form?";  
    const string caption = "Form Closing";  
    var result = MessageBox.Show(message, caption,  
                                 MessageBoxButtons.YesNo,  
                                 MessageBoxIcon.Exclamation);  

    // If the no button was pressed ...  
    if (result == DialogResult.No)  
    {  
        // cancel the closure of the form.  
        e.Cancel = true;  
    }  
}

private:  
   void Form1_FormClosing(Object^ sender, FormClosingEventArgs^ e)  
   {  
      // If the no button was pressed ...  
      if ((MessageBox::Show(  
         "Are you sure that you would like to close the form?",   
         "Form Closing", MessageBoxButtons::YesNo,   
         MessageBoxIcon::Exclamation) == DialogResult::No))  
      {  
         // cancel the closure of the form.  
         e->Cancel = true;  
      }  
   }

Private Sub Form1_FormClosing( _  
    ByVal sender As System.Object, _  
    ByVal e As System.Windows.Forms.FormClosingEventArgs) _  
    Handles MyBase.FormClosing  

    Dim message As String = _  
            "Are you sure that you would like to close the form?"  
    Dim caption As String = "Form Closing"  
    Dim result = MessageBox.Show(message, caption, _  
                                 MessageBoxButtons.YesNo, _  
                                 MessageBoxIcon.Exclamation)  

    ' If the no button was pressed ...  
    If (result = DialogResult.No) Then  
        ' cancel the closure of the form.  
        e.Cancel = True  
    End If  
End Sub

Comentários

Essa enumeração é usada pela classe de MessageBox . A descrição de cada membro dessa enumeração contém uma representação típica do símbolo. O gráfico real exibido é uma função das constantes do sistema operacional. Nas implementações atuais, há quatro símbolos exclusivos com vários valores atribuídos a eles.

A tabela a seguir mostra os diferentes ícones da caixa de mensagem.