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, zda PropertyPath se používá pro cestu vlastnosti zdrojového režimu pro vazbu, pro cestu vlastnosti v cílovém režimu s jedním krokem pro cíl scénáře nebo pro složitou cestu pro cíl scénáře.

Pokud se používá PropertyPath 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 Binding objektem, naleznete v tématu Binding.Path. Vlastnost použitá jako zdroj vazby nemusí být vlastností závislosti. Pokud se vazba aktualizuje obousměrně, zdroj vlastnosti musí být pro čtení i zápis. Všimněte si také, že cíl vazby musí být vlastnost závislostí. Podrobnosti najdete vpřehledu datových vazeb .

Pokud tento PropertyPath postup použijete v cílovém režimu pro cestu s jedním krokem pro cíl scénáře, PropertyPath je řetězec, který je typeName.propertyName qualified dependency property name string.

Pokud tuto PropertyPath možnost používáte pro složitou cestu pro cíl scénáře, je tokenizovaný formát řetězce, Path 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. Chcete-li 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 za druhým krokem a tak dále (můžete zadat kroky nad rámec dvou). Poslední krok v řetězci vždy představuje vlastnost, která se animuje.

• K položkám v rámci vlastností kolekce se přistupuje pomocí syntaxe indexeru s indexem v hranatých závorkách ([ a ]). Indexer se přičítá k tokenu představujícímu 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) . Indexer nelze použít u poslední vlastnosti v řetězci; nelze animovat skutečnou pozici kolekce, musíte animovat vlastnost u daného objektu.

Řetězec cesty pro a je PropertyPath 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 scénáře s více kroky.

XAML: Když 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 typu (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ů, který zpracovává hodnotu atributu, je obecně způsob použití PropertyPath v XAML, nikoli deklarování PropertyPath elementu objektu a následné použití konkrétních hodnot na atributy, jako PathPathParametersje a . Další informace naleznete v tématu PropertyPath XAML Syntaxe.

Použití textu XAML

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