次の方法で共有


プロパティ値の継承

更新 : 2007 年 11 月

プロパティ値の継承は、Windows Presentation Foundation (WPF) プロパティ システムの機能です。プロパティ値の継承により、要素のツリー内の子要素は、親要素から特定のプロパティの値を取得できます。これは、最も近い親要素のいずれかにこのプロパティ値が既に設定されているため、その値を継承することで行われます。親要素もプロパティ値の継承を通じてその値を取得している場合があるため、システムはページ ルートまで再帰している可能性があります。プロパティ値の継承は、プロパティ システムの既定の動作ではありません。あるプロパティに子要素でのプロパティ値の継承を実行させるには、そのプロパティに特定のメタデータを設定する必要があります。

このトピックには次のセクションが含まれています。

  • プロパティ値の継承は包含継承である
  • プロパティ値の継承を実際に適用する
  • カスタム プロパティを継承可能にする
  • ツリー境界を越えてプロパティ値を継承する
  • 関連トピック

プロパティ値の継承は包含継承である

ここで言う "継承" は、型や一般的なオブジェクト指向プログラミングのコンテキストにおける継承 (派生クラスがその基本クラスからメンバ定義を継承する) とは若干異なる概念です。この一般的な意味での継承は、WPF でも使用されます。さまざまな基本クラスで定義されたプロパティは、要素として使用される場合の派生 XAML クラスの属性として、およびコードのメンバとして公開されます。プロパティ値の継承は、要素のツリー内の親子のリレーションシップに基づいて、ある要素から別の要素にプロパティ値が継承されるしくみに特に関連します。要素のツリーが最も直接的に認識されるのは、XAML マークアップでアプリケーションを定義する際にさまざまな要素を別の要素内に入れ子にする場合です。オブジェクトのツリーはプログラムで作成することもできます。これを行うには、指定したオブジェクトのコレクションに別のオブジェクトを追加します。完成したツリーでも、実行時にプロパティ値の継承が同様に動作します。

プロパティ値の継承を実際に適用する

WPFAPI には、プロパティの継承が有効なプロパティがいくつか含まれています。これらのプロパティの一般的なシナリオは次のとおりです。これらのプロパティは、ページごとに一度だけ設定するのが適していますが、いずれかの基本要素クラスのメンバでもあるため、ほとんどの子要素にも存在することになります。たとえば、FlowDirection プロパティは、フロー コンテンツをページ上に表示および配置する方向を制御します。通常、テキスト フローの概念は、すべての子要素で一貫して処理される必要があります。要素ツリーのあるレベルにおいて、何らかの理由でユーザーまたは環境の操作によってフロー方向がリセットされた場合は、一般に要素全体でリセットする必要があります。FlowDirection プロパティを継承すると、アプリケーション内の各ページの表示ニーズをすべて含む要素ツリー内のレベルで、値を 1 回設定またはリセットするだけで済むようになります。初期既定値さえも同様の方法で値を継承します。プロパティ値の継承モデルでは、要素の値を個別にリセットすることもできます。これは、複数のフロー方向の混在を意図したまれなケースに対応するためです。

カスタム プロパティを継承可能にする

カスタム プロパティのメタデータを変更することで、独自のカスタム プロパティを継承可能にすることもできます。ただし、プロパティを継承可能にする場合は、パフォーマンスについて考慮する必要があります。ローカル値や、スタイル、テンプレート、またはデータ バインディングから取得した値がそのプロパティに設定されていない場合、継承可能なプロパティは、それ自身に割り当てられた値を論理ツリー内のすべての子要素に提供します。

プロパティを値の継承に参加させるには、「方法 : 添付プロパティを登録する」の説明に従ってカスタム添付プロパティを作成します。メタデータ (FrameworkPropertyMetadata) を指定してプロパティを登録し、そのメタデータ内のオプション設定で "継承" オプションを指定します。また、値が継承されるようになったため、プロパティに既定値が設定されていることも確認します。プロパティを添付プロパティとして登録しましたが、"非添付" の依存関係プロパティの場合と同様に、所有者型で get アクセスおよび set アクセスのプロパティ "ラッパー" を作成することもできます。これにより、所有者型または派生型で直接プロパティ ラッパーを使用して、または、DependencyObject で添付プロパティ構文を使用して、継承可能なプロパティを設定できます。

添付プロパティは概念的にはグローバル プロパティに似ており、任意の DependencyObject の値をチェックし、有効な結果を取得できます。添付プロパティの典型的なシナリオとして、子要素のプロパティ値を設定する場合があります。このシナリオは、該当のプロパティが、ツリー内の各要素 (DependencyObject) の添付プロパティとして常に暗黙的に存在する添付プロパティの場合に、さらに効果的です。

ms753197.alert_note(ja-jp,VS.90).gifメモ :

プロパティ値の継承は、非添付依存関係プロパティのために機能しているように見えることがありますが、ランタイム ツリーでの特定の要素の境界を介する非添付プロパティの継承動作は定義されていません。メタデータで Inherits を指定した場合は、必ず RegisterAttached を使用してプロパティを登録します。

ツリー境界を越えてプロパティ値を継承する

プロパティの継承は、要素のツリーを走査して行われます。多くの場合、このツリーは論理ツリーに対応します。しかし、要素ツリーを定義するマークアップ内に、Brush など、WPF コア レベルのオブジェクトを含めると、連続しない論理ツリーが作成されます。論理ツリーは WPF フレームワーク レベルの概念であるため、本当の論理ツリーは、Brush を通じて概念的に拡張されません。LogicalTreeHelper のメソッドを使用すると、これが反映された結果を確認できます。ただし、継承可能なプロパティが添付プロパティとして登録されており、意図的な継承ブロッキング境界 (Frame など) がない限り、プロパティ値の継承は、論理ツリー内のこのギャップを埋めることができ、継承された値を渡すことができます。

参照

概念

依存関係プロパティのメタデータ

添付プロパティの概要

依存関係プロパティ値の優先順位