FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
依存関係プロパティのサブプロパティが、包含オブジェクトのレンダリングに影響しないかどうかを示す値を取得または設定します。
public:
property bool SubPropertiesDoNotAffectRender { bool get(); void set(bool value); };public bool SubPropertiesDoNotAffectRender { get; set; }member this.SubPropertiesDoNotAffectRender : bool with get, setPublic Property SubPropertiesDoNotAffectRender As Booleanプロパティ値
true サブプロパティ値への変更が変更された場合にレンダリングに影響しない場合。それ以外の場合は false。 既定値は false です。
例外
メタデータがシールされ、メタデータのプロパティを設定できないように、メタデータは既に依存関係プロパティ操作に適用されています。
注釈
このメタデータ オプションは、参照型である依存関係プロパティに関連します。この型には独自のプロパティ値があります。 通常、レイアウト システム ロジックでは、サブプロパティを持つ依存関係プロパティがレイアウトに影響する可能性があると想定します。これは、すべてのサブプロパティの変更をチェックする方が、実際に別のレンダー パスを実行するよりも時間がかかるためです。 このオプションを true に設定すると、WPF フレームワーク レベルのレイアウト システム実装のパフォーマンスを最適化するのに役立ちます。
PropertyMetadataの派生クラスのプロパティは、通常、オブジェクト モデルで読み取り/書き込みとして定義されます。 これは、インスタンスの初期化後に調整できるようにするためです。 ただし、メタデータが Register、 AddOwner、または OverrideMetadataの呼び出しの一部として使用されると、プロパティ システムによって、メタデータの詳細を伝えるメタデータ インスタンスとプロパティが不変と見なされるようになります。 このメタデータ インスタンスで IsSealed が true された後にこのプロパティを設定しようとすると、例外が発生します。
XAML テキストの使用法
このクラスのメンバーは、通常、XAML では使用されません。
