IPropertyPage::IsPageDirty-Methode (ocidl.h)
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 |