Compartilhar via


MessageBoxIcon Enumeração

Definição

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

public enum class MessageBoxIcon
public enum MessageBoxIcon
type MessageBoxIcon = 
Public Enum MessageBoxIcon
Herança
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.

ícone Nome
X branco em círculo vermelho Mão
Ponto de interrogação branco em círculo azul Pergunta
Ponto de exclamação preto no triângulo amarelo Exclamação
"i" minúsculo branco em círculo azul Asterisco
X branco em círculo vermelho Stop
X branco em círculo vermelho Erro
Ponto de exclamação preto no triângulo amarelo Aviso
"i" minúsculo branco em círculo azul Informações

Aplica-se a