CommonDialog.ShowDialog Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Spustí společné dialogové okno.

Přetížení

ShowDialog()	Spustí společné dialogové okno s výchozím vlastníkem.
ShowDialog(IWin32Window)	Spustí společné dialogové okno se zadaným vlastníkem.

ShowDialog()

Spustí společné dialogové okno s výchozím vlastníkem.

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

Návraty

DialogResult

OKPokud uživatel klepněte na tlačítko OK v dialogovém okně; v opačném případě . Cancel

Příklady

Následující příklad kódu používá implementaci ColorDialogCommonDialog a ukazuje vytvoření a zobrazení dialogového okna. Tento příklad vyžaduje, aby metoda byla volána z existujícího formuláře, který má TextBox a Button .

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

Poznámky

Tato metoda implementuje RunDialog.

Viz také

• RunDialog(IntPtr)
• DialogResult

ShowDialog(IWin32Window)

Spustí společné dialogové okno se zadaným vlastníkem.

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

Parametry

owner

IWin32Window

Libovolný objekt, který implementuje IWin32Window okno nejvyšší úrovně, které bude vlastnit modální dialogové okno.

Návraty

DialogResult

OKPokud uživatel klepněte na tlačítko OK v dialogovém okně; v opačném případě . Cancel

Poznámky

Tato verze ShowDialog metody umožňuje určit konkrétní formulář nebo ovládací prvek, který bude vlastníkem zobrazeného dialogového okna. Pokud použijete verzi této metody, která nemá žádné parametry, zobrazené dialogové okno bude automaticky vlastněno aktuálně aktivním oknem vaší aplikace.