CommonDialog.ShowDialog Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Egy közös párbeszédpanelt futtat.

Túlterhelések

Name	Description
ShowDialog()	Egy általános párbeszédpanelt futtat egy alapértelmezett tulajdonossal.
ShowDialog(IWin32Window)	Futtat egy közös párbeszédpanelt a megadott tulajdonossal.

ShowDialog()

Egy általános párbeszédpanelt futtat egy alapértelmezett tulajdonossal.

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

Válaszok

DialogResult

OKha a felhasználó az OK gombra kattint a párbeszédpanelen; egyéb esetben. Cancel

Példák

Az alábbi példakód egy ColorDialog párbeszédpanel létrehozását és megjelenítését szemlélteti CommonDialog . Ez a példa megköveteli, hogy a metódus egy meglévő űrlapon belülről legyen meghívva, amely rendelkezik egy TextBox és Button rá helyezett formában.

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

Megjegyzések

Ez a metódus implementálja a RunDialog.

Lásd még

• RunDialog(IntPtr)
• DialogResult

ShowDialog(IWin32Window)

Futtat egy közös párbeszédpanelt a megadott tulajdonossal.

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éterek

owner

IWin32Window

Minden olyan objektum, amely a IWin32Window modális párbeszédpanelt tartalmazó legfelső szintű ablakot jelöli.

Válaszok

DialogResult

OKha a felhasználó az OK gombra kattint a párbeszédpanelen; egyéb esetben. Cancel

Megjegyzések

A metódus ezen verziója ShowDialog lehetővé teszi egy adott űrlap vagy vezérlőelem megadását, amely a megjelenő párbeszédpanel tulajdonosa lesz. Ha a metódus olyan verzióját használja, amely nem rendelkezik paraméterekkel, a megjelenő párbeszédpanel automatikusan az alkalmazás aktuálisan aktív ablaka tulajdonában lesz.