Condividi tramite

AutomationProperties.Name Proprietà associata

  • Riferimento

Definizione

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

Ottiene o imposta il nome Automazione interfaccia utente dell'elemento.

see GetName, and SetName
see GetName, and SetName
see GetName, and SetName

Commenti

La Name proprietà deve corrispondere al testo dell'etichetta sullo schermo. Ad esempio, Name deve essere "Sfoglia" per un elemento pulsante con l'etichetta "Sfoglia". La Name proprietà non deve includere il carattere mnemonico per i tasti di scelta( ovvero "&"), sottolineato nella presentazione di testo dell'interfaccia utente. Inoltre, la Name proprietà non deve essere una versione estesa o modificata dell'etichetta sullo schermo perché l'incoerenza tra il nome e l'etichetta può causare confusione tra le applicazioni client e gli utenti.

Quando il testo dell'etichetta corrispondente non è visibile sullo schermo o quando viene sostituito da grafica, è necessario scegliere testo alternativo. Il testo alternativo deve essere conciso, intuitivo e localizzato nella lingua dell'interfaccia utente dell'applicazione o nella lingua dell'interfaccia utente predefinita del sistema operativo. Il testo alternativo non deve essere una descrizione dettagliata dei dettagli visivi, ma una descrizione concisa della funzione o della funzionalità dell'interfaccia utente come se fosse etichettata da testo semplice. Ad esempio, il pulsante del menu Start di Windows è denominato "Start" (pulsante) invece di "Windows Logo on blue round sphere graphics" (button). Per altre informazioni, vedere Creazione di equivalenti di testo per le immagini.

Quando un'etichetta dell'interfaccia utente usa grafica di testo (ad esempio, usando ">>" per un pulsante che aggiunge un elemento da sinistra a destra), la Name proprietà deve essere sostituita da un'alternativa di testo appropriata (ad esempio, "Aggiungi"). Tuttavia, la pratica di usare la grafica di testo come etichetta dell'interfaccia utente è sconsigliata a causa di problemi di localizzazione e accessibilità.

La proprietà non deve includere le informazioni sul ruolo o sul tipo di controllo, ad esempio "button" o "list". In Name caso contrario, sarà in conflitto con il testo della proprietà LocalizedControlType quando queste due proprietà vengono aggiunte (molte tecnologie assistive esistenti eseguono questa operazione).

La Name proprietà non può essere utilizzata come identificatore univoco tra elementi di pari livello. Tuttavia, purché sia coerente con la presentazione dell'interfaccia utente, lo stesso Name valore può essere supportato tra i peer. Per l'automazione dei test, i client devono prendere in considerazione l'uso della proprietà AutomationId o RuntimeId .

I controlli di testo non devono sempre avere la Name proprietà identica al testo visualizzato all'interno del controllo, purché sia supportato anche il criterio Di testo.

Delle varie proprietà associate, probabilmente quella più importante è Name. Ciò è dovuto al fatto che è la Name proprietà a cui si accede più di frequente e segnalata da assistive technology quando gli utenti interagiscono con un'app in uno scenario di accessibilità. funge Name da identificatore leggibile per l'elemento dell'interfaccia utente.

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

Per motivi di localizzazione, è consigliabile evitare valori stringa hardcoded per in Name 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 AutomationProperties.Name valore della proprietà associata in una risorsa con valore di direttiva x:Uid "sendButton", il Name valore dell'elemento di dati nelle risorse RESW è sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name

Si applica a

Vedi anche