CommonDialog.ShowDialog Méthode

Définition

Exécute une boîte de dialogue commune.Runs a common dialog box.

Surcharges

ShowDialog()

Exécute une boîte de dialogue commune avec un propriétaire par défaut.Runs a common dialog box with a default owner.

ShowDialog(IWin32Window)

Exécute une boîte de dialogue commune avec le propriétaire spécifié.Runs a common dialog box with the specified owner.

ShowDialog()

Exécute une boîte de dialogue commune avec un propriétaire par défaut.Runs a common dialog box with a default owner.

public:
 System::Windows::Forms::DialogResult ShowDialog();
public System.Windows.Forms.DialogResult ShowDialog ();
member this.ShowDialog : unit -> System.Windows.Forms.DialogResult
Public Function ShowDialog () As DialogResult

Retours

DialogResult

OK si l'utilisateur clique sur OK dans la boîte de dialogue ; sinon, Cancel.OK if the user clicks OK in the dialog box; otherwise, Cancel.

Exemples

L’exemple de code suivant utilise l' ColorDialog implémentation de CommonDialog et illustre la création et l’utilisation d’une boîte de dialogue.The following code example uses the ColorDialog implementation of CommonDialog and illustrates creating and showing a dialog box. Cet exemple requiert que la méthode soit appelée à partir d’un formulaire existant, avec un TextBox et Button placé sur celui-ci.This example requires that the method is called from within an existing form, which has a TextBox and Button placed on it.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      ColorDialog^ MyDialog = gcnew ColorDialog;
      // Keeps the user from selecting a custom color.
      MyDialog->AllowFullOpen = false;
      // Allows the user to get help. (The default is false.)
      MyDialog->ShowHelp = true;
      // Sets the initial color select to the current text color.
      MyDialog->Color = textBox1->ForeColor;
      
      // Update the text box color if the user clicks OK 
      if ( MyDialog->ShowDialog() == ::System::Windows::Forms::DialogResult::OK )
      {
         textBox1->ForeColor = MyDialog->Color;
      }
   }
private void button1_Click(object sender, System.EventArgs e)
 {
    ColorDialog MyDialog = new ColorDialog();
    // Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = false ;
    // Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = true ;
    // Sets the initial color select to the current text color.
    MyDialog.Color = textBox1.ForeColor ;
    
    // Update the text box color if the user clicks OK 
    if (MyDialog.ShowDialog() == DialogResult.OK)
        textBox1.ForeColor =  MyDialog.Color;
 }
    
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
    Dim MyDialog As New ColorDialog()
    ' Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = False
    ' Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = True
    ' Sets the initial color select to the current text color,
    MyDialog.Color = TextBox1.ForeColor

    ' Update the text box color if the user clicks OK 
    If (MyDialog.ShowDialog() = Windows.Forms.DialogResult.OK) Then
        TextBox1.ForeColor = MyDialog.Color
    End If
End Sub

Remarques

Cette méthode implémente RunDialog.This method implements RunDialog.

Voir aussi

S’applique à

ShowDialog(IWin32Window)

Exécute une boîte de dialogue commune avec le propriétaire spécifié.Runs a common dialog box with the specified owner.

public:
 System::Windows::Forms::DialogResult ShowDialog(System::Windows::Forms::IWin32Window ^ owner);
public System.Windows.Forms.DialogResult ShowDialog (System.Windows.Forms.IWin32Window owner);
member this.ShowDialog : System.Windows.Forms.IWin32Window -> System.Windows.Forms.DialogResult
Public Function ShowDialog (owner As IWin32Window) As DialogResult

Paramètres

owner
IWin32Window

Tout objet qui implémente IWin32Window et représente la fenêtre de niveau supérieur à laquelle va appartenir la boîte de dialogue modale.Any object that implements IWin32Window that represents the top-level window that will own the modal dialog box.

Retours

DialogResult

OK si l’utilisateur clique sur OK dans la boîte de dialogue ; sinon, Cancel.OK if the user clicks OK in the dialog box; otherwise, Cancel.

Remarques

Cette version de la ShowDialog méthode vous permet de spécifier un formulaire ou un contrôle spécifique qui possédera la boîte de dialogue qui s’affiche.This version of the ShowDialog method allows you to specify a specific form or control that will own the dialog box that is shown. Si vous utilisez la version de cette méthode qui n’a aucun paramètre, la boîte de dialogue qui s’affiche est automatiquement détenue par la fenêtre actuellement active de votre application.If you use the version of this method that has no parameters, the dialog box being shown would be owned automatically by the currently active window of your application.

S’applique à