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