CommonDialog.ShowDialog Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Запускает общее диалоговое окно.

Перегрузки

ShowDialog()	Запускает общее диалоговое окно с заданным по умолчанию владельцем.
ShowDialog(IWin32Window)	Запускает общее диалоговое окно с указанным владельцем.

ShowDialog()

Запускает общее диалоговое окно с заданным по умолчанию владельцем.

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

Возвращаемое значение

DialogResult

Объект OK, если пользователь нажимает кнопку ОК в диалоговом окне; в противном случае — объект Cancel.

Примеры

В следующем примере кода используется ColorDialog реализация CommonDialog иллюстрируется создание и отображение диалогового окна. В этом примере требуется, чтобы метод был вызван из существующей формы, которая содержит TextBox и 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

Комментарии

Этот метод реализует RunDialog.

См. также раздел

• RunDialog(IntPtr)
• DialogResult

ShowDialog(IWin32Window)

Запускает общее диалоговое окно с указанным владельцем.

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

Параметры

owner

IWin32Window

Любой объект, который реализует IWin32Window, представляющий окно верхнего уровня, которое станет владельцем модального диалогового окна.

Возвращаемое значение

DialogResult

Значение OK, если пользователь нажимает кнопку ОК в диалоговом окне; в противном случае значение Cancel.

Комментарии

Эта версия ShowDialog метода позволяет указать определенную форму или элемент управления, которым будет принадлежать отображаемое диалоговое окно. Если вы используете версию этого метода без параметров, отображаемое диалоговое окно будет автоматически принадлежать активному окну приложения.