CommonDialog.ShowDialog CommonDialog.ShowDialog CommonDialog.ShowDialog CommonDialog.ShowDialog Method

定義

コモン ダイアログ ボックスを実行します。Runs a common dialog box.

オーバーロード

ShowDialog() ShowDialog() ShowDialog() ShowDialog()

既定のオーナーを使用してコモン ダイアログ ボックスを実行します。Runs a common dialog box with a default owner.

ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window)

指定したオーナーを使用してコモン ダイアログ ボックスを実行します。Runs a common dialog box with the specified owner.

ShowDialog() ShowDialog() ShowDialog() ShowDialog()

既定のオーナーを使用してコモン ダイアログ ボックスを実行します。Runs a common dialog box with a default owner.

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

戻り値

ユーザーがダイアログ ボックスの [OK] をクリックした場合は OK。それ以外の場合は CancelOK if the user clicks OK in the dialog box; otherwise, Cancel.

次のコード例ではColorDialog 、のCommonDialog実装を使用して、ダイアログボックスの作成と表示を示します。The following code example uses the ColorDialog implementation of CommonDialog and illustrates creating and showing a dialog box. この例では、既存のフォーム内からメソッドを呼び出す必要がありTextBoxますButton 。このフォームにはが含まれ、が配置されています。This example requires that the method is called from within an existing form, which has a TextBox and Button placed on it.

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 を実装します。This method implements RunDialog.

セキュリティ

PrintingPermission
から印刷する場合PrintDialogは。to print from a PrintDialog. 関連付けられた列挙型:SafePrintingAssociated enumeration: SafePrinting

UIPermission
セーフサブウィンドウがこのメソッドを呼び出すために使用します。for safe subwindows to call this method. 関連付けられた列挙型:SafeSubWindowsAssociated enumeration: SafeSubWindows

こちらもご覧ください

ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window)

指定したオーナーを使用してコモン ダイアログ ボックスを実行します。Runs a common dialog box with the specified 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 IWin32Window IWin32Window

モーダル ダイアログ ボックスを所有するトップレベル ウィンドウを表す IWin32Window を実装しているオブジェクト。Any object that implements IWin32Window that represents the top-level window that will own the modal dialog box.

戻り値

ユーザーがダイアログ ボックスの [OK] をクリックした場合は OK。それ以外の場合は CancelOK if the user clicks OK in the dialog box; otherwise, Cancel.

注釈

このバージョンのShowDialogメソッドでは、表示されているダイアログボックスを所有する特定のフォームまたはコントロールを指定できます。This version of the ShowDialog method allows you to specify a specific form or control that will own the dialog box that is shown. このメソッドのうち、パラメーターを持たないバージョンを使用する場合、表示されるダイアログボックスは、アプリケーションの現在アクティブなウィンドウによって自動的に所有されます。If you use the version of this method that has no parameters, the dialog box being shown would be owned automatically by the currently active window of your application.

セキュリティ

PrintingPermission
から印刷する場合PrintDialogは。to print from a PrintDialog. 関連付けられた列挙型:SafePrintingAssociated enumeration: SafePrinting

UIPermission
セーフサブウィンドウがこのメソッドを呼び出すために使用します。for safe subwindows to call this method. 関連付けられた列挙型:SafeSubWindowsAssociated enumeration: SafeSubWindows

適用対象