CPropertyPage::Construct

Artikel
06/10/2015

Rufen Sie die Memberfunktion auf, um ein CPropertyPage-Objekt zu erstellen.

void Construct( 
   UINT nIDTemplate, 
   UINT nIDCaption = 0  
); 
void Construct( 
   LPCTSTR lpszTemplateName, 
   UINT nIDCaption = 0  
); 
void Construct( 
   UINT nIDTemplate, 
   UINT nIDCaption, 
   UINT nIDHeaderTitle, 
   UINT nIDHeaderSubTitle = 0  
); 
void Construct( 
   LPCTSTR lpszTemplateName, 
   UINT nIDCaption, 
   UINT nIDHeaderTitle, 
   UINT nIDHeaderSubTitle = 0  
);

Parameter

nIDTemplate
ID der Vorlage verwendet für diese Seite.
nIDCaption
ID des in die Registerkarte für diese Seite platziert werden, Namens. Wenn 0, der Name aus der Dialogfeldvorlage für diese Seite belegt wird.
lpszTemplateName
Enthält eine auf NULL endende Zeichenfolge, die den Namen einer Vorlagenressource ist.
nIDHeaderTitle
ID des in den Namespeicherort des Eigenschaftenseitenheaders abgelegt werden, Namens. Standardmäßig 0.
nIDHeaderSubTitle
ID des in den Untertitel-Speicherort des Eigenschaftenseitenheaders abgelegt werden, Namens. Standardmäßig 0.

Hinweise

Das Objekt wird angezeigt, nachdem alle folgenden Bedingungen erfüllt sind:

Die Seite entspricht einem Eigenschaftenblatt mithilfe CPropertySheet::AddPage hinzugefügt.
DoModal oder Erstellen Sie-Funktion des Eigenschaftenblatts ist aufgerufen wurde.
Der Benutzer hat (mit der TAB-TASTE) diese Seite ausgewählt.

Rufen Sie Construct auf, wenn einer der anderen Klassenkonstruktoren nicht aufgerufen wurde. Die Construct-Memberfunktion ist flexibel, da Sie das Parameteranweisungsleerzeichen lassen und mehrere Parameter und Konstruktion an jedem Punkt im Code auf angeben können.

Sie müssen Construct verwenden, wenn Sie mit Arrays arbeiten, und Sie müssen Construct für jeden Member des Arrays aufrufen, damit der Datenmember richtige Werte zugewiesen werden.

Beispiel

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

// Create three CPropertyPage objects whose template IDs are specified 
// in rgID array, and add each page to the CPropertySheet object.  
const int c_cPages = 3;
CPropertyPage   pages[c_cPages];
UINT rgID[c_cPages] = {IDD_STYLE, IDD_COLOR, IDD_SHAPE};
for (int i = 0; i < c_cPages; i++)    
{
   pages[i].Construct(rgID[i]);
   sheet.AddPage(&pages[i]);
}

// Display a modal CPropertySheet dialog.
sheet.DoModal();