CColorDialog クラス
更新 : 2007 年 11 月
アプリケーションに色を選択するためのダイアログ ボックスを組み込むことができます。
class CColorDialog : public CCommonDialog
解説
CColorDialog オブジェクトは、ディスプレイ システムに対して定義された一連の色を一覧表示するダイアログ ボックスです。この一覧で特定の色を選択および作成できます。その後ダイアログ ボックスを閉じると、この色がアプリケーションに通知されます。
CColorDialog オブジェクトを構築するには、提供されたコンストラクタを使うか、新しいクラスを派生させて、独自のコンストラクタを使います。
ダイアログ ボックスを構築すると、m_cc 構造体の任意の値を設定、修正してダイアログ ボックスのコントロールの値を初期化できます。m_cc 構造体の型は、CHOOSECOLOR です。
ダイアログ ボックス コントロールを初期化した後は、ダイアログ ボックスを表示し、ユーザーが色を選択できるように DoModal メンバ関数を呼び出します。DoModal は、ユーザーがダイアログ ボックスの [OK] を選択した (IDOK) か、[キャンセル] を選択した (IDCANCEL) かを返します。
DoModal 関数が IDOK を返した場合は、入力された情報を取得するために CColorDialog メンバ関数の 1 つを使用できます。
ダイアログ ボックスの初期化中にエラーが発生したかどうかを確認し、そのエラーについての情報を得るために、Windows の CommDlgExtendedError 関数を使用できます。
CColorDialog は、Windows Versions 3.1 以降で配布される COMMDLG.DLL ファイルを使います。
ダイアログ ボックスをカスタマイズするには、CColorDialog からクラスを派生し、独自のダイアログ テンプレートを作成します。さらに、外部のコントロールからの通知メッセージを処理するためにメッセージ マップを追加します。処理されないメッセージは基本クラスに渡されます。
フック関数のカスタマイズは必要ありません。
.gif "メモ") メモ : |
|---|
フレームワークを使って、他の CDialog オブジェクトを淡色表示すると、インストールしたときに CColorDialog オブジェクトの背景色が淡色にならないことがあります。 |
CColorDialogの使い方の詳細については、「コモン ダイアログ クラス」を参照してください。
必要条件
ヘッダー : afxdlgs.h
スマート デバイス開発者のためのメモ
このクラスは、Windows CE Standard SDK でのみサポートされます。Windows Mobile Pocket PC プラットフォームや Smartphone プラットフォームではサポートされません。
スマート デバイス バージョンの CColorDialog クラス では、次のメソッドはサポートされません。
参照
処理手順
MDI サンプル : ドキュメント/ビュー アーキテクチャを使用しない MDI
DRAWCLI サンプル : Active コンテナ サポートとアプリケーション固有の機能の統合