CommonDialog.ShowDialog Метод

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

Перегрузки

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

ShowDialog()

Исходный код:

CommonDialog.cs

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

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() = DialogResult.OK) Then
        TextBox1.ForeColor = MyDialog.Color
    End If
End Sub

Комментарии

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

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

• RunDialog(IntPtr)
• DialogResult

ShowDialog(IWin32Window)

Исходный код:

CommonDialog.cs

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

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