CPropertyPage::Construct

Article
06/10/2015

Appelez la fonction membre pour construire un objet d' CPropertyPage .

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

Paramètres

nIDTemplate
ID du modèle utilisé pour cette page.
nIDCaption
ID du nom à définir dans l'onglet pour cette page. Si 0, le nom sera pris du modèle de boîte de dialogue pour cette page.
lpszTemplateName
Contient une chaîne terminée par le caractère NULL qui est le nom d'une ressource de modèle.
nIDHeaderTitle
ID du nom à définir dans l'emplacement de titre de l'en-tête de page de propriétés. Par défaut, 0.
nIDHeaderSubTitle
ID du nom à définir dans l'emplacement de sous-titre de l'en-tête de page de propriétés. Par défaut, 0.

Notes

L'objet est affiché après que toutes les conditions suivantes sont remplies :

La page a été ajoutée à une feuille de propriétés à l'aide de CPropertySheet::AddPage.
DoModal ou la fonction de création de la feuille de propriétés a été appelé.
l'utilisateur a sélectionné (tabulé) cette page.

Appelez Construction si l'un des autres constructeurs de classe n'a pas été appelé. La fonction membre d' Construct flexible car vous pouvez laisser le champ vide d'instruction de paramètre puis spécifier plusieurs paramètres et construction à tout moment dans votre code.

Vous devez utiliser Construct lorsque vous travaillez avec les tableaux, et vous devez appeler Construction pour chaque membre du tableau afin que les données membres soient assignées de valeurs correctes.

Exemple

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