MessageBoxOptions Enumeração

Definição

Especifica opções num MessageBox.

Esta enumeração suporta uma combinação bit-a-bit dos respetivos valores membro.

public enum class MessageBoxOptions
[System.Flags]
public enum MessageBoxOptions
[<System.Flags>]
type MessageBoxOptions = 
Public Enum MessageBoxOptions
Herança
MessageBoxOptions
Atributos

Campos

Name Valor Description
DefaultDesktopOnly 131072

A caixa de mensagem é exibida no ambiente de trabalho ativo. Esta constante é semelhante a ServiceNotification, exceto que o sistema exibe a caixa de mensagens apenas no ambiente de trabalho padrão da estação de janela interativa. A aplicação que mostrava a caixa de mensagem perde o foco, e a caixa de mensagem é exibida sem usar estilos visuais. Para mais informações, consulte Controlos de Renderização com Estilos Visuais.

RightAlign 524288

O texto da caixa de mensagem está alinhado à direita.

RtlReading 1048576

Especifica que o texto da caixa de mensagem é apresentado com a ordem de leitura da direita para a esquerda.

ServiceNotification 2097152

A caixa de mensagem é exibida no ambiente de trabalho ativo. O chamador é um serviço que notifica o utilizador de um evento. Show Mostra uma caixa de mensagem no ambiente de trabalho ativo atual, mesmo que não haja utilizador ligado ao computador.

Exemplos

O exemplo seguinte demonstra como mostrar a MessageBox com as opções suportadas pelas sobrecargas de MessageBox.Show que incluem um options parâmetro. Após verificar se uma variável de string, ServerName, está vazia, o exemplo mostra a MessageBox com um ícone de caixa de perguntas, oferecendo ao utilizador a opção de cancelar a operação. O exemplo usa o MessageBoxOptions.RightAlign membro enumeração para alinhar o texto com a borda direita da caixa de diálogo. Se o Show valor de retorno do método for avaliado para DialogResult.Yes, o formulário que mostrou o MessageBox está fechado.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Observações

Esta enumeração é usada pela MessageBox turma.

Se não quiser especificar um argumento ao chamar métodos em MessageBox, pode passar 0 em vez disso.

Aplica-se a