PropertyPath.Path Vlastnost

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Získá nebo nastaví řetězec, který popisuje cestu.

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

Hodnota vlastnosti

String

Řetězec, který popisuje cestu.

Poznámky

Řetězec obsažený v této vlastnosti má tři zcela odlišné významy v závislosti na tom, jestli PropertyPath se používá pro cestu vlastnosti zdrojového režimu pro vazbu, pro cestu k cílovému cíli v režimu cíle scénáře nebo pro složitou cestu pro cíl scénáře.

Pokud tento PropertyPath parametr používáte ve zdrojovém režimu pro vazbu, Path je řetězec představující název vlastnosti nebo může být řetězec, který popisuje "krok-průchozí" cestu k vlastnosti v objektovém modelu CLR objektu, který se používá jako zdroj pro vazbu. Pro cestu vlastnosti vazby je znak, který identifikuje "krok" tečkou (.). Podporují se také odkazy na indexery (včetně více indexerů a diferenciace typů). Další podrobnosti o syntaxi řetězce, jak je výslovně používán objektem Binding , najdete v tématu Binding.Path. Vlastnost použitá jako zdroj vazby nemusí být vlastnost závislostí. Pokud se vazba aktualizuje obousměrně, musí být zdroj vlastnosti read-write. Všimněte si také, že cíl vazby musí být vlastnost závislostí. Podrobnosti najdete v tématu Přehled datových vazeb.

Pokud tuto PropertyPath funkci používáte v cílovém režimu pro jednu krokovou cestu pro cíl scénáře, PropertyPath je řetězec, který je typeName.propertyName kvalifikovaný řetězec názvu vlastnosti závislosti.

Pokud tuto PropertyPath funkci používáte pro složitou cestu pro cíl scénáře, Path je tokenizovaný formát řetězce, který popisuje vztahy různých objektů uvedených v objektu PathParameters.

• Každá položka v poli je určena v tomto formátu indexem pole pro položku uzavřenou v závorkách. Pokud chcete například zadat první položku v poli, je token (0)řetězce .

• Relace mezi položkami ("kroky" v cestě) jsou určeny tečkou (.). Vlastnost vpřed tečky je prvním krokem v cestě, vlastnost po druhém kroku a tak dále (můžete zadat kroky nad dvěma). Poslední krok v řetězci vždy představuje vlastnost, která se animuje.

• K položkám ve vlastnostech kolekce se přistupuje pomocí syntaxe indexeru s indexerem v hranatých závorkách ([ a ]). Indexer je doplňkem tokenu představujícího vlastnost. Například následující je dvoustupňová cesta s kombinací tokenu v prvním kroku určující druhou položku z kolekce této vlastnosti: (0)[1].(1) . Nelze použít indexer na poslední vlastnosti v řetězu; Nemůžete animovat skutečnou pozici kolekce, musíte animovat vlastnost daného objektu.

Řetězec cesty pro a PropertyPath je obvykle vytvořen prostřednictvím konstruktorů: PropertyPath(Object) podpis pro vazby nebo cíle scénáře s jedním krokem, PropertyPath(String, Object[]) podpis pro cíle vícestupňového scénáře.

XAML: Pokud použijete PropertyPath k popisu odkazu na vlastnost v XAML jako hodnotu atributu, řetězec, který zadáte, je nejprve zpracován převaděčem typů (PropertyPathConverter). Tento převaděč typů pak zpracuje řetězec a na základě jeho syntaxe zavolá jeden z podpisů konstruktoru PropertyPath . Tato nepřímost prostřednictvím převaděče typů zpracovávajících hodnotu atributu je obecně způsob použití PropertyPath v XAML, nikoli deklarování elementu PropertyPath objektu a následné použití konkrétních hodnot u atributů, jako je a Path PathParameters. Další informace naleznete v tématu Syntaxe XAML PropertyPath.

Použití textu XAML

PropertyPath Členové typu se obvykle nenastavují v přímé syntaxi XAML. Viz poznámky.