Partager via

PSM_CANCELTOCLOSE message

  • Article

Envoyé par une application lorsqu’elle a effectué des modifications depuis la dernière PSN_APPLY notification qui ne peut pas être annulée. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_CancelToClose .

Paramètres

wParam

Doit être zéro.

lParam

Doit être zéro.

Valeur retournée

Pas de valeur de retour.

Notes

PSM_CANCELTOCLOSE désactive le bouton Annuler et remplace le texte du bouton OK par « Fermer ».

La plupart des feuilles de propriétés attendent d’effectuer des modifications irréversibles jusqu’à ce qu’une notification PSN_APPLY soit reçue. Toutefois, dans certaines circonstances, une feuille de propriétés peut apporter des modifications irréversibles en dehors de la séquence PSN_APPLY/PSN_RESET standard. Un exemple est une feuille de propriétés qui contient un bouton Modifier utilisé pour afficher une zone de sous-journal pour la modification d’une propriété. Lorsque l’utilisateur clique sur OK pour envoyer la modification, la page de la feuille de propriétés dispose de plusieurs options.

  • Il peut enregistrer les modifications, mais attendre qu’il reçoive une notification PSN_APPLY pour les appliquer. Il s’agit de l’approche privilégiée.
  • Il peut appliquer les modifications immédiatement après avoir quitté la zone de sous-journal, mais n’oubliez pas les paramètres d’origine. Ces paramètres peuvent être utilisés pour restaurer l’état d’origine si une notification PSN_RESET est reçue.
  • Il peut appliquer les modifications immédiatement et ne pas tenter de restaurer les paramètres d’origine lorsqu’il reçoit une notification PSN_RESET . Cette approche n’est pas recommandée, mais peut être nécessaire si les modifications sont trop profondes pour que les deux autres options soient pratiques.

Pour la troisième option, les applications doivent envoyer un message PSM_CANCELTOCLOSE à la feuille de propriétés. Il indique à l’utilisateur que les modifications apportées à la zone de sous-journal ne peuvent pas être inversées en cliquant sur le bouton Annuler .

Notes

Ce message n’est pas pris en charge lors de l’utilisation du style de l’Assistant Aero (PSH_AEROWIZARD).

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