AutomationProperties.NameProperty Свойство

Определение

Пространство имен:

Microsoft.UI.Xaml.Automation

Идентифицирует присоединенное свойство AutomationProperties.Name , представляющее собой строку, содержащую имя элемента автоматизации.

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

Значение свойства

DependencyProperty

Идентификатор присоединенного свойства AutomationProperties.Name .

Комментарии

Свойство Name должно совпадать с текстом метки на экране. Например, имя должно быть "Обзор" для элемента кнопки с меткой "Обзор". Свойство Name не должно содержать мнемонический символ для ключей доступа (т. е. "&"), который подчеркивается в текстовом представлении пользовательского интерфейса. Кроме того, свойство Name не должно быть расширенной или измененной версией метки на экране, так как несоответствие между именем и меткой может привести к путанице между клиентскими приложениями и пользователями.

Если соответствующий текст метки не отображается на экране или когда он заменяется графикой, следует выбрать альтернативный текст. Замещающий текст должен быть кратким, интуитивно понятным и локализованным для языка пользовательского интерфейса приложения или языка пользовательского интерфейса операционной системы по умолчанию. Альтернативный текст должен быть не подробным описанием визуальных элементов, а кратким описанием функции или компонента пользовательского интерфейса, как если бы они были помечены простым текстом. Например, кнопка меню "Пуск" Windows называется "Пуск" (кнопка) вместо "Логотип Windows на синей круглой графике" (кнопка). Дополнительные сведения см. в разделе Создание текстовых эквивалентов для изображений.

Если метка пользовательского интерфейса использует текстовые рисунки (например, с помощью ">>" для кнопки, которая добавляет элемент слева направо), свойство Name должно быть переопределено соответствующим текстовым вариантом (например, "Добавить"). Однако использование текстовой графики в качестве метки пользовательского интерфейса не рекомендуется из-за проблем локализации и специальных возможностей.

Свойство Name не должно содержать сведения о роли или типе элемента управления, например "кнопка" или "список"; В противном случае он будет конфликтовать с текстом из свойства LocalizedControlType при добавлении этих двух свойств (многие существующие вспомогательные технологии делают это).

Свойство Name нельзя использовать в качестве уникального идентификатора для одноуровневых элементов. Однако при условии, что оно согласуется с презентацией пользовательского интерфейса, одно и то же значение Name может поддерживаться для одноранговых узлов. Для автоматизации тестирования клиентам следует использовать свойство AutomationId или RuntimeId .

Элементы управления "Текст" не всегда должны иметь свойство Name идентично тексту, отображаемого в элементе управления , при условии, что шаблон "Текст " также поддерживается.