AutomationProperties Classe

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml.Automation
Modifica

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(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Commenti

Proprietà associate XAML

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

Proprietà associate

Nota

Per altre info su ogni proprietà associata, vedi la pagina relativa al campo Identificatore della proprietà.

Proprietà associata Descrizione
AcceleratorKey Ottiene o imposta il tasto di scelta rapida per l'elemento specificato.
AccessibilityView Ottiene o imposta la modalità di visualizzazione albero di Microsoft Automazione interfaccia utente per un elemento.
AccessKey Ottiene o imposta il tasto di scelta per l'elemento specificato.
AutomationId Ottiene o imposta la stringa che identifica in modo univoco l'elemento a Microsoft Automazione interfaccia utente.
Impostazioni cultura Ottiene o imposta l'identificatore delle impostazioni locali per l'elemento di automazione, ad esempio 0x0409 per "en-US" o inglese (Stati Uniti)).Valore della proprietà delle impostazioni cultura per l'elemento specificato.
FullDescription Ottiene o imposta una stringa localizzata contenente testo di descrizione estesa per un elemento.
HeadingLevel Ottiene o imposta il livello di titolo per un elemento Automazione interfaccia utente.
HelpText Ottiene o imposta il testo della Guida per l'elemento .
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 che contiene l'etichetta di testo per l'elemento.
LandmarkType Ottiene o imposta un identificatore del tipo di punto di riferimento associato a un elemento .
Livello Ottiene o imposta un numero intero basato su 1 che descrive la posizione di un elemento all'interno di strutture gerarchiche gerarchiche o interrotte.
LiveSetting Ottiene o imposta il valore dell'impostazione dinamica per l'elemento specificato.
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.
Nome Ottiene o imposta il nome Automazione interfaccia utente dell'elemento.
PositionInSet Ottiene o imposta un numero intero basato su 1 che descrive la posizione ordinale dell'elemento all'interno di un set di elementi considerati elementi di pari livello.
SizeOfSet Ottiene o imposta il numero di elementi in un set di elementi considerati di pari livello.

Proprietà

AcceleratorKeyProperty

Identifica la proprietà associata AutomationProperties.AcceleratorKey , ovvero una stringa contenente le combinazioni di tasti di scelta rapida (detta anche tasto di scelta rapida) per l'elemento di automazione.
AccessibilityViewProperty

Identifica la proprietà associata AutomationProperties.AccessibilityView . Impostare questa proprietà associata su singoli elementi per modificare la visibilità degli elementi in modalità specifiche richieste da un client Automazione interfaccia utente.
AccessKeyProperty

Identifica la proprietà associata AutomationProperties.AccessKey , ovvero una stringa contenente il carattere di tasto di scelta per l'elemento di automazione.
AnnotationsProperty

Identifica una proprietà di dipendenza utilizzata per un elenco di oggetti annotazione in un documento, ad esempio commento, intestazione, piè di pagina e così via.
AutomationControlTypeProperty

Identifica la AutomationProperties proprietà associata, ovvero un oggetto Microsoft.UI.Xaml.Automation.Peers.AutomationControlType.
AutomationIdProperty

Identifica la proprietà associata AutomationProperties.AutomationId, ovvero una stringa contenente l'identificatore di Automazione interfaccia utente (ID) per l'elemento di automazione.
ControlledPeersProperty

Identifica la proprietà associata ControlledPeers, utilizzata per una raccolta di elementi di automazione che possono essere modificati dall'elemento di automazione specificato.
CultureProperty

Ottiene l'identificatore per la proprietà associata alle impostazioni cultura che contiene un identificatore delle impostazioni locali per l'elemento di automazione, ad esempio 0x0409 per "en-US" o inglese (Stati Uniti)).
DescribedByProperty

Ottiene l'identificatore per l'oggetto descritto dalla proprietà associata, ovvero una matrice di elementi che forniscono altre informazioni sull'elemento di automazione.
FlowsFromProperty

Ottiene l'identificatore per la proprietà associata FlowsFrom , ovvero una matrice di elementi di automazione che suggerisce l'ordine di lettura prima dell'elemento di automazione corrente.
FlowsToProperty

Ottiene l'identificatore per la proprietà associata FlowsTo , ovvero una matrice di elementi di automazione che suggerisce l'ordine di lettura dopo l'elemento di automazione corrente.
FullDescriptionProperty

Ottiene l'identificatore per la proprietà associata di descrizione completa, che espone una stringa localizzata contenente testo di descrizione estesa per un elemento.
HeadingLevelProperty

Ottiene l'identificatore per la proprietà associata HeadingLevel, che indica il livello di titolo per un elemento Automazione interfaccia utente.
HelpTextProperty

