Condividi tramite

AutomationProperties Classe

  • Riferimento

Definizione

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

Fornisce 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 Automazione interfaccia utente di Microsoft. 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 comportamento di integrazione o implementazione peer di Automazione interfaccia utente Microsoft oppure in cui il valore inoltrato non è il valore che si vuole segnalare a Automazione interfaccia utente Microsoft.

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 Get e Set metodi di accesso, che sono anche membri di AutomationProperties. Ad esempio, i metodi GetName e SetName supportano e forniscono il supporto equivalente per la creazione di report di automazione Nome valori in Automazione interfaccia utente Microsoft, 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 questo segnala anche il valore sottostante a Automazione interfaccia utente Microsoft. 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.

Proprietà Name

Delle varie proprietà associate, probabilmente quello più importante è Nome. Questo perché è la proprietà Name a cui si accede più di frequente e segnalata dalla tecnologia di assistive technology quando gli utenti interagiscono con un'app in uno scenario di accessibilità. Il Name funge da identificatore leggibile per l'elemento dell'interfaccia utente.

Vari elementi dell'interfaccia utente dispongono di inoltro peer che possono fornire un valore predefinito Nome in base ad altre proprietà degli elementi. Ad esempio, l'inoltro peer per la classe Button inoltra la valutazione ToString del contenuto Button e usa questa stringa come nome predefinito. Per eseguire l'override di tale impostazione predefinita o fornire in altro modo un valore nome per qualsiasi caso dell'elemento dell'interfaccia utente in cui non è disponibile alcuna nome dell'interfaccia utente Microsoft, impostare la proprietà associata Name su tale elemento in XAML. Per altre informazioni sul motivo per cui un nome di Automazione interfaccia utente Microsoft è importante, vedere Informazioni di accessibilità di base. Per altre info su come verificare se un elemento dispone già di un Name fornito dal peer utile, vedere Test dell'accessibilità.

Per motivi di localizzazione, è consigliabile evitare valori stringa hardcoded per Name in XAML. Se imposti direttiva x:Uid sull'elemento, puoi usare le risorse RESW per impostare come destinazione la proprietà e fornire 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 il relativo spazio dei nomi e un prefisso using: . Ad esempio, per impostare come destinazione il valore della proprietà associata AutomationProperties.Name su una risorsa con direttiva x:Uid valore "sendButton", il nome nome valore dell'elemento dati nelle risorse RESW è

Proprietà associate

Nota

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

Proprietà associata Descrizione
Tasto di scelta rapida Ottiene o imposta il tasto di scelta rapida per l'elemento specificato.
AccessibilityView Ottiene o imposta la modalità di visualizzazione albero di Automazione interfaccia utente Microsoft per un elemento.
AccessKey Ottiene o imposta la chiave di accesso per l'elemento specificato.
AutomationId Ottiene o imposta la stringa che identifica in modo univoco l'elemento in Automazione interfaccia utente Microsoft.
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 della descrizione estesa per un elemento.
HeadingLevel Ottiene o imposta il livello di intestazione per un elemento di 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 dell'elemento specificato.
LabeledBy Ottiene o imposta l'elemento che contiene l'etichetta di testo per l'elemento .
LandmarkType Ottiene o imposta un identificatore di tipo punto di riferimento associato a un elemento.
Livello Ottiene o imposta un numero intero in base 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 dell'automazione interfaccia utente dell'elemento.
PositionInSet Ottiene o imposta un numero intero in base 1 che descrive la posizione ordinale dell'elemento all'interno di un set di elementi considerati di pari livello.
SizeOfSet Ottiene o imposta il numero di elementi in un set di elementi considerati di pari livello.

Proprietà

AcceleratorKeyProperty

Identifica l'AutomationProperties.AcceleratorKey proprietà associata, 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 di automazione interfaccia utente.
AccessKeyProperty

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

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

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

Identifica il AutomationProperties.AutomationId proprietà associata, 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 l'FlowsFrom proprietà associata, ovvero una matrice di elementi di automazione che suggerisce l'ordine di lettura prima dell'elemento di automazione corrente.
FlowsToProperty

Ottiene l'identificatore per l'FlowsTo proprietà associata, 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 l'HeadingLevel proprietà associata, che indica il livello di intestazione per un elemento di automazione interfaccia utente.
HelpTextProperty

Identifica il AutomationProperties.HelpText proprietà associata, 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 il AutomationProperties.IsDialog proprietà associata, 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 è necessario compilare l'elemento di automazione in un modulo.
ItemStatusProperty

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

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

Identifica il AutomationProperties.LabeledBy proprietà associata, ovvero 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 di tipo punto di riferimento associato a un elemento .
LevelProperty

