次の方法で共有


FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender プロパティ

定義

依存関係プロパティのサブプロパティが格納オブジェクトのレンダリングに影響しないかどうかを示す値を取得または設定します。

public:
 property bool SubPropertiesDoNotAffectRender { bool get(); void set(bool value); };
public bool SubPropertiesDoNotAffectRender { get; set; }
member this.SubPropertiesDoNotAffectRender : bool with get, set
Public Property SubPropertiesDoNotAffectRender As Boolean

プロパティ値

Boolean

サブプロパティ値の変更がレンダリングに影響しない場合は true。それ以外の場合は false。 既定値は、false です。

例外

メタデータがシールされるよう、かつメタデータのプロパティを設定できないように、メタデータは依存関係プロパティの操作に既に適用されています。

注釈

このメタデータ オプションは、参照型である依存関係プロパティに関連し、その型には独自のプロパティ値があります。 通常、レイアウト システム ロジックでは、サブプロパティを持つ依存関係プロパティがレイアウトに影響する可能性があると想定します。これは、すべてのサブプロパティで変更をチェックする方が、実際に別のレンダリング パスを実行するよりも時間がかかるためです。 このオプションを設定すると true 、WPF フレームワーク レベルのレイアウト システム実装のパフォーマンスを最適化するのに役立ちます。

の派生クラスの PropertyMetadata プロパティは、通常、オブジェクト モデルで読み取り/書き込みとして定義されます。 これは、インスタンスの初期化後に調整できるようにするためです。 ただし、メタデータが 、またはOverrideMetadataプロパティ システムへのRegisterAddOwner呼び出しの一部として使用されると、そのメタデータ インスタンスとメタデータの詳細を伝えるプロパティが不変と見なされるようになります。 このメタデータ インスタンスの後IsSealedtrueにこのプロパティを設定しようとすると、例外が発生します。

XAML テキストの使用法

このクラスのメンバーは、通常、XAML では使用されません。

適用対象

こちらもご覧ください