Identifica la proprietà associata AutomationProperties.HelpText , ovvero una stringa di testo della Guida associata all'elemento di automazione.
IsDataValidForFormProperty

Identifica la proprietà di dipendenza booleana che indica se i dati sono validi per il modulo.
IsDialogProperty

Identifica la proprietà associata AutomationProperties.IsDialog , ovvero un valore booleano che indica se l'elemento di automazione è una finestra di dialogo.
IsPeripheralProperty

Identifica la proprietà di dipendenza booleana che indica se l'elemento di automazione rappresenta l'interfaccia utente periferica.
IsRequiredForFormProperty

Identifica la proprietà associata AutomationProperties.IsRequiredForForm , ovvero un valore booleano che indica se l'elemento di automazione deve essere compilato in un modulo.
ItemStatusProperty

Identifica la proprietà associata ItemStatus, che descrive lo stato di un elemento di automazione.
ItemTypeProperty

Identifica la proprietà associata AutomationProperties.ItemType , ovvero una stringa di testo che descrive il tipo dell'elemento di automazione.
LabeledByProperty

Identifica la proprietà associata AutomationProperties.LabeledBy , che è un elemento di automazione che contiene l'etichetta di testo per questo elemento.
LandmarkTypeProperty

Ottiene l'identificatore per la proprietà associata del tipo di punto di riferimento, ovvero un identificatore del tipo di punto di riferimento associato a un elemento.
LevelProperty

Ottiene l'identificatore per la proprietà associata Level , ovvero un numero intero basato su 1 associato a un elemento di automazione.
LiveSettingProperty

Identifica la proprietà associata AutomationProperties.LiveSetting , supportata da un elemento di automazione che rappresenta un'area dinamica.
LocalizedControlTypeProperty

Identifica la proprietà di dipendenza del tipo di controllo localizzato, ovvero una stringa di testo che descrive il tipo di controllo rappresentato dall'elemento di automazione.
LocalizedLandmarkTypeProperty

Ottiene l'identificatore per la proprietà associata del tipo di punto di riferimento localizzato, ovvero una stringa di testo localizzata che descrive il tipo di punto di riferimento rappresentato dall'elemento di automazione.
NameProperty

Identifica la AutomationProperties.Name proprietà associata, ovvero una stringa che contiene il nome dell'elemento di automazione.
PositionInSetProperty

Ottiene l'identificatore per la proprietà associata PositionInSet , ovvero un intero basato su 1 associato a un elemento di automazione.
SizeOfSetProperty

Ottiene l'identificatore per la proprietà associata.

Proprietà associate

AcceleratorKey

Ottiene o imposta una stringa contenente le combinazioni di tasti di scelta rapida (detta 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 di tasto di scelta 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

Identifica il tipo di elemento dell'interfaccia utente esposto al client microsoft Automazione interfaccia utente.
AutomationId

Ottiene o imposta la stringa che identifica in modo univoco l'elemento a 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 titolo 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 che contiene l'etichetta di testo per questo elemento.
LandmarkType

Ottiene o imposta un identificatore del tipo di punto di riferimento associato a un elemento .
Level

Ottiene o imposta un numero intero basato su 1 che descrive la posizione di un elemento all'interno di strutture gerarchiche 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 numero intero basato su 1 che descrive la posizione ordinale dell'elemento all'interno di un set di elementi considerati elementi di pari livello.
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 l'oggetto Microsoft.UI.Xaml.Automation.Peers.AutomationControlType per l'elemento dell'interfaccia utente specificato.
GetAutomationId(DependencyObject)

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

Metodo di utilità statica che recupera l'elenco di peer controllati da un proprietario di destinazione.
GetCulture(DependencyObject)

Ottiene il valore della proprietà associata CultureProperty 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 una stringa localizzata che descrive l'aspetto visivo o il contenuto dell'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 un valore booleano che indica se il valore immesso o selezionato è valido per la regola del modulo associata all'elemento 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 del tipo di punto di riferimento per l'oggetto DependencyObject specificato.
GetLevel(DependencyObject)

Ottiene il valore della proprietà per l'oggetto 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 AutomationProperties.Name proprietà associata per l'oggetto DependencyObject specificato.
GetPositionInSet(DependencyObject)

Ottiene il valore della proprietà per l'oggetto specificato.
GetSizeOfSet(DependencyObject)

Ottiene il valore della proprietà per l'oggetto 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 l'oggetto Microsoft.UI.Xaml.Automation.Peers.AutomationControlType per l'elemento dell'interfaccia utente 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 CultureProperty 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 l'oggetto 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