CPropertySheet::Construct

Article
06/10/2015

Construit un objet 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  
);

Paramètres

nIDCaption
ID de la légende à utiliser pour la feuille de propriétés.
pParentWnd
Pointeur vers la fenêtre parente de la feuille de propriétés. Si NULL, la fenêtre parente est la fenêtre principale de l'application.
iSelectPage
L'index de la page qui sera initialement en haut. La valeur par défaut est la première page ajoutée à la feuille.
pszCaption
Pointeur vers une chaîne contenant la légende à utiliser pour la feuille de propriétés. Ne peut pas être NULL.
hbmWatermark
Handle à la bitmap de filigrane de la page de propriétés.
hpalWatermark
Handle à la palette de la bitmap de filigrane et/ou de la bitmap d'en-tête.
hbmHeader
Handle à la bitmap d'en-tête de la page de propriétés.

Notes

Appelez la fonction membre si l'un des constructeurs de classe n'a pas déjà été appelé. Par exemple, appelez Construct lorsque vous déclarez ou allouez des tableaux d'objets d' CPropertySheet . Dans le cas de les tableaux, vous devez appeler Construct pour chaque membre du tableau.

Pour afficher la feuille de propriétés, l'appel DoModal ou le Create. La chaîne contenue dans le premier paramètre est définie dans la barre de légende pour la feuille de propriétés.

Vous pouvez afficher des images de filigrane et/ou d'en-tête automatiquement si vous utilisez le troisième et le quatrième prototypes d' Construct, répertoriés ci-dessus, et vous passez des valeurs valides pour hbmWatermark, hpalWatermark, et/ou des paramètres d' hbmHeader .

Exemple

L'exemple suivant montre dans quelles circonstances vous appelleriez 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]);