Partager via


AutomationProperties.Name Propriété attachée

Définition

Obtient ou définit le nom UI Automation de l’élément.

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

Remarques

La Name propriété doit être identique au texte d’étiquette à l’écran. Par exemple, Name doit être « Parcourir » pour un élément de bouton avec l’étiquette « Parcourir ». La Name propriété ne doit pas inclure le caractère mnémonique pour les clés d’accès (c’est-à-dire, « & »), qui est souligné dans la présentation de texte de l’interface utilisateur. En outre, la Name propriété ne doit pas être une version étendue ou modifiée de l’étiquette à l’écran, car l’incohérence entre le nom et l’étiquette peut entraîner une confusion entre les applications clientes et les utilisateurs.

Lorsque le texte d’étiquette correspondant n’est pas visible à l’écran ou lorsqu’il est remplacé par des graphiques, un autre texte doit être choisi. Le texte de remplacement doit être concis, intuitif et localisé dans la langue de l’interface utilisateur de l’application ou dans la langue d’interface utilisateur par défaut du système d’exploitation. Le texte de remplacement ne doit pas être une description détaillée des détails visuels, mais une description concise de la fonction ou de la fonctionnalité d’interface utilisateur comme si elle était étiquetée par du texte simple. Par exemple, le bouton de menu Démarrer de Windows est nommé « Démarrer » (bouton) au lieu de « Logo Windows sur des graphiques de sphère ronde bleue » (bouton). Pour plus d’informations, consultez Création d’équivalents de texte pour les images.

Lorsqu’une étiquette d’interface utilisateur utilise des graphiques texte (par exemple, en utilisant «>> » pour un bouton qui ajoute un élément de gauche à droite), la Name propriété doit être remplacée par une alternative de texte appropriée (par exemple, « Ajouter »). Toutefois, la pratique d’utiliser des graphiques de texte comme étiquette d’interface utilisateur est déconseillée en raison de problèmes de localisation et d’accessibilité.

La Name propriété ne doit pas inclure les informations de rôle ou de type de contrôle, telles que « button » ou « list » ; sinon, elle sera en conflit avec le texte de la propriété LocalizedControlType lorsque ces deux propriétés sont ajoutées (de nombreuses technologies d’assistance existantes le font).

La Name propriété ne peut pas être utilisée comme identificateur unique parmi les frères. Toutefois, tant qu’elle est cohérente avec la présentation de l’interface utilisateur, la même Name valeur peut être prise en charge par les pairs. Pour l’automatisation des tests, les clients doivent envisager d’utiliser la propriété AutomationId ou RuntimeId .

Les contrôles de texte n’ont pas toujours besoin que la Name propriété soit identique au texte affiché dans le contrôle, tant que le modèle Texte est également pris en charge.

Parmi les différentes propriétés attachées, la plus importante est Nameprobablement . En effet, il s’agit de la Name propriété la plus fréquemment consultée et signalée par la technologie d’assistance lorsque les utilisateurs interagissent avec une application dans un scénario d’accessibilité. sert Name d’identificateur lisible par l’utilisateur pour l’élément d’interface utilisateur.

Différents éléments d’interface utilisateur ont un transfert d’homologue qui peut fournir une valeur par défaut Name basée sur d’autres propriétés d’élément. Par exemple, le transfert d’homologue pour la classe Button transfère l’évaluation ToString du contenu Button et utilise cette chaîne comme valeur par défaut Name. Pour remplacer cette valeur par défaut ou pour fournir une Name valeur pour tout cas d’élément d’interface utilisateur dans lequel microsoft UI Automation n’est Name pas disponible, définissez la Name propriété jointe sur cet élément en XAML. Pour plus d’informations sur l’importance d’un microsoft UI AutomationName, consultez Informations d’accessibilité de base. Pour plus d’informations sur la façon de tester si un élément possède déjà un élément fourni par Name l’homologue qui est utile, consultez Tests d’accessibilité.

Pour des raisons de localisation, vous devez éviter les valeurs de chaîne codées en dur pour le Name en XAML. Si vous définissez la directive x :Uid sur l’élément, vous pouvez utiliser des ressources RESW pour cibler la propriété et fournir différentes valeurs pour la localisation. Pour les propriétés jointes, le formulaire d’identificateur de ressource nécessite une qualification complète de la propriété jointe au format XAML, y compris son espace de noms et un préfixe using :. Par exemple, pour cibler la valeur de la AutomationProperties.Name propriété jointe sur une ressource qui a la valeur de directive x :Uid « sendButton », la Name valeur de l’élément de données dans les ressources RESW est sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name

S’applique à

Voir aussi