IPropertyStoreCapabilities interface

Exposes a method that determines whether a property can be edited in the UI by the user.

Members

The IPropertyStoreCapabilities interface inherits from the IUnknown interface. IPropertyStoreCapabilities also has these types of members:

Methods

The IPropertyStoreCapabilities interface has these methods.

MethodDescription
IsPropertyWritable

Queries whether the property handler allows a specific property to be edited in the UI by the user.

 

Remarks

When to Implement

Property handlers implement this interface to disable a user's ability to edit specific properties. These properties are typically editable in the UI, but are not supported for writing by the property handler. For example, the property System.Author is typically editable. If a property handler author created a file type that exposed System.Author for reading, but could not support writing this property back, the handler author could return S_FALSE from IPropertyStoreCapabilities::IsPropertyWritable for System.Author.

The Shell user interfaces that allow property editing, such as the Details Pane and Details Tab of the Properties dialog, call this method as part of determining whether to allow editing of a specific property. This allows the Shell property editing UI to disable controls rather than showing errors when the property handler fails to set or commit the property value.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Propsys.h

IDL

Propsys.idl

 

 

Community Additions

ADD
Show:
© 2014 Microsoft