CPropertySheet クラス
タブ ダイアログ ボックスとしても知られるプロパティ シートを表します。
class CPropertySheet : public CWnd
解説
プロパティ シートは、1 つの CPropertySheet オブジェクトと、1 つ以上の CPropertyPage オブジェクトで構成されます。 フレームワークは、一連のタブ インデックスを持ち、現在選択されているページが表示される領域のあるウィンドウとしてプロパティ シートを表示します。 ユーザーは、該当するタブを使用して特定のページに移動します。
CPropertySheet では、Windows 98 および Windows NT 2000 で導入された、拡張 PROPSHEETHEADER 構造体がサポートされています。 この構造体には、"ウォーターマーク" の背景ビットマップの使用をサポートする追加のフラグとメンバーが含まれます。
この新しいイメージをプロパティ シート オブジェクトに自動的に表示するには、CPropertySheet::Construct または CPropertySheet::CPropertySheet を呼び出し、ビットマップ イメージとパレット イメージの有効な値を渡します。
CPropertySheet は CDialog から派生されてはいませんが、CPropertySheet オブジェクトの管理は、CDialog オブジェクトの管理と同じように行われます。 たとえば、プロパティ シートの作成 2 つの部分の構築が必要です。コンス トラクターをコールし、呼び出すDoModal モーダル プロパティ シートのまたは 作成、モードレス プロパティ シートの。 CPropertySheetコンス トラクターの 2 種類があります。CPropertySheet::Construct と CPropertySheet::CPropertySheet。
CPropertySheet オブジェクトを構築するときに、一部の ウィンドウ スタイルによって初回例外が発生する可能性があります。 これは、まだ作成されていないプロパティ シートのスタイルをシステムが変更しようとするために起こります。 この例外を回避するには、独自の CPropertySheet を作成するときに次のスタイルを設定してください。
DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP
次のオプションのスタイルも、初回例外を引き起こすことなく使用できます。
DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN
これ以外の Window Styles は禁止されているので、有効にしないでください。
CPropertySheet オブジェクトと外部オブジェクトの間でのデータの交換は、CDialog オブジェクトとのデータ交換に似ています。 大きな違いは、プロパティ シートの設定は、通常、CPropertySheet オブジェクト自身のメンバー変数ではなく、CPropertyPage オブジェクトのメンバー変数になっているという点です。
ウィザードと呼ばれる型のタブ ダイアログ ボックスを作成できます。このダイアログ ボックスは、デバイスのセットアップやニュースレターの作成のような、操作の手順をユーザーに示す一連のプロパティ ページを持つプロパティ シートで構成されています。 ウィザード型のタブ ダイアログ ボックスでは、プロパティ ページにタブがなく、一度に 1 つのプロパティ ページだけが表示されます。 また、ウィザード型のタブ ダイアログ ボックスは、[OK] ボタンや [今すぐ適用] ボタンの代わりに、[戻る]、[次へ]、[完了]、[キャンセル]、および [ヘルプ] の各ボタンを持ちます。
ウィザード型ダイアログ ボックスを作成する手順は、標準のプロパティ シートの作成手順と同じですが、DoModal を呼び出す前に、SetWizardMode を呼び出します。 ウィザード ボタンを有効にするには、その機能や外観をカスタマイズするためのフラグを使って SetWizardButtons を呼び出します。 [完了] ボタンを有効にするには、ウィザードの最後のページでユーザーが操作を行った後に SetFinishText を呼び出します。
CPropertySheet オブジェクトの使い方の詳細については、「プロパティ シートとプロパティ ページ」を参照してください。 また、「サポート技術情報」(knowledge Base) の資料 Q146916 を参照してください。[HOWTO]:標準のボタンとモードレス CPropertySheet を作成し、Q300606 の記事。[HOWTO]:サイズ変更可能な MFC プロパティ シートを設計します。
必要条件
**ヘッダー:**afxdlgs.h
参照
処理手順
CMNCTRL1 サンプル:共通コントロール MFC クラス、第 1 部) を示します
CMNCTRL2 サンプル:共通コントロール MFC クラス、第 2 部) を示します
PROPDLG サンプル:プロパティ シートのサポートを示します
SNAPVW サンプル:フォーム ビュー] アプリケーションをでプロパティ ページを使用します。