FrameworkPropertyMetadataOptions Enumeration

Specifies the types of framework-level property behavior that pertain to a particular dependency property in the Windows Presentation Foundation (WPF) property system.

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

Namespace: System.Windows
Assembly: PresentationFramework (in presentationframework.dll)
XML Namespace:

public enum FrameworkPropertyMetadataOptions
/** @attribute FlagsAttribute() */ 
public enum FrameworkPropertyMetadataOptions
public enum FrameworkPropertyMetadataOptions
<object property="EnumerationValue" .../>

 Member nameDescription
AffectsArrangeThe arrange pass of layout composition is affected by value changes to this dependency property.  
AffectsMeasureThe measure pass of layout compositions is affected by value changes to this dependency property.  
AffectsParentArrangeThe arrange pass on the parent element is affected by value changes to this dependency property. 
AffectsParentMeasureThe measure pass on the parent element is affected by value changes to this dependency property. 
AffectsRenderSome aspect of rendering or layout composition (other than measure or arrange) is affected by value changes to this dependency property. 
BindsTwoWayByDefaultThe BindingMode for data bindings on this dependency property defaults to TwoWay
InheritsThe values of this dependency property are inherited by child elements. 
JournalThe values of this dependency property should be saved or restored by journaling processes, or when navigating by Uniform resource identifiers (URIs).  
NoneNo options are specified; the dependency property uses the default behavior of the Windows Presentation Foundation (WPF) property system. 
NotDataBindableData binding to this dependency property is not allowed. 
OverridesInheritanceBehaviorThe values of this dependency property span separated trees for purposes of property value inheritance.  
SubPropertiesDoNotAffectRenderThe subproperties on the value of this dependency property do not affect any aspect of rendering. 

Use this enumeration when you construct a FrameworkPropertyMetadata instance where you want to specify one or more the framework-level metadata option settings.

You no longer use this enumeration after the constructor call. Instead, query the particular metadata option that was set during registration by checking the true or false value of a specific property of an existing FrameworkPropertyMetadata. These property names match the FrameworkPropertyMetadataOptions enumeration values except for NotDataBindable, which is IsNotDataBindable on the finished FrameworkPropertyMetadata.

The Journal option only specifies the intention to be journaled. The actual journaling may or may not be addressed by journaling services such as those that are present in the WPF viewer application. In particular, journaling has some known limitations if the element tree was constructed through code rather than XAML. For details, see Navigation Overview.

The following example calls the FrameworkPropertyMetadata constructor, and sets several options by using values from the FrameworkPropertyMetadataOptions enumeration.

fpm = new FrameworkPropertyMetadata(
    (FrameworkPropertyMetadataOptions.AffectsRender |
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0