Freigeben über

PropSheet_CancelToClose Makro (prsht.h)

  • Artikel

Wird verwendet, wenn Änderungen seit der letzten PSN_APPLY Benachrichtigung nicht abgebrochen werden können. Sie können auch eine PSM_CANCELTOCLOSE Nachricht explizit senden.

Syntax

VOID PropSheet_CancelToClose(
   HWND hDlg
);

Parameter

hDlg

Typ: HWND-

Behandeln sie das Eigenschaftenblatt.

Rückgabewert

Typ: VOID

Kein Rückgabewert.

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, bis eine PSN_APPLY Benachrichtigung empfangen wird. Unter bestimmten Umständen kann ein Eigenschaftenblatt jedoch unumkehrbare Ä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, hat die Eigenschaftenblattseite mehrere Optionen:

  • Sie kann die Änderungen aufzeichnen, aber warten, bis sie eine PSN_APPLY Benachrichtigung erhalten, um sie anzuwenden. Dies ist der bevorzugte Ansatz.
  • Sie 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.
  • 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, damit die beiden anderen Optionen praktisch sein können.
Für die dritte Option sollten Anwendungen eine PSM_CANCELTOCLOSE Nachricht an das Eigenschaftenblatt senden. Sie gibt dem Benutzer an, dass die mit dem Unterdialogfeld vorgenommenen Änderungen nicht rückgängig gemacht werden können, indem sie auf die Schaltfläche Abbrechen klicken.
Hinweis Dieses Makro wird bei Verwendung des Aero-Assistentenstils (PSH_AEROWIZARD) nicht unterstützt.
 

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- prsht.h