Condividi tramite


AutomationProperties Classe

Definizione

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 AutomationProperties
Public NotInheritable Class AutomationProperties
Ereditarietà
Object Platform::Object IInspectable AutomationProperties
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à

AcceleratorKeyProperty

Identifica la proprietà associata AutomationProperties.AcceleratorKey .

AccessibilityViewProperty

Identifica la proprietà associata AutomationProperties.AccessibilityView .

AccessKeyProperty

Identifica la proprietà associata AutomationProperties.AccessKey .

AnnotationsProperty

Identifica la proprietà associata AutomationProperties.Annotations .

AutomationControlTypeProperty

Identifica la proprietà associata AutomationProperties.AutomationControlType .

AutomationIdProperty

Identifica la proprietà associata AutomationProperties.AutomationId .

ControlledPeersProperty

Identifica la proprietà associata AutomationProperties.ControlledPeers .

CultureProperty

Identifica la proprietà associata AutomationProperties.Culture .

DescribedByProperty

Identifica la proprietà associata AutomationProperties.DescribedBy .

FlowsFromProperty

Identifica la proprietà associata FlowFrom .

FlowsToProperty

Identifica la proprietà associata FlowTo .

FullDescriptionProperty

Identifica la proprietà associata XAML AutomationProperties.FullDescription .

HeadingLevelProperty

Identifica la proprietà associata XAML HeadingLevel .

HelpTextProperty

Identifica la proprietà associata AutomationProperties.HelpText XAML.

IsDataValidForFormProperty

Identifica la proprietà associata AutomationProperties.IsDataValidForForm XAML.

IsDialogProperty

Identifica la proprietà associata XAML AutomationProperties.IsDialog .

IsPeripheralProperty

Identifica la proprietà associata AutomationProperties.IsPeripheral XAML.

IsRequiredForFormProperty

Identifica la proprietà associata AutomationProperties.IsRequiredForForm XAML.

ItemStatusProperty

Identifica la proprietà associata AutomationProperties.ItemStatus XAML.

ItemTypeProperty

Identifica la proprietà associata XAML AutomationProperties.ItemType .

LabeledByProperty

Identifica la proprietà associata AutomationProperties.LabeledBy XAML.

LandmarkTypeProperty

Identifica la proprietà associata AutomationProperties.LandmarkType XAML.

LevelProperty

Identifica la proprietà associata XAML AutomationProperties.Level .

LiveSettingProperty

Identifica la proprietà associata AUTOMATIONProperties.LiveSetting XAML.

LocalizedControlTypeProperty

Identifica la proprietà associata AutomationProperties.LocalizedControlType XAML, ovvero una stringa di testo che descrive il tipo di controllo rappresentato dall'elemento di automazione.

LocalizedLandmarkTypeProperty

Identifica la proprietà associata AutomationProperties.LocalizedLandmarkType XAML.

NameProperty

Identifica la proprietà associata XAML AutomationProperties.Name .

PositionInSetProperty

Identifica la proprietà associata AutomationProperties.PositionInSet XAML.

SizeOfSetProperty

Identifica la proprietà associata XAML AutomationProperties.SizeOfSet .

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.

Metodi

