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

Concepts

CPropertyPage Class

CPropertyPage Members

Hierarchy Chart

CPropertySheet::Create

CPropertySheet::DoModal

CPropertySheet::AddPage

CPropertyPage::Construct