macro PropSheet_CancelToClose (prsht.h)

Utilisé lorsque les modifications apportées depuis la notification PSN_APPLY la plus récente ne peuvent pas être annulées. Vous pouvez également envoyer un message PSM_CANCELTOCLOSE explicitement.

Syntaxe

VOID PropSheet_CancelToClose(
   HWND hDlg
);

Paramètres

hDlg

Type : HWND

Handle vers la feuille de propriétés.

Valeur de retour

Type : VOID

Aucune valeur de retour.

Remarques

PSM_CANCELTOCLOSE désactive le bouton Annuler et modifie le texte du bouton OK sur « Fermer ». Vous pouvez utiliser cette macro ou envoyer explicitement le message PSM_CANCELTOCLOSE.

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 certains cas, une feuille de propriétés peut apporter des modifications irréversibles en dehors de la séquence standard PSN_APPLY/PSN_RESET. Voici un exemple de feuille de propriétés qui contient une bouton Modifier utilisé pour afficher une zone de sous-journal pour modifier une propriété. Lorsque l’utilisateur clique sur OK pour envoyer la modification, la page de la feuille de propriétés comporte 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 recommandé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 de PSN_RESET est reçue.
• Il peut appliquer immédiatement les modifications 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 importantes 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.

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