CPropertySheet::Construct

Artikel
06/10/2015

Erstellt ein CPropertySheet-Objekt.

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

Parameter

nIDCaption
ID der für das Eigenschaftenblatt verwendet werden, Beschriftung.
pParentWnd
Zeiger auf das übergeordnete Fenster des Eigenschaftenblatts. Wenn NULL, das übergeordnete Fenster das Hauptfenster der Anwendung ist.
iSelectPage
Der Index der Seite, die zuerst im Vordergrund ist. Standardwert ist die erste Seite, die dem Blatt hinzugefügt wird.
pszCaption
Zeiger auf eine Zeichenfolge, die die für das Eigenschaftenblatt verwendet werden, Beschriftung enthält. Nicht sein kann NULL.
hbmWatermark
Handle zur Wasserzeichenbitmap die.
hpalWatermark
Handle der Palette der Wasserzeichenbitmaps und/oder der Headerbitmaps.
hbmHeader
Handle zur Headerbitmap die.

Hinweise

Rufen Sie die Memberfunktion auf, wenn einer der Klassenkonstruktoren nicht bereits aufgerufen wurde. Beispielsweise rufen Sie Construct auf, wenn Sie Arrays CPropertySheet-Objekte deklarieren oder zuordnen. Im Fall von Arrays müssen Sie Construct für jeden Member im Array aufrufen.

Um das Eigenschaftenblatt, den Aufruf DoModal oder Erstellen Sie anzeigen. Die Zeichenfolge, die im ersten Parameter enthalten ist, wird in die Titelleiste für das Eigenschaftenblatt eingefügt.

Sie können Wasserzeichen- und/oder Headerimages automatisch anzeigen, wenn Sie die dritten oder vierten Prototypen von Construct verwenden, oben aufgeführten, und übergeben Sie gültige Werte für hbmWatermark, hpalWatermark und/oder hbmHeader-Parameter.

Beispiel

Im folgenden Beispiel wird, unter welchen Umständen Sie Construct aufrufen.

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]);