PropSheet_CancelToClose Makro (prsht.h)
Wird verwendet, wenn Änderungen, die seit der letzten PSN_APPLY Benachrichtigung vorgenommen wurden, nicht abgebrochen werden können. Sie können auch eine PSM_CANCELTOCLOSE-Nachricht explizit senden.
Syntax
void PropSheet_CancelToClose(
hDlg
);
Parameter
hDlg
Typ: HWND
Handle für das Eigenschaftenblatt.
Rückgabewert
Keine
Bemerkungen
PSM_CANCELTOCLOSE deaktiviert die Schaltfläche Abbrechen und ändert den Text der Schaltfläche OK in "Schließen". Sie können dieses Makro verwenden oder die PSM_CANCELTOCLOSE Nachricht explizit senden.
Die meisten Eigenschaftenblätter warten, um irreversible Änderungen durchzuführen, bis eine PSN_APPLY Benachrichtigung empfangen wird. Unter bestimmten Umständen kann ein Eigenschaftenblatt jedoch unwiderrufliche Änderungen außerhalb der Standard-PSN_APPLY/PSN_RESET-Sequenz 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, verfügt die Eigenschaftenblattseite über 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 denken Sie an die ursprünglichen Einstellungen. Diese Einstellungen können verwendet werden, um den ursprünglichen Zustand wiederherzustellen, wenn eine PSN_RESET Benachrichtigung empfangen wird.
- Es kann die Änderungen sofort anwenden und nicht versuchen, die ursprünglichen Einstellungen wiederherzustellen, wenn eine PSN_RESET Benachrichtigung empfangen wird. Dieser Ansatz wird nicht empfohlen, kann aber notwendig sein, wenn die Änderungen zu weitreichend sind, um die beiden anderen Optionen zu nutzen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | prsht.h |