CPropertySheet::Construct

Artigo
08/25/2010

Constrói um CPropertySheet objeto.

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
ID da legenda a ser usado para o folha de propriedades.
pParentWnd
Ponteiro para a janela pai do folha de propriedades.If NULO, a janela pai será a janela principal do aplicativo.
iSelectPage
O índice da página estará inicialmente visível.Padrão é a primeira página adicionada à folha.
pszCaption
Ponteiro para uma seqüência de caracteres que contém a legenda a ser usado para o propriedade folha.Não pode ser NULO.
hbmWatermark
Alça de preenchimento para o bitmap de marca-d'água do propriedade página.
hpalWatermark
Identificador para a paleta da marca-d'água de bitmap e/ou bitmap de cabeçalho.
hbmHeader
Identificador para o bitmap de cabeçalho da página de propriedades.

Comentários

telefonar Essa função de membro, se um dos construtores de classe já não tiver sido telefonar ed.Por exemplo, telefonar Construct Quando declarar ou matrizes de alocar CPropertySheet objetos. No caso de arrays, você deve telefonar Construct para cada membro da matriz.

Para exibir o propriedade folha, telefonar DoModal or Criar.A seqüência de caracteres contida no primeiro parâmetro será colocada na BAR de legenda para a folha de propriedades.

Você pode exibir imagens de cabeçalho e/ou marca-d'água automaticamente se você usar os terceiro ou quarto protótipos de Construct, listadas acima e passar os valores válido para o hbmWatermark, hpalWatermark, e/ou hbmHeader parâmetros.

Exemplo

O exemplo a seguir demonstra como em que circunstâncias você faria telefonar 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]);