ColorDialog クラス

使用できる一連の色を選択できるコモン ダイアログ ボックスを表します。System.Windows.Forms.ColorDialog クラス互換のコモン ダイアログ ボックスです。

この型のすべてのメンバの一覧については、ColorDialog メンバ を参照してください。

System.Object
　System.MarshalByRefObject
　　System.ComponentModel.Component
　　　System.Windows.Forms.Control
　　　　System.Windows.Forms.ScrollableControl
　　　　　System.Windows.Forms.ContainerControl
　　　　　　System.Windows.Forms.Form
　　　　　　　SmartPDA.Windows.Forms.ColorDialog

[C#] public class ColorDialog : Form

スレッドセーフ
この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説
.NET Compact Framework 1.0, 2.0 では色を選択する ColorDialog コモン ダイアログ ボックスは提供されていません。このクラスを使用するとユーザが色を選択する事が出来るコモン ダイアログ ボックスを使用する事が出来ます。

このコモン ダイアログ ボックスを作成するには、継承メンバ ShowDialog を呼び出す必要があります。
Color を使用して、ユーザーが選択した色を取得します。
ColorDialog のインスタンスを作成すると、一部の読み書き可能プロパティが初期値に設定されます。
これらの初期値の一覧については、 ColorDialog コンストラクタのトピックを参照してください。

使用例
[C#] ColorDialog の新しいインスタンスを ColorDialogFactor により作成し、いくつかのプロパティを設定し、ColorDialog.ShowDialog メソッドを使用してダイアログボックスを表示する例を次に示します。
この例では、 TextBox と Button が配置されている既存のフォームからメソッドが呼び出されることを前提としています。

using SmartPDA.Windows.Forms; private void Dialog_Click(object sender, EventArgs e) { ColorDialog cd = ColorDialogFactory.MakeColorDialog(); cd.Text = "Font"; DialogResult d = cd.ShowDialog(); switch (d) { case(DialogResult.OK): { MessageBox.Show("Selected!"); SampleColor.BackColor = cd.Color; Color_R.Text = SampleColor.BackColor.R.ToString(); Color_G.Text = SampleColor.BackColor.G.ToString(); Color_B.Text = SampleColor.BackColor.B.ToString(); break; } case (DialogResult.No): { MessageBox.Show("Cancel!"); break; } case (DialogResult.Abort): { MessageBox.Show("Abort!"); break; } } cd.Dispose(); }

[Visual Basic, C++, JScript] Visual Basic, C++, JScript のサンプルはありません。

画面上での使い方
ColorDialog が開いたら、右ボタンを押すとカーソルが進み、左ボタンを押すとカーソルが戻ります。
この状態で、パレット上でアクションボタンを押すか、メニューから「選択」を選ぶと、フォーカスされている色を選択します。

色を選択しない場合は、メニューから「キャンセル」を選択します。

必要条件

名前空間 : SmartPDA.Windows.Forms

プラットフォーム : .NET Compact Framework - Windows CE.NET

アセンブリ : SmartPDA.Windows.Forms ( ColorDialog.dll 内 )

参照 :
ColorDialog メンバ | SmartPDA.Windows.Forms 名前空間

ColorDialog クラスは、System.Windows.Forms.Form クラスを継承しているクラスです。ここでの解説においては ColorDialog クラス独自のプロパティ、メソッドの解説を行い、継承している Form クラスのプロパティおよびメソッドの解説は行いません。

パブリック コンストラクタ

ColorDialog コンストラクタ

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

パブリック プロパティ

Color	ユーザーが選択した色を取得または設定します。
Font	ダイアログ ボックスで表示するフォントを取得または設定します。

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

[C#] public ColorDialog();

解説
既定のコンストラクタは、すべてのフィールドを初期値に設定します。

必要条件

プラットフォーム : .NET Compact Framework - Windows CE.NET

参照 :
ColorDialog クラス | ColorDialog メンバ | SmartPDA.Windows.Forms 名前空間

ユーザーが選択した色を取得または設定します。

[C#] public Color Color { get; set; }

プロパティ値
ユーザーが選択した色。色が選択されていない場合の既定値は黒です。

解説
実行時にユーザーがダイアログ ボックスで選択した色 (Color 構造体で定義されている色)。

必要条件

プラットフォーム : .NET Compact Framework - Windows CE.NET

参照 :
ColorDialog クラス | ColorDialog メンバ | SmartPDA.Windows.Forms 名前空間

ダイアログ ボックスで表示するフォントを取得または設定します。

[C#] public System.Drawing.Font Font { get; set; }

プロパティ値
コントロールによって表示されるテキストに適用される Font オブジェクト。既定値は System.Drawing.Font(FontFamily.GenericSansSerif, 9F, System.Drawing.FontStyle.Regular) です。

解説
FontFamily.GenericSansSerif フォントがユーザーのコンピュータにインストールされていない場合は、DEFAULT_GUI_FONT が使用されます。DEFAULT_GUI_FONT は、メニューやダイアログ ボックスなどのユーザー インターフェイス オブジェクトによって使用される既定のフォントです。

Font プロパティで設定したフォントは、同じフォームに配置されている Label、Button、ListView、ComboBox コントロール等の Font プロパティに設定されます。

必要条件

プラットフォーム : .NET Compact Framework - Windows CE.NET

参照 :
ColorDialog クラス | ColorDialog メンバ | SmartPDA.Windows.Forms 名前空間