PropertyFilterOptions Enumeration
TOC
Collapse the table of content
Expand the table of content

PropertyFilterOptions Enumeration

 

Specifies which properties should be reported by type descriptors, specifically the GetProperties method. This enumeration is used to specify the value of the PropertyFilterAttribute.Filter property.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace:   System.ComponentModel
Assembly:  WindowsBase (in WindowsBase.dll)

[FlagsAttribute]
public enum PropertyFilterOptions

Member nameDescription
All

Return all properties.

Invalid

Return only those properties that are not valid given the current context of the object. See Remarks.

None

Return no properties

SetValues

Return only those properties that have local values currently set.

UnsetValues

Return only those properties whose local values are not set, or do not have properties set in an external expression store (such as binding or deferred resource).

Valid

Return any property that is valid on the object in the current scope. See Remarks.

This filter mechanism is only implemented by the custom DependencyPropertyDescriptor for DependencyObject.

Invalid and Valid are relevant only for attached properties. The validity of a property is determined by working with the following attributes: AttachedPropertyBrowsableForChildrenAttribute , AttachedPropertyBrowsableForTypeAttribute, AttachedPropertyBrowsableWhenAttributePresentAttribute which define the intended scope of the attached property in the object tree once the XAML is loaded. Designer applications that populate property grids and include attached properties in the grid must examine the value or presence of these attributes and the relative position of the current element versus either a parent or child element that "owns" the attached property. The owner-setter relationship together with the attribute values and PropertyFilterOptions will define whether a given attached property that is set on an element is valid or invalid.

.NET Framework
Available since 3.0
Return to top
Show:
© 2016 Microsoft