CPropertySheet::SetTitle

Specifies the property sheet's caption (the text displayed in the title bar of a frame window).

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

Parameters

  • nStyle
    Specifies the style of the property sheet title. The style must be specified at 0 or as PSH_PROPTITLE. If the style is set as PSH_PROPTITLE, the word "Properties" appears after the text specified as the caption. For example, calling SetTitle("Simple", PSH_PROPTITLE) will result in a property sheet caption of "Simple Properties."

  • lpszText
    Points to the text to be used as the caption in the title bar of the property sheet.

Remarks

By default, a property sheet uses the caption parameter in the property sheet constructor.

Example

// 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();

Requirements

Header: afxdlgs.h

See Also

Reference

CPropertySheet Class

Hierarchy Chart

CPropertySheet::GetPage

CPropertySheet::GetActivePage