CPropertySheet::SetTitle

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

更新 : 2007 年 11 月

プロパティシートのキャプション (フレームウィンドウのタイトルバーに表示されるテキスト) を指定します。

void SetTitle(
   LPCTSTR lpszText,
   UINT nStyle = 0 
);

パラメータ

nStyle
プロパティシートタイトルのスタイルを指定します。スタイルには 0 または PSH_PROPTITLE を指定します。スタイルとして PSH_PROPTITLE を設定すると、キャプションとして指定されるテキストの後に単語 "Properties" が表示されます。たとえば、SetTitle("Simple", PSH_PROPTITLE) を呼び出すと、プロパティシートのキャプションは "Simple Properties." と表示されます。
lpszText
プロパティシートのタイトルバーにキャプションとして使われるテキストへのポインタ。

解説

既定では、プロパティシートは、プロパティシートコンストラクタのキャプションパラメータを使います。

使用例

// Declare a CPropertySheet object with a caption "Simple PropertySheet".
CPropertySheet dlgPropertySheet(_T("Simple PropertySheet"));

// Add three pages to the CPropertySheet object. CStylePage, CColorPage,
// and CShapePage are CPropertyPage-derived classes created
// by the Add Class wizard.
CStylePage     stylePage;
CColorPage     colorPage;
CShapePage     shapePage;
dlgPropertySheet.AddPage(&stylePage);
dlgPropertySheet.AddPage(&colorPage);
dlgPropertySheet.AddPage(&shapePage);

// Change the caption of the CPropertySheet object 
// from "Simple PropertySheet" to "Simple Properties".
dlgPropertySheet.SetTitle(_T("Simple"), PSH_PROPTITLE);

// Show the CPropertySheet object as MODAL.
dlgPropertySheet.DoModal();