Partager via

macro PropSheet_AddPage (prsht.h)

  • Article

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

Syntaxe

void PropSheet_AddPage(
   hDlg,
   hpage
);

Paramètres

hDlg

Type : HWND

Handle vers la feuille de propriétés.

hpage

Type : HPROPSHEETPAGE

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

Valeur de retour

None

Remarques

La nouvelle page ne doit pas être plus grande que la plus grande page 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 cette action, la tentative de modification de la liste des pages aura des résultats imprévisibles. Par conséquent, vous ne devez pas utiliser la macro PropSheet_AddPage dans votre implémentation de PropSheetPageProc ou lors de la gestion des notifications et des messages Microsoft Windows suivants :

Si vous devez modifier une page de feuille de propriétés pendant que vous gérez l’un de ces messages ou que PropSheetPageProc est en cours d’utilisation, 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête prsht.h