macro PropSheet_AddPage (prsht.h)

Ajoute une nouvelle page à la fin d’une feuille de propriétés existante. Vous pouvez utiliser cette macro ou envoyer explicitement le message PSM_ADDPAGE.

Syntaxe

BOOL PropSheet_AddPage(
   HWND           hDlg,
   HPROPSHEETPAGE hpage
);

Paramètres

hDlg

Type : HWND

Handle vers la feuille de propriétés.

hpage

Type : HPROPSHEETPAGE

Gérez la page à ajouter. La page doit avoir été créée par un appel précédent à la fonction CreatePropertySheetPage.

Valeur de retour

Type : BOOL

Retourne TRUE en cas de réussite ou FALSE sinon.

Remarques

La nouvelle page ne doit pas être supérieure à la page la plus grande actuellement dans la feuille de propriétés, car la feuille de propriétés n’est pas redimensionnée pour s’adapter à la nouvelle page.

Un certain nombre de messages et un appel de fonction se produisent pendant que la feuille de propriétés manipule la liste des pages. Pendant que cette action a lieu, la tentative de modification de la liste des pages aura des résultats imprévisibles. En conséquence, vous ne devez pas utiliser la macro PropSheet_AddPage dans votre implémentation de PropSheetPageProc ou lors de la gestion des notifications suivantes et des messages Microsoft Windows :

• PSN_APPLY
• PSN_KILLACTIVE
• PSN_RESET
• PSN_SETACTIVE
• WM_DESTROY
• WM_INITDIALOG

Si vous devez modifier une page de feuille de propriétés pendant que vous gérez l’un de ces messages ou lorsque PropSheetPageProc est en cours d’opération, publiez-vous un message Windows privé. Votre application ne recevra pas ce message tant que le gestionnaire de feuilles de propriétés n’aura pas terminé ses tâches. Vous pouvez ensuite modifier la liste des pages.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	prsht.h