CMFCPropertySheet クラス

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

CMFCPropertySheet クラスは、各プロパティページがページタブ、ツールバーのボタン、ツリーコントロールのノード、またはリスト項目で示されるプロパティシートをサポートします。

class CMFCPropertySheet : public CPropertySheet

メンバ

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

名前	説明
CMFCPropertySheet::CMFCPropertySheet	CMFCPropertySheet オブジェクトを構築します。
CMFCPropertySheet::~CMFCPropertySheet	デストラクタです。

パブリックメソッド

名前	説明
CMFCPropertySheet::AddPage	プロパティシートにページを追加します。
CMFCPropertySheet::AddPageToTree	ツリーコントロールに新しいプロパティページを追加します。
CMFCPropertySheet::AddTreeCategory	ツリーコントロールに新しいノードを追加します。
CMFCPropertySheet::EnablePageHeader	各ページの上部にカスタムヘッダーを描画するためのスペースを確保します。
CMFCPropertySheet::GetHeaderHeight	現在のヘッダーの高さを取得します。
CMFCPropertySheet::GetLook	現在のプロパティシートの外観を指定する列挙値を取得します。
CMFCPropertySheet::GetTab	現在のプロパティシートコントロールをサポートする内部タブコントロールオブジェクトを取得します。
CMFCPropertySheet::GetThisClass	このクラス型に関連付けられた CRuntimeClass オブジェクトへのポインタを取得するために、フレームワークによって使用されます。
CMFCPropertySheet::InitNavigationControl	現在のプロパティシートコントロールの外観を初期化します。
CMFCPropertySheet::OnActivatePage	プロパティページが有効化されたときに、フレームワークによって呼び出されます。
CMFCPropertySheet::OnDrawPageHeader	カスタムプロパティページのヘッダーを描画するために、フレームワークによって呼び出されます。
CMFCPropertySheet::OnInitDialog	WM_INITDIALOG メッセージを処理します (CPropertySheet::OnInitDialog をオーバーライドします)。
CMFCPropertySheet::OnRemoveTreePage	ツリーコントロールのプロパティページを削除するために、フレームワークによって呼び出されます。
CMFCPropertySheet::PreTranslateMessage	Windows 関数の TranslateMessage や DispatchMessage にディスパッチする前にウィンドウメッセージを変換します (CPropertySheet::PreTranslateMessage をオーバーライドします)。
CMFCPropertySheet::RemoveCategory	ツリーコントロールからノードを削除します。
CMFCPropertySheet::RemovePage	プロパティシートからプロパティページを削除します。
CMFCPropertySheet::SetIconsList	Outlook ペインのナビゲーションコントロールで使用するイメージのリストを指定します。
CMFCPropertySheet::SetLook	プロパティシートの外観を指定します。

解説

CMFCPropertySheet クラスは、タブダイアログボックスとしても知られるプロパティシートを表します。CMFCPropertySheet クラスを使用すると、プロパティページをさまざまな方法で表示できます。

アプリケーションで CMFCPropertySheet クラスを使用するには、次の手順を実行します。

CMFCPropertySheet クラスの派生クラスを作成し、CMyPropertySheet などの名前を付けます。
各プロパティページの CMFCPropertyPage オブジェクトを構築します。
CMyPropertySheet コンストラクタで CMFCPropertySheet::SetLook メソッドを呼び出します。そのメソッドのパラメータで、プロパティページの表示方法として、プロパティシートの上部または左側のタブ、Microsoft OneNote プロパティシートのスタイルのタブ、Microsoft Outlook ツールバーコントロールのボタン、ツリーコントロールのノード、プロパティシートの左側の項目リストのいずれかを指定します。
Microsoft Outlook ツールバースタイルのプロパティシートを作成する場合は、CMFCPropertySheet::SetIconsList メソッドを呼び出して、プロパティページにイメージリストを関連付けます。
プロパティページごとに CMFCPropertySheet::AddPage メソッドを呼び出します。
CMFCPropertySheet コントロールを作成し、その DoModal メソッドを呼び出します。