MessageBoxOptions Enumeração

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Especifica opções em um MessageBox.

Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.

public enum class MessageBoxOptions

[System.Flags]
public enum MessageBoxOptions

[<System.Flags>]
type MessageBoxOptions = 

Public Enum MessageBoxOptions

Herança

Object

ValueType

Enum

MessageBoxOptions

Atributos

FlagsAttribute

Campos

DefaultDesktopOnly	131072	A caixa de mensagem é exibida na área de trabalho ativa. Essa constante é semelhante a ServiceNotification, exceto que o sistema exibe a caixa de mensagem somente na área de trabalho padrão da estação de janela interativa. O aplicativo que exibiu a caixa de mensagem perde o foco, e a caixa de mensagem é exibida sem o uso de estilos visuais. Para obter mais informações, consulte Renderizando controles com estilos visuais.
RightAlign	524288	O texto da caixa de mensagem é alinhado à direita.
RtlReading	1048576	Especifica que o texto da caixa de mensagem deve ser exibido no sentido de leitura da direita para a esquerda.
ServiceNotification	2097152	A caixa de mensagem é exibida na área de trabalho ativa. O chamador é um serviço que notifica o usuário sobre um evento. Show exibe uma caixa de mensagem na área de trabalho ativa atual, mesmo se nenhum usuário entrar no computador.

Exemplos

O exemplo a seguir demonstra como exibir um MessageBox com as opções compatíveis com as sobrecargas que MessageBox.Show incluem um options parâmetro . Depois de verificar se uma variável de cadeia de caracteres, ServerName, está vazia, o exemplo exibe um MessageBox com um ícone de caixa de perguntas, oferecendo ao usuário a opção de cancelar a operação. O exemplo usa o MessageBoxOptions.RightAlign membro de enumeração para alinhar o texto à borda direita da caixa de diálogo. Se o Show valor retornado do método for avaliado como DialogResult.Yes, o formulário que exibiu o MessageBox será 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

Comentários

Essa enumeração é usada pela classe de MessageBox .

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