Windows Dev Center

Espandi Riduci a icona

AutomationProperties.Name Attached Property

Ottiene o imposta il nome dell'automazione interfaccia utente dell'elemento.


<object AutomationProperties.Name="nameString" />

XAML Values

nameString

Nome dell'elemento.

Note

AutomationProperties.Name è una proprietà associata, che supporta un utilizzo di XAML. Quando si ottiene questa proprietà nel codice, utilizzare l'oggetto GetName. Quando si imposta questa proprietà nel codice, utilizzare l'oggetto SetName. Negli utilizzi di codice il parametro di destinazione è l'oggetto su cui è impostato il valore della proprietà associata. Un altro modo per ottenere o impostare il valore nel codice è utilizzare il sistema di proprietà di dipendenza, chiamando GetValue o SetValue e passando NameProperty come identificatore della proprietà di dipendenza.

Lo scopo delle proprietà associate AutomationProperties.Name e AutomationProperties è fornire valori dell'istanza per il comportamento che non siano già presenti o definiti nella definizione della classe del controllo o nel modello generico applicato di un controllo.

AutomationProperties.Name è la proprietà di automazione che i client di automazione interfaccia utente scelgono con maggiore probabilità. Le implementazioni peer predefinite per la maggior parte dei controlli dell'interfaccia utente includono logica che tenta di attraversare l'albero di automazione per trovare contenuto di testo e che utilizza quest'ultimo come impostazione predefinita generata dal controllo per AutomationProperties.Name. Ad esempio, un'istanza predefinita di un controllo Button utilizza un peer ButtonAutomationPeer. Questo peer implementa un comportamento che promuove qualsiasi testo interno presente nel contenuto del pulsante come valore della proprietà Name per l'automazione dell'interfaccia utente. Pertanto, prima di impostare regolarmente AutomationProperties.Name su tutti gli elementi di interfaccia utente, è possibile testare prima la struttura di automazione interfaccia utente in fase di esecuzione. Se si utilizza il comportamento peer predefinito, è spesso possibile sfruttare altri meccanismi già disponibili. Ad esempio, se Binding viene utilizzato per impostare il Content di un oggetto Button, il comportamento di runtime dinamico del peer di automazione può utilizzare l'associazione valutata che potrebbe utilizzare stringhe e dizionari risorse localizzati, per evitare la necessità di localizzare separatamente il valore AutomationProperties.Name.

Requisiti

Client supportato minimo

Windows 8

Server supportato minimo

Windows Server 2012

Spazio dei nomi

Windows.UI.Xaml.Automation

Metadati

Windows.winmd

Vedere anche

AutomationProperties

 

 

Mostra:
© 2015 Microsoft