CommonDialog クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ダイアログ ボックスを画面に表示するために使用する基本クラスを指定します。
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
- 継承
- 派生
例
次のコード例では、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 | (継承元 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 |
ユーザーが共通ダイアログ ボックスの [ヘルプ] ボタンをクリックしたときに発生します。 |