IPropertyStoreCapabilities-Schnittstelle (propsys.h)

Macht eine Methode verfügbar, die bestimmt, ob eine Eigenschaft vom Benutzer in der Benutzeroberfläche bearbeitet werden kann.

Vererbung

Die IPropertyStoreCapabilities-Schnittstelle erbt von der IUnknown-Schnittstelle . IPropertyStoreCapabilities verfügt auch über folgende Membertypen:

Methoden

Die IPropertyStoreCapabilities-Schnittstelle verfügt über diese Methoden.

 
IPropertyStoreCapabilities::IsPropertyWritable

Fragt ab, ob der Eigenschaftenhandler das Bearbeiten einer bestimmten Eigenschaft auf der Benutzeroberfläche durch den Benutzer zulässt.

Hinweise

Wann sollte implementiert werden?

Eigenschaftenhandler implementieren diese Schnittstelle, um die Fähigkeit eines Benutzers zum Bearbeiten bestimmter Eigenschaften zu deaktivieren. Diese Eigenschaften können in der Regel auf der Benutzeroberfläche bearbeitet werden, werden aber vom Eigenschaftenhandler nicht zum Schreiben unterstützt. Beispielsweise ist die Eigenschaft System.Author in der Regel bearbeitbar. Wenn ein Eigenschaftenhandlerautor einen Dateityp erstellt hat, der System.Author zum Lesen verfügbar gemacht hat, aber das Schreiben dieser Eigenschaft nicht unterstützen konnte, könnte der Handlerautor S_FALSE aus IPropertyStoreCapabilities::IsPropertyWritable für System.Author zurückgeben.

Die Shell-Benutzeroberflächen, die die Bearbeitung von Eigenschaften ermöglichen, z. B. der Detailbereich und die Registerkarte Details des Dialogfelds Eigenschaften, rufen diese Methode auf, um zu bestimmen, ob die Bearbeitung einer bestimmten Eigenschaft zulässig ist. Dadurch kann die Benutzeroberfläche der Shell-Eigenschaftsbearbeitung Steuerelemente deaktivieren, anstatt Fehler anzuzeigen, wenn der Eigenschaftenhandler den Eigenschaftswert nicht festlegen oder committen kann.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile propsys.h