Ottiene l'identificatore della 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 il PositionInSet proprietà associata, ovvero un numero 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 Automazione interfaccia utente Microsoft 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 di automazione interfaccia utente Microsoft.
AutomationId

Ottiene o imposta la stringa che identifica in modo univoco l'elemento in Automazione interfaccia utente Microsoft.
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 della descrizione estesa per un elemento.
HeadingLevel

Ottiene o imposta il livello di intestazione per un elemento di 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 dell'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 di tipo punto di riferimento associato a un elemento.
Level

Ottiene o imposta un numero intero in base 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 dell'automazione interfaccia utente dell'elemento.
PositionInSet

Ottiene o imposta un numero intero in base 1 che descrive la posizione ordinale dell'elemento all'interno di un set di elementi considerati 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 il DependencyObject specificato.
GetAccessibilityView(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.AccessibilityView per il DependencyObject specificato.
GetAccessKey(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.AccessKey per il DependencyObject specificato.
GetAnnotations(DependencyObject)

Ottiene il valore della proprietà AutomationProperties.Annotations per il DependencyObject specificato.
GetAutomationControlType(UIElement)

Ottiene il Microsoft.UI.Xaml.Automation.Peers.AutomationControlType per l'elemento dell'interfaccia utente specificato.
GetAutomationId(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.AutomationId per il 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 il 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 suggerisce l'ordine di lettura prima dell'elemento di automazione specificato.
GetFlowsTo(DependencyObject)

Ottiene un elenco di elementi di automazione che suggerisce 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 il DependencyObject specificato.
GetHelpText(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.HelpText per il 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 il 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 il DependencyObject specificato.
GetItemStatus(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.ItemStatus per il DependencyObject specificato.
GetItemType(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.ItemType per il DependencyObject specificato.
GetLabeledBy(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.LabeledBy per il DependencyObject specificato.
GetLandmarkType(DependencyObject)

Ottiene il valore della proprietà associata del tipo di punto di riferimento per il DependencyObject specificato.
GetLevel(DependencyObject)

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

Ottiene il valore della proprietà associata AutomationProperties.LiveSetting per il 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 il DependencyObject specificato.
GetName(DependencyObject)

Ottiene il valore della proprietà associata AutomationProperties.Name per il 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 il DependencyObject specificato.
SetAccessibilityView(DependencyObject, AccessibilityView)

Imposta il valore della proprietà associata AutomationProperties.AccessibilityView per il DependencyObject specificato.
SetAccessKey(DependencyObject, String)

Imposta il valore della proprietà associata AutomationProperties.AccessKey per il DependencyObject specificato.
SetAutomationControlType(UIElement, AutomationControlType)

Imposta il 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 il DependencyObject specificato.
SetCulture(DependencyObject, Int32)

Imposta il valore della proprietà associata CultureProperty per il DependencyObject specificato.
SetFullDescription(DependencyObject, String)

Imposta una stringa localizzata che descrive l'aspetto visivo o il contenuto del DependencyObject specificato.
SetHeadingLevel(DependencyObject, AutomationHeadingLevel)

Imposta il valore della proprietà AutomationProperties.HeadingLevel per il DependencyObject specificato.
SetHelpText(DependencyObject, String)

Imposta il valore della proprietà associata AutomationProperties.HelpText per il 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 il DependencyObject specificato.
SetItemStatus(DependencyObject, String)

Imposta il valore della proprietà associata AutomationProperties.ItemStatus per il DependencyObject specificato.
SetItemType(DependencyObject, String)

Imposta il valore della proprietà associata AutomationProperties.ItemType per il DependencyObject specificato.
SetLabeledBy(DependencyObject, UIElement)

Imposta il valore della proprietà associata AutomationProperties.LabeledBy per il DependencyObject specificato.
SetLandmarkType(DependencyObject, AutomationLandmarkType)

Imposta il valore della proprietà associata del tipo di punto di riferimento per il DependencyObject specificato.
SetLevel(DependencyObject, Int32)

Imposta il valore della proprietà associata AutomationProperties.Level per il DependencyObject specificato.
SetLiveSetting(DependencyObject, AutomationLiveSetting)

Imposta il valore della proprietà associata AutomationProperties.LiveSetting per il 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 il DependencyObject specificato.
SetName(DependencyObject, String)

Imposta il valore della proprietà associata AutomationProperties.Name per il DependencyObject specificato.
SetPositionInSet(DependencyObject, Int32)

Imposta il valore della proprietà associata AutomationProperties.PositionInSet per il DependencyObject specificato.
SetSizeOfSet(DependencyObject, Int32)

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

Si applica a

Vedi anche