CPropertySheet::Construct

Artigo
02/25/2013

Constrói um objeto de CPropertySheet .

void Construct(
   UINT nIDCaption,
   CWnd* pParentWnd = NULL,
   UINT iSelectPage = 0 
);
void Construct(
   LPCTSTR pszCaption,
   CWnd* pParentWnd = NULL,
   UINT iSelectPage = 0 
);
void Construct(
   UINT nIDCaption,
   CWnd* pParentWnd,
   UINT iSelectPage,
   HBITMAP hbmWatermark,
   HPALETTE hpalWatermark = NULL,
   HBITMAP hbmHeader = NULL 
);
void Construct(
   LPCTSTR pszCaption,
   CWnd* pParentWnd,
   UINT iSelectPage,
   HBITMAP hbmWatermark,
   HPALETTE hpalWatermark = NULL,
   HBITMAP hbmHeader = NULL 
);

Parâmetros

nIDCaption
Identificação de legenda para ser usada na folha de propriedades.
pParentWnd
Ponteiro para a janela pai da folha de propriedades.Se NULO, a janela pai será a janela principal do aplicativo.
iSelectPage
O índice da página que será inicialmente na parte superior.A opção é a primeira página adicionada à folha.
pszCaption
Ponteiro para uma cadeia de caracteres que contém a legenda para ser usada na folha de propriedades.Não pode ser NULO.
hbmWatermark
Identificador para o bitmap de marca de agua da página de propriedades.
hpalWatermark
Identificador para a paleta de bitmap de marca de agua e/ou de bitmap de cabeçalho.
hbmHeader
Identificador para o bitmap de cabeçalho da página de propriedades.

Comentários

Chamar essa função de membro se um dos construtores de classe não tiver sido já chamado.Por exemplo, chame Construct quando você declara ou atribuir matrizes de objetos de CPropertySheet .Em o caso de matrizes, você deve chamar Construct para cada membro na matriz.

Para exibir a folha de propriedades, a chamada DoModal ou o Criar.A cadeia de caracteres contidas no primeiro parâmetro será colocada na barra de título para a folha de propriedades.

Você pode exibir imagens de marca de agua e/ou de cabeçalho automaticamente se você usar os terceiros ou quarta protótipos de Construct, listados acima, e você passa valores válidos para hbmWatermark, hpalWatermark, e/ou parâmetros de hbmHeader .

Exemplo

O exemplo demonstrar-lo em condições que faria Construct.

const int c_cSheets = 3;
CPropertySheet   grpropsheet[c_cSheets];
// no need to call Construct for this next one
CPropertySheet   someSheet(_T("Some sheet"));

LPTSTR rgszSheets[c_cSheets] = {
   _T("Sheet 1"),
   _T("Sheet 2"),
   _T("Sheet 3")
};

for (int i = 0; i < c_cSheets; i++)
    grpropsheet[i].Construct(rgszSheets[i]);