CPropertySheet::Construct

Articolo
06/10/2015

Costruisce un oggetto 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  
);

Parametri

nIDCaption
ID della barra del titolo da utilizzare per la finestra delle proprietà.
pParentWnd
Puntatore alla finestra padre della finestra delle proprietà. Se NULL, la finestra padre sarà la finestra principale dell'applicazione.
iSelectPage
L'indice della pagina che verrà inizialmente all'inizio. L'impostazione predefinita è la prima pagina aggiunta al foglio.
pszCaption
Puntatore a una stringa contenente la didascalia da utilizzare per la finestra delle proprietà. Non è possibile NULL.
hbmWatermark
Handle della bitmap di sfondo della pagina delle proprietà.
hpalWatermark
Handle alla tavolozza bitmap di filigrana e/o la bitmap di intestazione.
hbmHeader
Gestire la bitmap l'intestazione della pagina delle proprietà.

Note

Chiamare la funzione membro se uno dei costruttori di classe non è già stato chiamato. Ad esempio, chiamare Construct quando si dichiara o allocate matrici di oggetti CPropertySheet. Nel caso di matrici, è necessario chiamare Construct per ogni membro della matrice.

Per visualizzare la finestra delle proprietà, la chiamata DoModal o Crea. La stringa contenuta nel primo parametro verrà visualizzato nella barra del titolo della finestra delle proprietà.

È possibile visualizzare immagini di un'intestazione e/o la filigrana automaticamente se si utilizza terzi o quarti prototipi Construct, elencato sopra e passare i valori validi per hbmWatermark, hpalWatermarke/o i parametri hbmHeader.

Esempio

Nell'esempio riportato in quali condizioni si chiama 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]);