PropertyPath.Path Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Ottiene o imposta la stringa che descrive il percorso.

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

Valore della proprietà

String

Stringa che descrive il percorso.

Commenti

La stringa contenuta in questa proprietà ha tre significati completamente diversi a seconda che PropertyPath venga usato un oggetto per un percorso di proprietà in modalità origine per un'associazione, per un percorso di proprietà in modalità singola in modalità destinazione per una destinazione storyboard o per un percorso complesso per una destinazione storyboard.

Se si usa questa PropertyPath opzione in modalità di origine per un'associazione, Path è una stringa che rappresenta un nome di proprietà o può essere una stringa che descrive un percorso "passaggio-through" della proprietà nel modello a oggetti CLR dell'oggetto che viene usato come origine per un'associazione. Per un percorso della proprietà di associazione, il carattere che identifica un "passaggio" è un punto (.). I riferimenti dell'indicizzatore (inclusi più indicizzatori e differenziazione dei tipi) sono supportati anche. Per altre informazioni sulla sintassi della stringa come specificamente utilizzata dall'oggetto Binding , vedere Binding.Path. Una proprietà usata come origine di associazione non deve essere una proprietà di dipendenza. Se l'associazione aggiorna in due modi, l'origine delle proprietà deve essere di lettura-scrittura. Si noti anche che la destinazione di associazione deve essere una proprietà di dipendenza. Per informazioni dettagliate, vedere Panoramica del data binding.

Se si usa questa opzione PropertyPath in modalità di destinazione per un percorso singolo per una destinazione storyboard, PropertyPath è una stringa che è un typeName. propertyName qualificata stringa nome proprietà dipendenza.

Se si usa questa opzione PropertyPath per un percorso complesso per una destinazione storyboard, Path è un formato stringa tokenizzato che descrive le relazioni dei vari oggetti specificati in PathParameters.

• Ogni elemento della matrice viene specificato in questo formato dall'indice della matrice per l'elemento racchiuso tra parentesi. Ad esempio, per specificare il primo elemento della matrice, il token stringa è (0).

• Le relazioni tra elementi ("passaggi" nel percorso) vengono specificate da un punto (.). La proprietà avanti del punto è il primo passaggio nel percorso, la proprietà dopo è il secondo passaggio e così via (è possibile specificare i passaggi oltre due). L'ultimo passaggio della catena rappresenta sempre la proprietà animata.

• Gli elementi all'interno delle proprietà della raccolta vengono accessibili con una sintassi dell'indicizzatore, con l'indice tra parentesi quadre ([ e ]). L'indicizzatore è aggiuntivo al token che rappresenta la proprietà. Ad esempio, il seguente è un percorso in due passaggi, con la combinazione di token nel primo passaggio che specifica il secondo elemento dall'interno dell'insieme di tale proprietà: (0)[1].(1) . Non è possibile usare un indicizzatore sull'ultima proprietà della catena; non è possibile animare la posizione effettiva della raccolta, è necessario animare una proprietà su tale oggetto.

La stringa di percorso per un PropertyPath viene in genere stabilita tramite i costruttori: la PropertyPath(Object) firma per le associazioni o le destinazioni storyboard a passaggio singolo, la PropertyPath(String, Object[]) firma per le destinazioni storyboard multi-step.

XAML: Quando si usa un oggetto PropertyPath per descrivere un riferimento a una proprietà in XAML, come valore dell'attributo, la stringa specificata viene prima gestita da un convertitore di tipi (PropertyPathConverter). Questo convertitore di tipi elabora quindi la stringa e in base alla relativa sintassi chiamerà una delle firme del PropertyPath costruttore. Questa indirettità tramite il convertitore di tipi che gestisce un valore di attributo è in genere il modo in cui si usa PropertyPath in XAML, anziché dichiarare un PropertyPath elemento oggetto e quindi applicare valori specifici agli attributi, ad esempio Path e PathParameters. Per altre informazioni, vedere Sintassi XAML propertyPath.

Utilizzo del testo XAML

I membri del PropertyPath tipo non vengono in genere impostati in una sintassi XAML diretta. Vedere la sezione Osservazioni.