CommonDialog.ShowDialog Methode

Definitie

Naamruimte:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Hiermee wordt een algemeen dialoogvenster uitgevoerd.

Overloads

Name Description
ShowDialog()

Hiermee wordt een algemeen dialoogvenster met een standaardeigenaar uitgevoerd.
ShowDialog(IWin32Window)

Hiermee wordt een algemeen dialoogvenster met de opgegeven eigenaar uitgevoerd.

ShowDialog()

Bron:
CommonDialog.cs
Bron:
CommonDialog.cs
Bron:
CommonDialog.cs
Bron:
CommonDialog.cs
Bron:
CommonDialog.cs

Hiermee wordt een algemeen dialoogvenster met een standaardeigenaar uitgevoerd.

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

Retouren

DialogResult

OK als de gebruiker in het dialoogvenster op OK klikt; anders, Cancel.

Voorbeelden

Het volgende codevoorbeeld maakt gebruik van de implementatie van ColorDialog en illustreert het CommonDialog maken en weergeven van een dialoogvenster. In dit voorbeeld is vereist dat de methode wordt aangeroepen vanuit een bestaand formulier, dat een TextBox en Button geplaatst formulier bevat.

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() = DialogResult.OK) Then
        TextBox1.ForeColor = MyDialog.Color
    End If
End Sub

Opmerkingen

Met deze methode wordt geïmplementeerd RunDialog.

Zie ook

Van toepassing op

ShowDialog(IWin32Window)

Bron:
CommonDialog.cs
Bron:
CommonDialog.cs
Bron:
CommonDialog.cs
Bron:
CommonDialog.cs
Bron:
CommonDialog.cs

Hiermee wordt een algemeen dialoogvenster met de opgegeven eigenaar uitgevoerd.

public:
 System::Windows::Forms::DialogResult ShowDialog(System::Windows::Forms::IWin32Window ^ 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

Parameters

owner
IWin32Window

Elk object dat wordt geïmplementeerd IWin32Window voor het venster op het hoogste niveau dat eigenaar is van het modale dialoogvenster.

Retouren

DialogResult

OK als de gebruiker in het dialoogvenster op OK klikt; anders, Cancel.

Opmerkingen

Met deze versie van de ShowDialog methode kunt u een specifiek formulier of besturingselement opgeven dat eigenaar is van het dialoogvenster dat wordt weergegeven. Als u de versie van deze methode gebruikt die geen parameters bevat, is het dialoogvenster dat wordt weergegeven automatisch eigendom van het momenteel actieve venster van uw toepassing.

Van toepassing op