CPropertyPage::Construct

Artigo
02/25/2013

Chamar essa função de membro para construir um 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
Identificação do modelo usado para esta página.
nIDCaption
Identificação do nome ser colocado na guia para esta página.Se 0, o nome serão tirados de modelo da caixa de diálogo para esta página.
lpszTemplateName
Contém uma cadeia de caracteres NULL- finalizada que é o nome de um recurso do modelo.
nIDHeaderTitle
Identificação do nome ser colocado na localidade de título do cabeçalho da página de propriedades.Por padrão, 0.
nIDHeaderSubTitle
Identificação do nome ser colocado na localidade de subtítulo de cabeçalho da página de propriedades.Por padrão, 0.

Comentários

O objeto é exibido após todas as seguintes condições forem atendidas:

A página foi adicionada a uma folha de propriedades usando CPropertySheet::AddPage.
A função de DoModal ou de Criar de folha de propriedades foi chamada.
O usuário selecionou (listado) esta página.

Chame Construct se um dos outros construtores de classe não foi chamado.A função de membro de Construct é flexível porque você pode deixar a placa da declaração de parâmetro e então especifique vários parâmetros e compilação em qualquer momento no seu código.

Você deve usar Construct quando você trabalha com matrizes, e você deve chamar Construct para cada membro da matriz para que os membros de dados sejam atribuídos valores apropriados.

Exemplo

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