MessageBoxOptions Énumération

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

MessageBoxOptions.cs

Spécifie les options de MessageBox.

Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.

public enum class MessageBoxOptions

[System.Flags]
public enum MessageBoxOptions

[<System.Flags>]
type MessageBoxOptions = 

Public Enum MessageBoxOptions

Héritage

Object

ValueType

Enum

MessageBoxOptions

Attributs

FlagsAttribute

Champs

Nom	Valeur	Description
DefaultDesktopOnly	131072	La boîte de message est affichée sur Active Desktop. Cette constante est similaire à ServiceNotification, sauf que le système affiche la boîte de message uniquement sur le bureau par défaut de la station Windows interactive. L’application qui affiche la boîte de message perd le focus et la boîte de message s’affiche sans l’aide de styles visuels. Pour plus d’informations, consultez Rendu des contrôles avec les styles visuels.
RightAlign	524288	Le texte de la boîte de message est aligné sur la droite.
RtlReading	1048576	Spécifie que le texte de la boîte de message est affiché pour une lecture de droite à gauche.
ServiceNotification	2097152	La boîte de message est affichée sur Active Desktop. L’appelant est un service qui avertit l’utilisateur d’un événement. Show affiche une boîte de message sur le bureau actif, même si aucun utilisateur n'a ouvert de session sur l'ordinateur.

Exemples

L’exemple suivant montre comment afficher un MessageBox avec les options prises en charge par les surcharges de MessageBox.Show qui incluent un options paramètre. Après avoir vérifié qu’une variable de chaîne, ServerName, est vide, l’exemple affiche une MessageBox icône avec une zone de question, offrant à l’utilisateur la possibilité d’annuler l’opération. L’exemple utilise le membre d’énumération MessageBoxOptions.RightAlign pour aligner le texte sur le bord droit de la boîte de dialogue. Si la valeur de retour de la Show méthode est évaluée à DialogResult.Yes, le formulaire qui a affiché est MessageBox fermé.

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

Remarques

Cette énumération est utilisée par la classe MessageBox.

Si vous ne souhaitez pas spécifier d’argument lors de l’appel de méthodes sur MessageBox, vous pouvez passer 0 à la place.