PSM_REMOVEPAGE message

Supprime une page d'une feuille de propriétés. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_RemovePage .

Paramètres

wParam

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

lParam

Handle HPROPSHEETPAGE de la page à supprimer.

Valeur retournée

Pas de valeur de retour.

Notes

Une application peut spécifier l’index ou le handle, ou les deux. Si les deux sont spécifiés, lParam est prioritaire.

L’envoi de PSM_REMOVEPAGE détruit la page de la feuille de propriétés en cours de suppression.

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 de pages aura des résultats imprévisibles. Par conséquent, vous ne devez pas utiliser le message PSM_REMOVEPAGE dans votre implémentation de PropSheetPageProc ou lors de la gestion des notifications et messages Windows suivants.

• 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 que PropSheetPageProc est en cours d’exploitation, 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.

• PSN_WIZBACK
• PSN_WIZNEXT

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 qui se trouve avant la page active (qui a un index plus petit que la page active), PSN_KILLACTIVE peut être envoyé à la mauvaise page.

Spécifications

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]
En-tête	Prsht.h