AutomationProperties.Name Присоединенное свойство

Определение

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

Microsoft.UI.Xaml.Automation

Возвращает или задает имя модель автоматизации пользовательского интерфейса элемента.

see GetName, and SetName

see GetName, and SetName

see GetName, and SetName

Комментарии

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

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

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

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

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

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

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

Различные элементы пользовательского интерфейса имеют одноранговую пересылку, которая может предоставлять значение по умолчанию Name на основе других свойств элемента. Например, одноранговая пересылка для класса Button будет пересылать ToString оценку содержимого Button и использовать эту строку в качестве значения по умолчанию Name. Чтобы переопределить это значение по умолчанию или иным образом предоставить Name значение для любого элемента пользовательского интерфейса, если нет доступных модель автоматизации пользовательского интерфейса Name Майкрософт, задайте Name присоединенное свойство для этого элемента в XAML. Дополнительные сведения о том, почему важно модель автоматизации пользовательского интерфейса Name Майкрософт, см. в статье Основные сведения о специальных возможностях. Дополнительные сведения о том, как проверить, имеет ли элемент уже полезный одноранговый Name элемент, см. в разделе Проверка читаемости.

В целях локализации следует избегать жестко заданных строковых значений Name для в XAML. Если для элемента задана директива x:Uid , можно использовать ресурсы RESW для назначения свойства и предоставления различных значений для локализации. Для вложенных свойств форма идентификатора ресурса требует полной квалификации присоединенного свойства в форме XAML, включая его пространство имен и префикс using: . Например, чтобы нацелить AutomationProperties.Name значение присоединенного свойства на ресурс, имеющий значение директивы x:Uid как "sendButton", Name значение элемента данных в ресурсах RESW равно sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name

• Type: строка
• Поле идентификатора: NameProperty
• Методы доступа: GetName, SetName

См. также раздел

• Присоединенные свойства XAML