AutomationPeer.GetName Metodo

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Automation.Peers

Ottiene la stringa di testo che descrive l’elemento che è associato a questo peer di automazione. Il valore Microsoft Automazione interfaccia utente Name è l'identificatore primario usato dalla maggior parte della tecnologia di assistive technology quando rappresentano l'interfaccia utente dell'app interagendo con il framework microsoft Automazione interfaccia utente.

public:
 virtual Platform::String ^ GetName() = GetName;

winrt::hstring GetName();

public string GetName();

function getName()

Public Function GetName () As String

Restituisce

String

Platform::String

winrt::hstring

Nome dell'elemento proprietario del peer, usato da assistive technology e altri client microsoft Automazione interfaccia utente.

Commenti

FrameworkElementAutomationPeer introduce il comportamento di GetName fornendo un'implementazione GetNameCore intermedia. Se un elemento ha un valore per la proprietà LabeledByMicrosoft Automazione interfaccia utente, il valore Name dell'elemento di etichettatura viene usato come Name.

FrameworkElementAutomationPeer introduce anche il comportamento tramite un metodo GetPlainText interno che altre classi peer predefinite possono eseguire l'override per accedere al modello di contenuto di tale controllo e restituire un valore predefinito utile per Name. Ad esempio, qualsiasi classe derivata contentControl userà una rappresentazione di stringa del valore content come nome predefinito. Questa opzione è abilitata perché ContentControl implementa internamente GetPlainText e impartisce tale comportamento a tutte le classi derivate di ContentControl . Questo è il modo in cui si ottiene un valore predefinito Name utile dal valore stringa di un button, ad esempio.

Altri peer specifici possono anche avere un'implementazione GetNameCore intermedia che fornisce un modo utile per quel particolare controllo Windows Runtime per fornire valori predefiniti per Name. L'origine di questi valori proviene da altre proprietà dell'interfaccia utente in genere impostate in XAML o come codice utente dell'app. Ad esempio, TextBoxAutomationPeer implementa il comportamento che usa il valore della proprietà Text dal proprietario TextBox come Nome predefinito. Dal punto di vista del codice utente, è possibile eseguire l'override del comportamento predefinito applicando un valore di AutomationProperties.Name diverso. Dal punto di vista del peer implementer/provider, il comportamento predefinito del peer può essere modificato derivando una nuova classe peer dal peer esistente, eseguendo l'override di GetNameCore e assegnando una nuova implementazione che non chiamerebbe l'implementazione di base in almeno alcuni casi.

Per altre informazioni sul possibile comportamento predefinito di classi peer specifiche per i controlli di Windows Runtime predefiniti, vedere l'argomento di riferimento per tale classe peer specifica e cercare le note di implementazione nella sezione Osservazioni.

Vedi anche

• Peer di automazione personalizzati