ColorDialog クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーがカスタムの色を定義できるようにするコントロールと共に使用可能な色を表示する一般的なダイアログ ボックスを表します。
public ref class ColorDialog : System::Windows::Forms::CommonDialog
public class ColorDialog : System.Windows.Forms.CommonDialog
type ColorDialog = class
inherit CommonDialog
Public Class ColorDialog
Inherits 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 を呼び出す必要があります。 HookProc は、特定のダイアログ ボックス フック機能を実装するためにオーバーライドできます。 Colorを使用して、ユーザーが選択した色を取得します。
ColorDialogのインスタンスを作成すると、読み取り/書き込みプロパティの一部が初期値に設定されます。 これらの値の一覧については、 ColorDialog コンストラクターを参照してください。
コンストラクター
| 名前 | 説明 |
|---|---|
| ColorDialog() |
ColorDialog クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| AllowFullOpen |
ユーザーがダイアログ ボックスを使用してカスタム 色を定義できるかどうかを示す値を取得または設定します。 |
| AnyColor |
ダイアログ ボックスに、一連の基本色で使用可能なすべての色が表示されるかどうかを示す値を取得または設定します。 |
| CanRaiseEvents |
コンポーネントがイベントを発生できるかどうかを示す値を取得します。 (継承元 Component) |
| Color |
ユーザーが選択した色を取得または設定します。 |
| Container |
IContainerを含むComponentを取得します。 (継承元 Component) |
| CustomColors |
ダイアログ ボックスに表示されるユーザー設定の色のセットを取得または設定します。 |
| DesignMode |
Componentが現在デザイン モードであるかどうかを示す値を取得します。 (継承元 Component) |
| Events |
この Componentにアタッチされているイベント ハンドラーの一覧を取得します。 (継承元 Component) |
| FullOpen |
ダイアログ ボックスを開いたときに、カスタム 色の作成に使用するコントロールを表示するかどうかを示す値を取得または設定します。 |
| Instance |
基になるウィンドウ インスタンス ハンドル (HINSTANCE) を取得します。 |
| Options |
ColorDialogを初期化する値を取得します。 |
| ShowHelp |
[色] ダイアログ ボックスに [ヘルプ] ボタンが表示されるかどうかを示す値を取得または設定します。 |
| Site | (継承元 Component) |
| SolidColorOnly |
ダイアログ ボックスでユーザーが単色のみを選択するように制限するかどうかを示す値を取得または設定します。 |
| Tag |
コントロールに関するデータを含むオブジェクトを取得または設定します。 (継承元 CommonDialog) |
メソッド
| 名前 | 説明 |
|---|---|
| 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) |
共通ダイアログ ボックスに特定の機能を追加するためにオーバーライドされる共通ダイアログ ボックス フック プロシージャを定義します。 (継承元 CommonDialog) |
| InitializeLifetimeService() |
古い.
このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| MemberwiseClone(Boolean) |
現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject) |
| OnHelpRequest(EventArgs) |
HelpRequest イベントを発生させます。 (継承元 CommonDialog) |
| OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) |
共通のダイアログ ボックスに特定の機能を追加するためにオーバーライドされる所有者ウィンドウ プロシージャを定義します。 (継承元 CommonDialog) |
| Reset() |
すべてのオプションを既定値にリセットし、最後に選択した色を黒に、カスタムの色を既定値にリセットします。 |
| RunDialog(IntPtr) |
派生クラスでオーバーライドされた場合は、共通のダイアログ ボックスを指定します。 |
| ShowDialog() |
既定の所有者を持つ共通のダイアログ ボックスを実行します。 (継承元 CommonDialog) |
| ShowDialog(IWin32Window) |
指定した所有者と共に共通のダイアログ ボックスを実行します。 (継承元 CommonDialog) |
| ToString() |
ColorDialogを表す文字列を返します。 |
イベント
| 名前 | 説明 |
|---|---|
| Disposed |
コンポーネントが Dispose() メソッドの呼び出しによって破棄されるときに発生します。 (継承元 Component) |
| HelpRequest |
ユーザーが共通ダイアログ ボックスの [ヘルプ] ボタンをクリックしたときに発生します。 (継承元 CommonDialog) |