CommonDialog.ShowDialog Metod

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll

Kör en gemensam dialogruta.

Överlagringar

Name Description
ShowDialog()

Kör en gemensam dialogruta med en standardägare.
ShowDialog(IWin32Window)

Kör en gemensam dialogruta med den angivna ägaren.

ShowDialog()

Källa:
CommonDialog.cs
Källa:
CommonDialog.cs
Källa:
CommonDialog.cs
Källa:
CommonDialog.cs
Källa:
CommonDialog.cs

Kör en gemensam dialogruta med en standardägare.

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

Returer

DialogResult

OKom användaren klickar på OK i dialogrutan; annars . Cancel

Exempel

I följande kodexempel används implementeringen ColorDialog av CommonDialog och illustrerar hur du skapar och visar en dialogruta. Det här exemplet kräver att metoden anropas inifrån ett befintligt formulär, som har en TextBox och Button placeras på den.

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

Kommentarer

Den här metoden implementerar RunDialog.

Se även

Gäller för

ShowDialog(IWin32Window)

Källa:
CommonDialog.cs
Källa:
CommonDialog.cs
Källa:
CommonDialog.cs
Källa:
CommonDialog.cs
Källa:
CommonDialog.cs

Kör en gemensam dialogruta med den angivna ägaren.

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

Parametrar

owner
IWin32Window

Alla objekt som implementerar IWin32Window som representerar det översta fönstret som äger den modala dialogrutan.

Returer

DialogResult

OKom användaren klickar på OK i dialogrutan; annars . Cancel

Kommentarer

Med den ShowDialog här versionen av metoden kan du ange ett visst formulär eller en kontroll som äger dialogrutan som visas. Om du använder den version av den här metoden som inte har några parametrar ägs dialogrutan som visas automatiskt av programmets aktiva fönster.

Gäller för