FrameworkPropertyMetadataOptions 列挙型


Windows Presentation Foundation (WPF) プロパティ システムの特定の依存関係プロパティに関する、フレームワーク レベルのプロパティの動作の種類を指定します。Specifies the types of framework-level property behavior that pertain to a particular dependency property in the Windows Presentation Foundation (WPF) property system.

この列挙型には FlagsAttribute 属性があり、メンバー値ではビットごとの組み合わせを使用できます。

public enum class FrameworkPropertyMetadataOptions
public enum FrameworkPropertyMetadataOptions
type FrameworkPropertyMetadataOptions = 
Public Enum FrameworkPropertyMetadataOptions


AffectsArrange 2

レイアウト構成の配置パスは、この依存関係プロパティに対する値の変更の影響を受けます。The arrange pass of layout composition is affected by value changes to this dependency property.

AffectsMeasure 1

レイアウト構成の測定パスは、この依存関係プロパティに対する値の変更の影響を受けます。The measure pass of layout compositions is affected by value changes to this dependency property.

AffectsParentArrange 8

親要素の配置パスは、この依存関係プロパティに対する値の変更の影響を受けます。The arrange pass on the parent element is affected by value changes to this dependency property.

AffectsParentMeasure 4

親要素の測定パスは、この依存関係プロパティに対する値の変更の影響を受けます。The measure pass on the parent element is affected by value changes to this dependency property.

AffectsRender 16

レンダリングまたはレイアウト構成 (測定と配置を除く) の一部の側面が、この依存関係プロパティに対する値の変更の影響を受けます。Some aspect of rendering or layout composition (other than measure or arrange) is affected by value changes to this dependency property.

BindsTwoWayByDefault 256

この依存関係プロパティにおけるデータ バインディングの BindingMode は、既定では TwoWay に設定されます。The BindingMode for data bindings on this dependency property defaults to TwoWay.

Inherits 32

この依存関係プロパティの値は、子要素によって継承されます。The values of this dependency property are inherited by child elements.

Journal 1024

この依存関係プロパティの値は、ジャーナリング プロセスによって、または Uniform Resource Identifier (URI) によるナビゲーションが発生したときに、保存または復元される必要があります。The values of this dependency property should be saved or restored by journaling processes, or when navigating by Uniform resource identifiers (URIs).

None 0

オプションは指定されていません。依存関係プロパティは、WPF プロパティ システムの既定の動作を使用します。No options are specified; the dependency property uses the default behavior of the WPF property system.

NotDataBindable 128

この依存関係プロパティへのデータ バインディングは許可されません。Data binding to this dependency property is not allowed.

OverridesInheritanceBehavior 64

この依存関係プロパティの値は、プロパティ値の継承を目的として分けられたツリー全体に適用されます。The values of this dependency property span separated trees for purposes of property value inheritance.

SubPropertiesDoNotAffectRender 2048

この依存関係プロパティの値のサブプロパティは、レンダリングのどの側面にも影響しません。The subproperties on the value of this dependency property do not affect any aspect of rendering.

次の例ではFrameworkPropertyMetadata 、コンストラクターを呼び出し、 FrameworkPropertyMetadataOptions列挙体の値を使用していくつかのオプションを設定しています。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)


この列挙体は、 FrameworkPropertyMetadataインスタンスを作成するときに、1つまたは複数のフレームワークレベルのメタデータオプション設定を指定する場合に使用します。Use this enumeration when you construct a FrameworkPropertyMetadata instance, and you want to specify one or more the framework-level metadata option settings.

この列挙体は、コンストラクターの呼び出し後に使用されなくなりました。You no longer use this enumeration after the constructor call. 代わりに、既存true false のの特定のプロパティの値または値をチェックして、登録時に設定された特定のメタデータオプションに対してクエリをFrameworkPropertyMetadata実行します。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. これらのプロパティ名はFrameworkPropertyMetadataOptions IsNotDataBindable 、完了FrameworkPropertyMetadataしたで NotDataBindable を除き、列挙値と一致します。These property names match the FrameworkPropertyMetadataOptions enumeration values except for NotDataBindable, which is IsNotDataBindable on the finished FrameworkPropertyMetadata.

オプションJournalで指定されるのは、ジャーナリングする意図のみです。The Journal option only specifies the intention to be journaled. 実際のジャーナルは、WPF ビューアーアプリケーションに存在するものなど、ジャーナルサービスによってアドレス指定されない場合があります。The actual journaling may or may not be addressed by journaling services such as those that are present in the WPF viewer application. 特に、要素ツリーが XAML ではなくコードを使用して構築された場合、ジャーナリングには既知の制限事項がいくつかあります。In particular, journaling has some known limitations if the element tree was constructed through code rather than XAML. 詳細については、「ナビゲーションの概要」を参照してください。For details, see Navigation Overview.


プロパティ値の継承は非添付依存関係プロパティに対して機能するように見えますが、ランタイムツリー内の特定の要素境界を通じて非添付プロパティの継承動作は未定義です。Although property value inheritance might appear to work for nonattached dependency properties, the inheritance behavior for a nonattached property through certain element boundaries in the runtime tree is undefined. メタデータでDependencyProperty.RegisterAttached指定FrameworkPropertyMetadata.Inheritsしたプロパティを登録するには、常にメソッドを使用します。Always use the DependencyProperty.RegisterAttached method to register properties where you specify FrameworkPropertyMetadata.Inherits in the metadata.