PropSheet_CancelToClose Makro (prsht.h)

  • Artikel

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.
Bei der dritten Option sollten Anwendungen eine PSM_CANCELTOCLOSE Nachricht an das Eigenschaftenblatt senden. Sie 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.
Hinweis Dieses Makro wird bei Verwendung des Aero-Assistentenstils (PSH_AEROWIZARD) nicht unterstützt.
 

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