MessageBoxIcon Enumeração

Definição

Especifica constantes que definem qual a informação a exibir.

public enum class MessageBoxIcon
public enum MessageBoxIcon
type MessageBoxIcon = 
Public Enum MessageBoxIcon
Herança
MessageBoxIcon

Campos

Name Valor Description
None 0

A caixa de mensagem não contém símbolos.

Error 16

A caixa de mensagem contém um símbolo composto por um X branco num círculo com fundo vermelho.

Hand 16

A caixa de mensagem contém um símbolo composto por um X branco num círculo com fundo vermelho.

Stop 16

A caixa de mensagem contém um símbolo composto por um X branco num círculo com fundo vermelho.

Question 32

A caixa de mensagem contém um símbolo composto por um ponto de interrogação num círculo. O ícone de mensagem com ponto de interrogação já não é recomendado porque não representa claramente um tipo específico de mensagem e porque a formulação de uma mensagem como pergunta pode aplicar-se a qualquer tipo de mensagem. Além disso, os utilizadores podem confundir o símbolo de ponto de interrogação com um símbolo de informação de ajuda. Por isso, não use este símbolo de ponto de interrogação nas suas caixas de mensagem. O sistema continua a suportar a sua inclusão apenas para compatibilidade retroativa.

Exclamation 48

A caixa de mensagem contém um símbolo composto por um ponto de exclamação num triângulo com fundo amarelo.

Warning 48

A caixa de mensagem contém um símbolo composto por um ponto de exclamação num triângulo com fundo amarelo.

Asterisk 64

A caixa de mensagem contém um símbolo composto por uma letra minúscula i num círculo.

Information 64

A caixa de mensagem contém um símbolo composto por uma letra minúscula i num círculo.

Exemplos

O exemplo de código seguinte mostra como usar a MessageBox para informar o utilizador de uma entrada em falta num TextBox. Este exemplo exige que o método seja chamado a partir de uma forma existente com a Button e a TextBox sobre ela.

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 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

Observações

Esta enumeração é usada pela MessageBox turma. A descrição de cada membro desta enumeração contém uma representação típica do símbolo. O gráfico real apresentado é uma função das constantes do sistema operativo. Nas implementações atuais, existem quatro símbolos únicos com múltiplos valores atribuídos.

A tabela seguinte mostra os diferentes ícones das caixas de mensagem.

Icon Name
X branco em círculo vermelho X Mão
Ponto de interrogação branco em círculo azul Pergunta
Ponto de exclamação preto no triângulo amarelo Exclamação
Branco minúsculo i em círculo azul Asterisco
X branco em círculo vermelho X Parar
X branco em círculo vermelho X Erro
Ponto de exclamação preto no triângulo amarelo Warning
Branco minúsculo i em círculo azul Informação

Aplica-se a