Partager via

macro PropSheet_InsertPage (prsht.h)

  • Article

Insère une nouvelle page dans une feuille de propriétés existante. La page peut être insérée à un index spécifié ou après une page spécifiée. Vous pouvez utiliser cette macro ou envoyer explicitement le message PSM_INSERTPAGE.

Syntaxe

BOOL PropSheet_InsertPage(
   HWND hDlg,
   HWND index,
   HWND hpage
);

Paramètres

hDlg

Type : HWND

Handle vers la feuille de propriétés.

index

Type : HWND

Où la page doit être insérée. Définissez index sur NULL pour faire de la nouvelle page la première page. Pour spécifier l’emplacement d’insertion de la nouvelle page, vous pouvez passer un index ou un handle HPROPSHEETPAGE d’une page existante.

Valeur Signification
d’index
 Si index est inférieur à MAXUSHORT (le plus grand entier court non signé), il spécifie l’index de base zéro pour la nouvelle page. Par exemple, pour faire de la page insérée la troisième page de la feuille de propriétés, définissez index sur 2. Pour le rendre la première page, définissez index sur 0. Si index a une valeur supérieure au nombre de pages et inférieur à MAXUSHORT, la page est ajoutée.
hpageInsertAfter
 Si vous définissez index sur le handle HPROPSHEETPAGE d’une page existante, la nouvelle page est insérée après celle-ci.

hpage

Type : HWND

Handle to the page to be inserted. La page doit d’abord être créée par un appel à la fonction CreatePropertySheetPage.

Valeur de retour

Type : BOOL

Retourne une valeur différente de zéro si la page a été correctement insérée, ou zéro dans le cas contraire.

Remarques

Les pages après le point d’insertion sont décalées vers la droite pour prendre en charge la nouvelle page.

La feuille de propriétés n’est pas redimensionnée pour s’adapter à la nouvelle page. Ne faites pas en sorte que la nouvelle page soit supérieure à la page la plus grande de la feuille de propriétés.

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_InsertPage dans votre implémentation de PropSheetPageProc ou lors de la gestion des notifications et messages 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 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.

Les notifications suivantes sont également affectées par la modification de la feuille de propriétés.

Vous pouvez ajouter ou supprimer des pages en réponse à ces notifications, à condition que vous renvoyiez (via DWL_MSGRESULT) une valeur différente de zéro pour spécifier la nouvelle page souhaitée. Notez toutefois que si vous insérez une page située avant la page active (qui a un index plus petit que la page active), PSN_KILLACTIVE peut être envoyée à la page incorrecte.
Remarque Cette macro n’est pas prise en charge lors de l’utilisation du style de l’Assistant Aero (PSH_AEROWIZARD).
 

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