PropertyPath.Path プロパティ

public:
 property System::String ^ Path { System::String ^ get(); void set(System::String ^ value); };

public string Path { get; set; }

member this.Path : string with get, set

Public Property Path As String

プロパティ値

パスを記述する文字列。

注釈

このプロパティに含まれる文字列は、バインディングのソース モード プロパティ パス、ストーリーボード ターゲットのターゲット モードの単一ステップ プロパティ パス、またはストーリーボード ターゲットの複雑なパスに対して、 PropertyPath が使用されているかどうかによって、まったく異なる 3 つの意味を持ちます。

バインディングのソース モードでこの PropertyPath を使用する場合、 Path はプロパティ名を表す文字列であるか、バインディングのソースとして使用されているオブジェクトの CLR オブジェクト モデルのプロパティへの "ステップスルー" パスを記述する文字列にすることができます。 バインディング プロパティ パスの場合、"step" を識別する文字はドット (.) です。 インデクサー参照 (複数のインデクサー、型の区別を含む) もサポートされています。 Binding オブジェクトで特に使用される文字列の構文の詳細については、Binding.Pathを参照してください。 バインディング ソースとして使用されるプロパティは、依存関係プロパティである必要はありません。 バインディングが双方向で更新される場合、プロパティ ソースは読み取り/書き込みである必要があります。 また、バインディング ターゲットは依存関係プロパティである必要があることにも注意してください。 詳細については、「データ バインディングの概要」を参照してください。

ストーリーボード ターゲットの単一ステップ パスに対してターゲット モードでこの PropertyPath を使用する場合、 PropertyPath は typeName である文字列です。propertyName 修飾依存関係プロパティ名文字列。

ストーリーボード ターゲットの複雑なパスにこの PropertyPath を使用する場合、 Path はトークン化された文字列形式であり、 PathParametersで指定されたさまざまなオブジェクトのリレーションシップを記述します。

• 配列内の各項目は、かっこで囲まれた項目の配列インデックスによって、この形式で指定されます。 たとえば、配列の最初の項目を指定するには、文字列トークンが (0)。

• 項目間のリレーションシップ (パス内の "ステップ" ) はドット (.) で指定されます。 ドットの前方のプロパティはパスの最初のステップ、後のプロパティは 2 番目のステップなどです (2 を超えるステップを指定できます)。 チェーンの最後のステップは、アニメーション化されるプロパティを常に表します。

• コレクション プロパティ内の項目には、インデクサー構文を使用してアクセスします。インデックスは角かっこ ([ と ]) 内にあります。 インデクサーは、プロパティを表すトークンに追加されます。 たとえば、次の 2 つの手順のパスは、最初の手順のトークンの組み合わせで、そのプロパティのコレクション内から 2 番目の項目を指定します: (0)[1].(1) 。 チェーン内の最後のプロパティでインデクサーを使用することはできません。実際のコレクション位置をアニメーション化することはできません。そのオブジェクトのプロパティをアニメーション化する必要があります。

PropertyPathのパス文字列は、通常、コンストラクターを介して確立されます。バインディングまたはシングルステップストーリーボード ターゲットのPropertyPath(Object)署名、マルチステップ ストーリーボード ターゲットのPropertyPath(String, Object[])署名。

Xaml：PropertyPathを使用して XAML のプロパティ参照を属性値として記述する場合、指定した文字列は最初に型コンバーター (PropertyPathConverter) によって処理されます。 この型コンバーターは文字列を処理し、その構文に基づいて、 PropertyPath コンストラクターシグネチャのいずれかを呼び出します。 属性値を処理する型コンバーターによるこの間接参照は、通常、PropertyPath オブジェクト要素を宣言し、PropertyPathやPathなどの属性に特定の値を適用するのではなく、XAML でPathParametersを使用する方法です。 詳細については、「 PropertyPath XAML 構文」を参照してください。

XAML テキストの使用法

通常、 PropertyPath 型のメンバーは、直接 XAML 構文では設定されません。 「解説」を参照してください。