CommonDialog クラス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

ダイアログ ボックスを画面に表示するために使用する基本クラスを指定します。

public ref class CommonDialog abstract : System::ComponentModel::Component
public abstract class CommonDialog : System.ComponentModel.Component
type CommonDialog = class
    inherit Component
Public MustInherit Class CommonDialog
Inherits Component
継承
Object
MarshalByRefObject
Component
CommonDialog
派生

例

次のコード例では、CommonDialogのColorDialog実装を使用し、ダイアログ ボックスの作成と表示を示します。 この例では、メソッドが既存のフォーム内から呼び出され、 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

注釈

継承されたクラスは、特定の共通ダイアログ ボックスを作成するためにShowDialogを呼び出してRunDialogを実装するために必要です。 継承されたクラスは、必要に応じて HookProc をオーバーライドして、特定のダイアログ ボックス フック機能を実装できます。

コンストラクター

名前 説明
CommonDialog()

CommonDialog クラスの新しいインスタンスを初期化します。

プロパティ

名前 説明
CanRaiseEvents

コンポーネントがイベントを発生できるかどうかを示す値を取得します。

(継承元 Component)
Container

IContainerを含むComponentを取得します。

(継承元 Component)
DesignMode

Componentが現在デザイン モードであるかどうかを示す値を取得します。

(継承元 Component)
Events

この Componentにアタッチされているイベント ハンドラーの一覧を取得します。

(継承元 Component)
Site

ISiteのComponentを取得または設定します。

(継承元 Component)
Tag

コントロールに関するデータを含むオブジェクトを取得または設定します。

メソッド

名前 説明
CreateObjRef(Type)

リモート オブジェクトとの通信に使用されるプロキシの生成に必要なすべての関連情報を含むオブジェクトを作成します。

(継承元 MarshalByRefObject)
Dispose()

Componentによって使用されるすべてのリソースを解放します。

(継承元 Component)
Dispose(Boolean)

Componentによって使用されるアンマネージ リソースを解放し、必要に応じてマネージド リソースを解放します。

(継承元 Component)
Equals(Object)

指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetLifetimeService()

このインスタンスの有効期間ポリシーを制御する現在の有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
GetService(Type)

ComponentまたはそのContainerによって提供されるサービスを表すオブジェクトを返します。

(継承元 Component)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

共通ダイアログ ボックスに特定の機能を追加するためにオーバーライドされる共通ダイアログ ボックス フック プロシージャを定義します。
InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Objectの簡易コピーを作成します。

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。

(継承元 MarshalByRefObject)
OnHelpRequest(EventArgs)

HelpRequest イベントを発生させます。
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)

共通のダイアログ ボックスに特定の機能を追加するためにオーバーライドされる所有者ウィンドウ プロシージャを定義します。
Reset()

派生クラスでオーバーライドされると、共通ダイアログ ボックスのプロパティを既定値にリセットします。
RunDialog(IntPtr)

派生クラスでオーバーライドされた場合は、共通のダイアログ ボックスを指定します。
ShowDialog()

既定の所有者を持つ共通のダイアログ ボックスを実行します。
ShowDialog(IWin32Window)

指定した所有者と共に共通のダイアログ ボックスを実行します。
ToString()

Stringの名前 (存在する場合) を含むComponentを返します。 このメソッドはオーバーライドしないでください。

(継承元 Component)

イベント

名前 説明
Disposed

コンポーネントが Dispose() メソッドの呼び出しによって破棄されるときに発生します。

(継承元 Component)
HelpRequest

ユーザーが共通ダイアログ ボックスの [ヘルプ] ボタンをクリックしたときに発生します。

適用対象