AutomationProperties.NameProperty Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Automation

Identifie le AutomationProperties.Name propriété jointe, qui est une chaîne qui contient le nom de l’élément automation.

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

Valeur de propriété

DependencyProperty

Identificateur du AutomationProperties.Name propriété jointe.

Remarques

La propriété Name doit être identique au texte de l’étiquette à l’écran. Par exemple, Name doit être « Parcourir » pour un élément de bouton avec l’étiquette « Parcourir ». La propriété Name 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 propriété Name 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 propriété Name 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 propriété Name ne doit pas inclure les informations de rôle ou de type de contrôle, telles que « button » ou « list » ; sinon, il 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 propriété Name ne peut pas être utilisée comme identificateur unique parmi les frères et sœurs. Toutefois, tant qu’elle est cohérente avec la présentation de l’interface utilisateur, la même valeur Name 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 propriété Name soit identique au texte affiché dans le contrôle, tant que le modèle Texte est également pris en charge.