MessageBoxOptions Enumeração

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Origem:: MessageBoxOptions.cs

Origem:: MessageBoxOptions.cs

Origem:: MessageBoxOptions.cs

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

Nome	Valor	Description
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 de MessageBox.Show que 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 DialogResult.Yescomo , 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.

Aplica-se a

Produto	Versões
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Compartilhar via