AutomationProperties.Name Proprietà associata
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il nome Automazione interfaccia utente dell'elemento.
see GetName, and SetNamesee GetName, and SetNamesee GetName, and SetNameCommenti
La Name proprietà deve essere uguale 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 mnemonic per le chiavi di accesso, ovvero "&"), sottolineato nella presentazione del testo dell'interfaccia utente. Inoltre, la Name proprietà non deve essere una versione estesa o modificata dell'etichetta sullo schermo perché la incoerenza tra il nome e l'etichetta può causare confusione tra applicazioni client e utenti.
Quando il testo dell'etichetta corrispondente non è visibile sullo schermo o quando viene sostituito dalla grafica, è necessario scegliere testo alternativo. Il testo alternativo deve essere conciso, intuitivo e localizzato nella lingua dell'interfaccia utente dell'applicazione o nella lingua predefinita dell'interfaccia utente 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) anziché "Windows Logo on blue round sphere graphics" (pulsante). 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 grafica di testo come etichetta dell'interfaccia utente è sconsigliata a causa di problemi di localizzazione e accessibilità.
La Name proprietà non deve includere il ruolo di controllo o le informazioni sul tipo, ad esempio "button" o "list". In caso contrario, il testo verrà in conflitto con il testo della proprietà LocalizedControlType quando queste due proprietà vengono aggiunte (molte tecnologie assistive esistenti fanno questa operazione).
La Name proprietà non può essere usata come identificatore univoco tra i fratelli. 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 considerare 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 modello di testo.
Delle varie proprietà associate, probabilmente la più importante è Name. Ciò è dovuto al fatto che è la Name proprietà a cui è più frequente l'accesso e segnalato dalla tecnologia assistive quando gli utenti interagiscono con un'app in uno scenario di accessibilità. L'oggetto 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 Name in base ad altre proprietà dell'elemento. Ad esempio, l'inoltro peer per la classe Button inoltra la ToString valutazione del contenuto Button e userà questa stringa come valore predefinito Name. Per eseguire l'override di tale impostazione predefinita o specificare in caso contrario 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 informazioni sul motivo per cui un Automazione interfaccia utente Name Microsoft è importante, vedere Informazioni di accessibilità di base. Per altre informazioni su come testare se un elemento ha già un elemento fornito Name da peer che è utile, vedere Test di accessibilità.
Per motivi di localizzazione, è consigliabile evitare valori stringa hardcoded per l'oggetto Name in XAML. Se si imposta una direttiva x:Uid sull'elemento, è possibile usare le risorse RESW per indirizzare 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 nel formato XAML, incluso lo spazio dei nomi e un metodo using: prefisso. Ad esempio, per indirizzare 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
- Type: string
- Campo Identificatore: NameProperty
- Metodi di accesso: GetName, SetName