CommonDialog.ShowDialog Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Uruchamia typowe okno dialogowe.

Przeciążenia

ShowDialog()	Uruchamia typowe okno dialogowe z domyślnym właścicielem.
ShowDialog(IWin32Window)	Uruchamia typowe okno dialogowe z określonym właścicielem.

ShowDialog()

Uruchamia typowe okno dialogowe z domyślnym właścicielem.

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

Zwraca

DialogResult

OK jeśli użytkownik kliknie przycisk OK w oknie dialogowym; w przeciwnym razie , Cancel.

Przykłady

Poniższy przykład kodu używa ColorDialog implementacji CommonDialog i ilustruje tworzenie i wyświetlanie okna dialogowego. Ten przykład wymaga, aby metoda została wywołana z poziomu istniejącego formularza, który ma TextBox obiekt i Button umieszczony na nim.

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

Uwagi

Ta metoda implementuje metodę RunDialog.

Zobacz też

• RunDialog(IntPtr)
• DialogResult

ShowDialog(IWin32Window)

Uruchamia typowe okno dialogowe z określonym właścicielem.

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

Parametry

owner

IWin32Window

Każdy obiekt, który implementuje IWin32Window okno najwyższego poziomu, które będzie właścicielem modalnego okna dialogowego.

Zwraca

DialogResult

OK jeśli użytkownik kliknie przycisk OK w oknie dialogowym; w przeciwnym razie , Cancel.

Uwagi

Ta wersja ShowDialog metody umożliwia określenie określonego formularza lub kontrolki, która będzie właścicielem wyświetlanego okna dialogowego. Jeśli używasz wersji tej metody, która nie ma parametrów, wyświetlane okno dialogowe będzie automatycznie własnością aktualnie aktywnego okna aplikacji.