CPropertySheet::CPropertySheet

Artigo
06/10/2015

Constrói um objeto de CPropertySheet .

CPropertySheet( ); 
explicit CPropertySheet( 
   UINT nIDCaption, 
   CWnd* pParentWnd = NULL, 
   UINT iSelectPage = 0  
); 
explicit CPropertySheet( 
   LPCTSTR pszCaption, 
   CWnd* pParentWnd = NULL, 
   UINT iSelectPage = 0  
); 
CPropertySheet( 
   UINT nIDCaption, 
   CWnd* pParentWnd, 
   UINT iSelectPage, 
   HBITMAP hbmWatermark, 
   HPALETTE hpalWatermark = NULL, 
   HBITMAP hbmHeader = NULL  
); 
CPropertySheet( 
   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
Pontos 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
Aponta para uma cadeia de caracteres que contém a legenda para ser usada na folha de propriedades. Não pode ser NULO.
hbmWatermark
Um identificador para o bitmap de fundo da folha de propriedades.
hpalWatermark
Um identificador para a paleta de bitmap de marca de agua e/ou de bitmap de cabeçalho.
hbmHeader
Um identificador para o bitmap de cabeçalho da página de propriedades.

Comentários

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.

Se você tiver vários parâmetros (por exemplo, se você estiver usando uma matriz), use Compilação em vez de CPropertySheet.

Você pode exibir imagens de marca de agua e/ou de cabeçalho automaticamente se você usar o terceiro ou a quarta protótipos de CPropertySheetanterior, e você passe valores válidos para hbmWatermark, hpalWatermark, e/ou parâmetros de hbmHeader .

Exemplo

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

// Declare a CPropertySheet object whose title is specified in the 
// IDS_PROPERTYSHEET_TITLE string resource, and the second page is 
// initially on top.  
CPropertySheet dlgPropertySheet2(IDS_PROPERTYSHEET_TITLE, this, 1);