GetAcceleratorKey(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.AcceleratorKey per l'oggetto DependencyObject specificato.

GetAccessibilityView(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.AccessibilityView per l'oggetto DependencyObject specificato.

GetAccessKey(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.AccessKey per l'oggetto DependencyObject specificato.

GetAnnotations(DependencyObject)

Ottiene il valore della proprietà AutomationProperties.Annotations per l'oggetto DependencyObject specificato.

GetAutomationControlType(UIElement)

Ottiene il valore della proprietà associata AutomationProperties.AutomationControlType per l'oggetto DependencyObject specificato.

GetAutomationId(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.AutomationId per l'oggetto DependencyObject specificato.

GetControlledPeers(DependencyObject)

Metodo di utilità statico che recupera l'elenco di peer controllati da un proprietario di destinazione.

GetCulture(DependencyObject)

Ottiene il valore della proprietà associata XAML Cultura per l'oggetto DependencyObject specificato.

GetDescribedBy(DependencyObject)

Ottiene una raccolta di elementi che forniscono altre informazioni sull'elemento di automazione specificato.

GetFlowsFrom(DependencyObject)

Ottiene un elenco di elementi di automazione che suggeriscono l'ordine di lettura prima dell'elemento di automazione specificato.

GetFlowsTo(DependencyObject)

Ottiene un elenco di elementi di automazione che suggeriscono l'ordine di lettura dopo l'elemento di automazione specificato.

GetFullDescription(DependencyObject)

Ottiene il valore della proprietà AutomationProperties.FullDescription per l'oggetto DependencyObject specificato.

GetHeadingLevel(DependencyObject)

Ottiene il valore della proprietà AutomationProperties.HeadingLevel per l'oggetto DependencyObject specificato.

GetHelpText(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.HelpText per l'oggetto DependencyObject specificato.

GetIsDataValidForForm(DependencyObject)

Ottiene il valore della proprietà AutomationProperties.IsDataValidForForm per l'oggetto DependencyObject specificato.

GetIsDialog(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.IsDialog per l'oggetto DependencyObject specificato.

GetIsPeripheral(DependencyObject)

Ottiene un valore booleano che indica se l'elemento specificato rappresenta l'interfaccia utente periferica.

GetIsRequiredForForm(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.IsRequiredForForm per l'oggetto DependencyObject specificato.

GetItemStatus(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.ItemStatus per l'oggetto DependencyObject specificato.

GetItemType(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.ItemType per l'oggetto DependencyObject specificato.

GetLabeledBy(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.LabeledBy per l'oggetto DependencyObject specificato.

GetLandmarkType(DependencyObject)

Ottiene il valore della proprietà associata al tipo di punto di riferimento per l'oggetto DependencyObject specificato.

GetLevel(DependencyObject)

Ottiene il valore della proprietà AutomationProperties.Level per l'elemento specificato.

GetLiveSetting(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.LiveSetting per l'oggetto DependencyObject specificato.

GetLocalizedControlType(DependencyObject)

Ottiene una stringa localizzata che indica il tipo del controllo specificato.

GetLocalizedLandmarkType(DependencyObject)

Ottiene il valore della proprietà associata del tipo di punto di riferimento localizzato per l'oggetto DependencyObject specificato.

GetName(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.Name per l'oggetto DependencyObject specificato.

GetPositionInSet(DependencyObject)

Ottiene il valore della proprietà AutomationProperties.PositionInSet per l'oggetto DependencyObject specificato.

GetSizeOfSet(DependencyObject)

Ottiene il valore della proprietà AutomationProperties.SizeOfSet per l'oggetto DependencyObject specificato.

SetAcceleratorKey(DependencyObject, String)

Imposta il valore della proprietà associata AutomationProperties.AcceleratorKey per l'oggetto DependencyObject specificato.

SetAccessibilityView(DependencyObject, AccessibilityView)

Imposta il valore della proprietà associata AutomationProperties.AccessibilityView per l'oggetto DependencyObject specificato.

SetAccessKey(DependencyObject, String)

Imposta il valore della proprietà associata AutomationProperties.AccessKey per l'oggetto DependencyObject specificato.

SetAutomationControlType(UIElement, AutomationControlType)

Imposta il valore della proprietà associata AutomationProperties.AutomationControlType per l'oggetto DependencyObject specificato.

SetAutomationId(DependencyObject, String)

Imposta il valore della proprietà associata AutomationProperties.AutomationId per l'oggetto DependencyObject specificato.

SetCulture(DependencyObject, Int32)

Imposta il valore della proprietà associata Culture per l'oggetto DependencyObject specificato.

SetFullDescription(DependencyObject, String)

Imposta una stringa localizzata che descrive l'aspetto visivo o il contenuto dell'oggetto DependencyObject specificato.

SetHeadingLevel(DependencyObject, AutomationHeadingLevel)

Imposta il valore della proprietà AutomationProperties.HeadingLevel per l'oggetto DependencyObject specificato.

SetHelpText(DependencyObject, String)

Imposta il valore della proprietà associata AutomationProperties.HelpText per l'oggetto DependencyObject specificato.

SetIsDataValidForForm(DependencyObject, Boolean)

Imposta un valore booleano che indica se il valore immesso o selezionato è valido per la regola del modulo associata all'elemento specificato.

SetIsDialog(DependencyObject, Boolean)

Imposta un valore booleano che indica se l'elemento specificato deve essere identificato come finestra di dialogo.

SetIsPeripheral(DependencyObject, Boolean)

Imposta un valore booleano che indica se l'elemento specificato rappresenta l'interfaccia utente periferica.

SetIsRequiredForForm(DependencyObject, Boolean)

Imposta il valore della proprietà associata AutomationProperties.IsRequiredForForm per l'oggetto DependencyObject specificato.

SetItemStatus(DependencyObject, String)

Imposta il valore della proprietà associata AutomationProperties.ItemStatus per l'oggetto DependencyObject specificato.

SetItemType(DependencyObject, String)

Imposta il valore della proprietà associata AutomationProperties.ItemType per l'oggetto DependencyObject specificato.

SetLabeledBy(DependencyObject, UIElement)

Imposta il valore della proprietà associata AutomationProperties.LabeledBy per l'oggetto DependencyObject specificato.

SetLandmarkType(DependencyObject, AutomationLandmarkType)

Imposta il valore della proprietà associata del tipo di punto di riferimento per l'oggetto DependencyObject specificato.

SetLevel(DependencyObject, Int32)

Imposta il valore della proprietà associata AutomationProperties.Level per l'oggetto DependencyObject specificato.

SetLiveSetting(DependencyObject, AutomationLiveSetting)

Imposta il valore della proprietà associata AutomationProperties.LiveSetting per l'oggetto DependencyObject specificato.

SetLocalizedControlType(DependencyObject, String)

Imposta una stringa localizzata che indica il tipo del controllo specificato.

SetLocalizedLandmarkType(DependencyObject, String)

Imposta il valore della proprietà associata del tipo di punto di riferimento localizzato per l'oggetto DependencyObject specificato.

SetName(DependencyObject, String)

Imposta il valore della AutomationProperties.Name proprietà associata per dependencyObject specificato.

SetPositionInSet(DependencyObject, Int32)

Imposta il valore della proprietà associata AutomationProperties.PositionInSet per l'oggetto DependencyObject specificato.

SetSizeOfSet(DependencyObject, Int32)

Imposta il valore della proprietà associata AutomationProperties.SizeOfSet per l'oggetto DependencyObject specificato.

Si applica a

Vedi anche