CPropertyPage::Construct

Artículo
02/19/2013

Llame a esta función miembro para construir un objeto de CPropertyPage .

void Construct(
   UINT nIDTemplate,
   UINT nIDCaption = 0 
);
void Construct(
   LPCTSTR lpszTemplateName,
   UINT nIDCaption = 0 
);
void Construct(
   UINT nIDTemplate,
   UINT nIDCaption,
   UINT nIDHeaderTitle,
   UINT nIDHeaderSubTitle = 0 
);
void Construct(
   LPCTSTR lpszTemplateName,
   UINT nIDCaption,
   UINT nIDHeaderTitle,
   UINT nIDHeaderSubTitle = 0 
);

Parámetros

nIDTemplate
identificador de la plantilla utilizada para esta página.
nIDCaption
Identificador de nombre se coloque en la pestaña para esta página.Si 0, el nombre es tomado de plantilla de cuadro de diálogo para esta página.
lpszTemplateName
Contiene una cadena terminada en null que es el nombre de un recurso de plantilla.
nIDHeaderTitle
Identificador de nombre se coloque en la ubicación del título del encabezado de página de propiedades.De forma predeterminada, 0.
nIDHeaderSubTitle
Identificador de nombre se coloque en la ubicación del subtítulo de encabezado de página de propiedades.De forma predeterminada, 0.

Comentarios

Se muestra el objeto después de que se cumplan todas las condiciones siguientes:

La página se ha agregado a una hoja de propiedades mediante CPropertySheet:: AddPage.
Se ha llamado a la función de DoModal o de Crear de la hoja de propiedades.
el usuario tiene seleccionado (tabulado) esta página.

Llame a Construct si no han llamado a uno de los otros constructores de clase.La función miembro de Construct es flexible porque puede dejar en blanco de extracto del parámetro y luego especificar parámetros y la construcción de cualquier punto del código.

Debe utilizar Construct cuando se trabaja con matrices, y se debe llamar a Construct para cada miembro de la matriz para asignar los miembros de datos valores adecuados.

Ejemplo

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

// Create three CPropertyPage objects whose template IDs are specified
// in rgID array, and add each page to the CPropertySheet object. 
const int c_cPages = 3;
CPropertyPage   pages[c_cPages];
UINT rgID[c_cPages] = {IDD_STYLE, IDD_COLOR, IDD_SHAPE};
for (int i = 0; i < c_cPages; i++)    
{
   pages[i].Construct(rgID[i]);
   sheet.AddPage(&pages[i]);
}

// Display a modal CPropertySheet dialog.
sheet.DoModal();