IPropertyPage::IsPageDirty-Methode (ocidl.h)

  • Artikel

Gibt an, ob sich die Eigenschaftenseite seit der Aktivierung oder seit dem letzten Aufruf von Apply geändert hat.

Syntax

HRESULT IsPageDirty();

Rückgabewert

Diese Methode gibt S_OK zurück, um anzugeben, dass sich die Eigenschaftenseite geändert hat. Andernfalls wird „S_FALSE“ zurückgegeben.

Hinweise

Das Eigenschaftenblatt verwendet diese Informationen, um die Schaltfläche Anwenden im Dialogfeld zu aktivieren oder zu deaktivieren. Es ist nicht erforderlich, die Werte auf einer Eigenschaftenseite anzuwenden, wenn diese Werte bereits mit den zugrunde liegenden Objekten aktuell sind.

Hinweise für Implementierer

Diese Methode hat keinen Grund, einen Fehlercode zurückzugeben, da die Unfähigkeit, zu bestimmen, ob die Seite modifiziert, als Standard S_OK zurückgeben sollte. Auf diese Weise hat der Benutzer die Möglichkeit, die Werte zu aktualisieren. Die Seite sollte keinen Fehlercode zurückgeben, da ein Fehlercode nicht mit S_OK identisch ist und angibt, dass die Seite nicht modifiziert ist. Dann könnte der Eigenschaftenrahmen möglicherweise die Schaltfläche Anwenden deaktivieren, sodass der Benutzer nicht sicherstellen kann, dass die Eigenschaftswerte aktuell sind.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

IPropertyPage