macro PropSheet_RemovePage (prsht.h)

Article
10/24/2024

Supprime une page d’une feuille de propriétés. Vous pouvez utiliser cette macro ou envoyer explicitement le message PSM_REMOVEPAGE.

Syntaxe

VOID PropSheet_RemovePage(
   HWND           hDlg,
   int            index,
   HPROPSHEETPAGE hpage
);

Paramètres

hDlg

Type : HWND

Handle vers la feuille de propriétés.

index

Type : int

Index de base zéro de la page à supprimer.

hpage

Type : HPROPSHEETPAGE

Gérer la page à supprimer.

Valeur de retour

Type : VOID

Aucune valeur de retour.

Remarques

Une application peut spécifier la page à supprimer en affectant une valeur à d’index ou hpage. Si les valeurs sont affectées à index et hpage, hpage est prioritaire.

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_RemovePage 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 supprimez 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

Partager via