AutomationProperties Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce il supporto per ottenere o impostare valori a livello di istanza delle proprietà di automazione. Questi valori delle proprietà vengono impostati come proprietà associate (in genere in XAML) e integrano o sostituiscono i valori delle proprietà di automazione da AutomationPeer di un controllo.
public ref class AutomationProperties sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AutomationProperties final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AutomationPropertiesPublic NotInheritable Class AutomationProperties- Ereditarietà
- Attributi
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
|
Esempio
Suggerimento
Aprire l'app Raccolta WinUI 3 e vedere i principi di accessibilità seguenti in azione:
L'app Raccolta WinUI 3 include esempi interattivi della maggior parte dei controlli, delle funzionalità e delle funzionalità winUI 3. Ottenere l'app da Microsoft Store o ottenere il codice sorgente in GitHub
Commenti
AutomationProperties è la classe del servizio host per diverse proprietà associate XAML. Lo scopo di queste proprietà associate è abilitare l'impostazione di vari valori per istanza pertinenti al modo in cui un elemento dell'interfaccia utente viene segnalato al framework di accessibilità di Microsoft Automazione interfaccia utente. Ciò è utile nei casi in cui la progettazione della classe dell'elemento dell'interfaccia utente non inoltra già altri valori di proprietà correlati all'interfaccia utente come parte del relativo comportamento di integrazione o implementazione peer di Microsoft Automazione interfaccia utente o in cui il valore inoltrato non è il valore che si vuole segnalare a Microsoft Automazione interfaccia utente.
Per supportare l'accesso del processore XAML alle proprietà associate e anche per esporre operazioni get e set equivalenti al codice, ogni proprietà associata XAML ha una coppia di metodi della funzione di accesso Get e Set , che sono anche membri di AutomationProperties. Ad esempio, i metodi GetName e SetName supportano e forniscono il supporto di sola codice equivalente per la creazione di report dei valori name di automazione a Microsoft Automazione interfaccia utente, anziché usare la proprietà associata Name per impostarla in XAML. In alternativa, è possibile usare il sistema di proprietà di dipendenza per ottenere o impostare il valore della proprietà associata e segnala anche il valore sottostante a Microsoft Automazione interfaccia utente. Chiamare GetValue o SetValue, passando gli argomenti dell'identificatore della proprietà di dipendenza da impostare e un riferimento all'oggetto di destinazione in cui ottenere o impostare il valore.
Name (proprietà)
Delle varie proprietà associate, probabilmente quella più importante è Name. Ciò è dovuto al fatto che si tratta della proprietà Name a cui si accede più di frequente e segnalato dalla assistive technology quando gli utenti interagiscono con un'app in uno scenario di accessibilità. Il nome funge da identificatore leggibile per l'elemento dell'interfaccia utente.
Vari elementi dell'interfaccia utente dispongono di inoltro peer che possono fornire un valore Name predefinito basato su altre proprietà dell'elemento. Ad esempio, l'inoltro peer per la classe Button inoltra la valutazione ToStringdel contenuto Button e usa questa stringa come nome predefinito. Per eseguire l'override di tale impostazione predefinita o per specificare in altro modo un valore Name per qualsiasi caso di elemento dell'interfaccia utente in cui non è disponibile alcun nome di Microsoft Automazione interfaccia utente, impostare la proprietà associata Name su tale elemento in XAML. Per altre info sul motivo per cui un nome di Microsoft Automazione interfaccia utente è importante, vedi Informazioni di accessibilità di base. Per altre info su come verificare se un elemento ha già un nome fornito dal peer utile, vedi Test di accessibilità.
Per motivi di localizzazione, è consigliabile evitare valori stringa hardcoded per Name in XAML. Se si imposta la direttiva x:Uid sull'elemento, è possibile usare le risorse RESW per specificare come destinazione la proprietà e specificare valori diversi per la localizzazione. Per le proprietà associate, il modulo dell'identificatore di risorsa richiede la qualifica completa della proprietà associata in formato XAML, incluso lo spazio dei nomi e un prefisso using: . Ad esempio, per impostare come destinazione il valore della proprietà associata AutomationProperties.Name in una risorsa con valore di direttiva x:Uid "sendButton", il valore del nome dell'elemento di dati nelle risorse RESW è sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name
Vedi Proprietà associate per un elenco completo (per altre info su ogni proprietà associata, vedi il campo Identificatore di ogni proprietà).
Cronologia delle versioni
| Versione di Windows | Versione dell'SDK | Valore aggiunto |
|---|---|---|
| 1511 | 10586 | GetLandmarkType |
| 1511 | 10586 | GetLocalizedLandmarkType |
| 1511 | 10586 | SetLandmarkType |
| 1511 | 10586 | SetLocalizedLandmarkType |
| 1607 | 14393 | GetDescribedBy |
| 1607 | 14393 | GetFlowsFrom |
| 1607 | 14393 | GetFlowsTo |
| 1607 | 14393 | GetFullDescription |
| 1607 | 14393 | GetIsDataValidForForm |
| 1607 | 14393 | GetIsPeripheral |
| 1607 | 14393 | GetLocalizedControlType |
| 1607 | 14393 | SetFullDescription |
| 1607 | 14393 | SetIsDataValidForForm |
| 1607 | 14393 | SetIsPeripheral |
| 1607 | 14393 | SetLocalizedControlType |
| 1703 | 15063 | GetCulture |
| 1703 | 15063 | SetCulture |
| 1803 | 17134 | GetHeadingLevel |
| 1803 | 17134 | SetHeadingLevel |
| 1809 | 17763 | GetIsDialog |
| 1809 | 17763 | SetIsDialog |
Proprietà
Proprietà associate
| AcceleratorKey |
Ottiene o imposta una stringa contenente le combinazioni di tasti di scelta rapida (denominata anche tasto di scelta rapida) per l'elemento di automazione. |
| AccessibilityView |
Ottiene o imposta la modalità di visualizzazione albero di Microsoft Automazione interfaccia utente per un elemento. |
| AccessKey |
Ottiene o imposta una stringa contenente il carattere chiave di accesso per l'elemento di automazione. |
| Annotations |
Ottiene un elenco di oggetti annotazione in un documento, ad esempio commento, intestazione, piè di pagina e così via. |
| AutomationControlType |
Ottiene o imposta il tipo di controllo per Microsoft Automazione interfaccia utente. |
| AutomationId |
Ottiene o imposta la stringa che identifica in modo univoco l'elemento in Microsoft Automazione interfaccia utente. |
| ControlledPeers |
Ottiene una raccolta di elementi di automazione che possono essere modificati dall'elemento di automazione specificato. |
| Culture |
Ottiene o imposta l'identificatore delle impostazioni locali per l'elemento di automazione , ad esempio 0x0409 per "en-US" o inglese (Stati Uniti)). |
| DescribedBy |
Ottiene una matrice di elementi che forniscono altre informazioni sull'elemento di automazione. |
| FlowsFrom |
Ottiene una matrice di elementi di automazione che suggerisce l'ordine di lettura prima dell'elemento di automazione corrente. |
| FlowsTo |
Ottiene una matrice di elementi di automazione che suggerisce l'ordine di lettura dopo l'elemento di automazione corrente. |
| FullDescription |
Ottiene o imposta una stringa localizzata contenente testo di descrizione estesa per un elemento. |
| HeadingLevel |
Ottiene o imposta il livello di intestazione per un elemento Automazione interfaccia utente. |
| HelpText |
Ottiene o imposta una stringa di testo della Guida associata all'elemento di automazione. |
| IsDataValidForForm |
Ottiene o imposta un valore che indica se i dati sono validi per il modulo. |
| IsDialog |
Ottiene o imposta un valore che indica se l'elemento di automazione è una finestra di dialogo. |
| IsPeripheral |
Ottiene o imposta un valore che indica se l'elemento di automazione rappresenta l'interfaccia utente periferica. |
| IsRequiredForForm |
Ottiene o imposta un valore che indica se l'elemento deve essere compilato in un modulo. |
| ItemStatus |
Ottiene o imposta una descrizione dello stato di un elemento in un elemento. |
| ItemType |
Ottiene o imposta una descrizione del tipo di elemento specificato. |
| LabeledBy |
Ottiene o imposta l'elemento di automazione contenente l'etichetta di testo per questo elemento. |
| LandmarkType |
Ottiene o imposta un identificatore di tipo punto di riferimento associato a un elemento. |
| Level |
Ottiene o imposta un intero basato su 1 che descrive la posizione di un elemento all'interno di strutture gerarchiche o interrotte. |
| LiveSetting |
Ottiene o imposta il valore dell'impostazione dinamica per l'elemento specificato, supportato da un elemento di automazione che rappresenta un'area dinamica. |
| LocalizedControlType |
Ottiene o imposta una stringa di testo localizzata che descrive il tipo di controllo rappresentato dall'elemento di automazione. |
| LocalizedLandmarkType |
Ottiene o imposta una stringa di testo localizzata che descrive il tipo di punto di riferimento rappresentato dall'elemento di automazione. |
| Name |
Ottiene o imposta il nome Automazione interfaccia utente dell'elemento. |
| PositionInSet |
Ottiene o imposta un intero basato su 1 che descrive la posizione ordinale dell'elemento all'interno di un set di elementi considerati pari a pari. |
| SizeOfSet |
Ottiene o imposta il numero di elementi in un set di elementi considerati di pari livello. |