CPropertySheet::CPropertySheet

[アーティクル]
08/09/2011

CPropertySheet オブジェクトを構築します。

CPropertySheet( ); 
explicit CPropertySheet(
   UINT nIDCaption,
   CWnd* pParentWnd = NULL,
   UINT iSelectPage = 0 
);
explicit CPropertySheet(
   LPCTSTR pszCaption,
   CWnd* pParentWnd = NULL,
   UINT iSelectPage = 0 
);
CPropertySheet(
   UINT nIDCaption,
   CWnd* pParentWnd,
   UINT iSelectPage,
   HBITMAP hbmWatermark,
   HPALETTE hpalWatermark = NULL,
   HBITMAP hbmHeader = NULL 
);
CPropertySheet(
   LPCTSTR pszCaption,
   CWnd* pParentWnd,
   UINT iSelectPage,
   HBITMAP hbmWatermark,
   HPALETTE hpalWatermark = NULL,
   HBITMAP hbmHeader = NULL 
);

パラメーター

nIDCaption
プロパティシートで使用するキャプションの ID。
pParentWnd
プロパティシートの親ウィンドウへのポインター。 NULL の場合は、アプリケーションのメインウィンドウが親ウィンドウになります。
iSelectPage
最初に最前面に表示するページのインデックス。既定では、シートに最初に追加されたページが最前面に表示されます。
pszCaption
プロパティシートに使われるキャプションを保持する文字列へのポインター。 NULL は指定できません。
hbmWatermark
プロパティシートの背景ビットマップへのハンドル。
hpalWatermark
ウォーターマークビットマップやヘッダービットマップのパレットへのハンドル。
hbmHeader
プロパティページのヘッダービットマップへのハンドル。

解説

プロパティシートを表示するには、DoModal または Create を呼び出します。最初のパラメーターで指定した文字列が、プロパティシートのキャプションバーに表示されます。

複数のパラメーターを持つ場合 (配列を使っているときなど) は、CPropertySheet の代わりに Construct を使います。

先に説明した CPropertySheet の 3 番目と 4 番目のプロトタイプを使用して、hbmWatermark ? hpalWatermark、hbmHeader パラメーターの有効な値を渡すと、ウォーターマークやヘッダーイメージを自動的に表示させることができます。

使用例

// Declare a CPropertySheet object titled "Simple PropertySheet".
CPropertySheet dlgPropertySheet1(_T("Simple PropertySheet"));

// Declare a CPropertySheet object whose title is specified in the
// IDS_PROPERTYSHEET_TITLE string resource, and the second page is
// initially on top.  
CPropertySheet dlgPropertySheet2(IDS_PROPERTYSHEET_TITLE, this, 1);