AutomationPeer.GetNameCore Metodo

Definizione

Fornisce il comportamento del peer quando un client microsoft Automazione interfaccia utente chiama GetName o un'API client microsoft equivalente Automazione interfaccia utente.

protected:
 virtual Platform::String ^ GetNameCore() = GetNameCore;
winrt::hstring GetNameCore();
protected virtual string GetNameCore();
function getNameCore()
Protected Overridable Function GetNameCore () As String

Restituisce

String

Platform::String

winrt::hstring

Nome usato dalla tecnologia assistive e da 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 Nome.

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 stringa del relativo valore contenuto 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 nome utile predefinito dal valore stringa di un pulsante, ad esempio.

Altri peer specifici possono avere anche un'implementazione GetNameCore intermedia che fornisce un modo utile per tale 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, il comportamento predefinito può essere sottoposto a override applicando un valore 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 fornendo 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 predefiniti Windows Runtime, vedere l'argomento di riferimento per tale particolare classe peer e cercare le note sull'implementazione nella sezione Osservazioni.

Si applica a

Vedi anche