AutomationProperties.NameProperty Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Automation

Identifica la AutomationProperties.Name proprietà associata, ovvero una stringa che contiene il nome dell'elemento di automazione.

public:
 static property DependencyProperty ^ NameProperty { DependencyProperty ^ get(); };

static DependencyProperty NameProperty();

public static DependencyProperty NameProperty { get; }

var dependencyProperty = AutomationProperties.nameProperty;

Public Shared ReadOnly Property NameProperty As DependencyProperty

Valore della proprietà

DependencyProperty

Identificatore del AutomationProperties.Name proprietà associata.

Commenti

La proprietà Name deve corrispondere al testo dell'etichetta sullo schermo. Ad esempio, Name deve essere "Sfoglia" per un elemento pulsante con l'etichetta "Sfoglia". La proprietà Name non deve includere il carattere mnemonico per i tasti di scelta( ovvero "&"), sottolineato nella presentazione del testo dell'interfaccia utente. Inoltre, la proprietà Name 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 elementi grafici di testo (ad esempio, usando ">>" per un pulsante che aggiunge un elemento da sinistra a destra), la proprietà Name 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à Name non deve includere le informazioni sul ruolo o sul tipo di controllo, ad esempio "button" o "list"; in 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 proprietà Name non può essere utilizzata come identificatore univoco tra elementi di pari livello. Tuttavia, purché sia coerente con la presentazione dell'interfaccia utente, lo stesso valore Name 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 proprietà Name identica al testo visualizzato all'interno del controllo, purché sia supportato anche il criterio Text .