PSM_CANCELTOCLOSE Nachricht

Wird von einer Anwendung gesendet, wenn änderungen seit der letzten PSN_APPLY Benachrichtigung ausgeführt wurden, die nicht abgebrochen werden kann. Sie können diese Nachricht explizit oder mithilfe des makros PropSheet_CancelToClose senden.

Parameter

wParam

Muss Null sein.

lParam

Muss Null sein.

Rückgabewert

Kein Rückgabewert.

Bemerkungen

PSM_CANCELTOCLOSE deaktiviert die Schaltfläche Abbrechen und ändert den Text der Schaltfläche OK in "Schließen".

Die meisten Eigenschaftenblätter warten auf irreversible Änderungen, bis eine PSN_APPLY Benachrichtigung empfangen wird. Unter bestimmten Umständen kann ein Eigenschaftenblatt jedoch irreversible Änderungen außerhalb der Standardsequenz PSN_APPLY/PSN_RESET vornehmen. Ein Beispiel ist ein Eigenschaftenblatt, das eine Schaltfläche Bearbeiten enthält, die zum Anzeigen eines Unterdialogfelds zum Bearbeiten einer Eigenschaft verwendet wird. Wenn der Benutzer auf OK klickt, um die Änderung zu übermitteln, enthält die Eigenschaftenblattseite mehrere Optionen.

• Sie kann die Änderungen aufzeichnen, aber warten, bis sie eine PSN_APPLY Benachrichtigung erhält, um sie anzuwenden. Dies ist der bevorzugte Ansatz.
• Es kann die Änderungen unmittelbar nach dem Beenden des Unterdialogfelds anwenden, aber erinnern Sie sich an die ursprünglichen Einstellungen. Diese Einstellungen können verwendet werden, um den ursprünglichen Zustand wiederherzustellen, wenn eine PSN_RESET Benachrichtigung empfangen wird.
• Sie kann die Änderungen sofort anwenden und nicht versuchen, die ursprünglichen Einstellungen wiederherzustellen, wenn sie eine PSN_RESET Benachrichtigung empfängt. Dieser Ansatz wird nicht empfohlen, kann aber notwendig sein, wenn die Änderungen zu weit reichend sind, als dass die beiden anderen Optionen praktisch sind.

Bei der dritten Option sollten Anwendungen eine PSM_CANCELTOCLOSE Nachricht an das Eigenschaftenblatt senden. Es gibt dem Benutzer an, dass die mit dem Unterdialogfeld vorgenommenen Änderungen nicht durch Klicken auf die Schaltfläche Abbrechen rückgängig gemacht werden können.

Anforderungen