CPropertyPage::CPropertyPage

Constructs a CPropertyPage object.

CPropertyPage( ); 
explicit CPropertyPage( 
   UINT nIDTemplate, 
   UINT nIDCaption = 0, 
   DWORD dwSize = sizeof(PROPSHEETPAGE) 
); 
explicit CPropertyPage( 
   LPCTSTR lpszTemplateName, 
   UINT nIDCaption = 0, 
   DWORD dwSize = sizeof(PROPSHEETPAGE) 
); 
CPropertyPage( 
   UINT nIDTemplate, 
   UINT nIDCaption, 
   UINT nIDHeaderTitle, 
   UINT nIDHeaderSubTitle = 0, 
   DWORD dwSize = sizeof(PROPSHEETPAGE) 
); 
CPropertyPage( 
   LPCTSTR lpszTemplateName, 
   UINT nIDCaption, 
   UINT nIDHeaderTitle, 
   UINT nIDHeaderSubTitle = 0, 
   DWORD dwSize = sizeof(PROPSHEETPAGE) 
);

Parameters

  • nIDTemplate
    ID of the template used for this page.

  • nIDCaption
    ID of the name to be placed in the tab for this page. If 0, the name will be taken from the dialog template for this page.

  • dwSize

  • lpszTemplateName
    Points to a string containing the name of the template for this page. Cannot be NULL.

  • nIDHeaderTitle
    ID of the name to be placed in the title location of the property page header.

  • nIDHeaderSubTitle
    ID of the name to be placed in the subtitle location of the property page header.

Remarks

The object is displayed after all of the following conditions are met:

  • The page has been added to a property sheet using CPropertySheet::AddPage.

  • The property sheet's DoModal or Create function has been called.

  • The user has selected (tabbed to) this page.

If you have multiple parameters (for example, if you are using an array), use CPropertySheet::Construct instead of CPropertyPage.

Example

// Declare a CStylePage object, which is a CPropertyPage-derived class.
CStylePage stylePage;

// Declare a CPropertyPage object with IDD_SHAPE, the ID of the  
// template used for this page. 
CPropertyPage shapePage(IDD_SHAPE);

Requirements

Header: afxdlgs.h

See Also

Reference

CPropertyPage Class

Hierarchy Chart

CPropertySheet::Create

CPropertySheet::DoModal

CPropertySheet::AddPage

CPropertyPage::Construct