AutomationProperties Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Обеспечивает поддержку получения или задания значений на уровне экземпляра свойств автоматизации. Эти значения свойств задаются как присоединенные свойства (обычно в XAML) и дополняют или переопределяют значения свойств автоматизации из AutomationPeer элемента управления.
public ref class AutomationProperties sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AutomationProperties final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AutomationPropertiesPublic NotInheritable Class AutomationProperties- Наследование
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Примеры
Совет
Откройте приложение коллекции WinUI 3 и ознакомьтесь со следующими принципами специальных возможностей в действии:
Приложение коллекции WinUI 3 содержит интерактивные примеры большинства элементов управления, функций и функций WinUI 3. Получение приложения из Microsoft Store или получение исходного кода на GitHub
Комментарии
AutomationProperties — это класс службы узла для нескольких присоединенных свойств XAML. Цель этих присоединенных свойств — включить настройку различных значений для каждого экземпляра, которые относятся к тому, как элемент пользовательского интерфейса передается в платформу специальных возможностей Microsoft модель автоматизации пользовательского интерфейса. Это полезно в тех случаях, когда макет класса элемента пользовательского интерфейса еще не пересылает другие значения свойств, связанных с пользовательским интерфейсом, в рамках интеграции microsoft модель автоматизации пользовательского интерфейса или одноранговой реализации, или когда пересылаемое значение не является значением, которое вы хотите сообщить в корпорацию Майкрософт. модель автоматизации пользовательского интерфейса.
Для поддержки доступа обработчика XAML к присоединенным свойствам, а также для предоставления эквивалентных операций получения и задания в коде каждое присоединенное свойство XAML имеет пару методов доступа Get и Set , которые также являются членами AutomationProperties. Например, методы GetName и SetName поддерживают и обеспечивают эквивалентную поддержку только кода для отправки значений имен автоматизации в Microsoft модель автоматизации пользовательского интерфейса вместо использования свойства Name attached для задания его в XAML. Кроме того, можно использовать систему свойств зависимостей, чтобы получить или задать значение присоединенного свойства, а также сообщить базовое значение в Microsoft модель автоматизации пользовательского интерфейса. Вызовите Метод GetValue или SetValue, передав аргументы заданного идентификатора свойства зависимостей и ссылку на целевой объект, для которого требуется получить или задать значение.
Name - свойство
Из различных присоединенных свойств, вероятно, наиболее важным является Имя. Это связано с тем, что это свойство Name , к которому чаще всего обращаются специальные возможности, когда пользователи взаимодействуют с приложением в сценарии специальных возможностей. Имя служит в качестве удобочитаемого идентификатора для элемента пользовательского интерфейса.
Различные элементы пользовательского интерфейса имеют одноранговую пересылку, которая может предоставлять значение name по умолчанию на основе других свойств элементов. Например, одноранговая пересылка для класса Button перенаправит оценку ToString содержимого Button и использует эту строку в качестве имени по умолчанию. Чтобы переопределить это значение по умолчанию или иным образом предоставить значение Name для любого случая элемента пользовательского интерфейса, в котором нет доступного имени модель автоматизации пользовательского интерфейса Microsoft, задайте свойство Name attached для этого элемента в XAML. Дополнительные сведения о том, почему имя модель автоматизации пользовательского интерфейса Майкрософт важно, см. в статье Основные сведения о специальных возможностях. Дополнительные сведения о том, как проверить, имеет ли элемент уже полезное одноранговое имя , см. в разделе Проверка читаемости.
В целях локализации следует избегать жестко заданных строковых значений для name в XAML. Если для элемента задана директива x:Uid , можно использовать ресурсы RESW для назначения свойства и предоставления различных значений для локализации. Для вложенных свойств форма идентификатора ресурса требует полной квалификации присоединенного свойства в форме XAML, включая его пространство имен и префикс using: . Например, чтобы нацелить AutomationProperties.Name значение присоединенного свойства для ресурса со значением директивы x:Uid "sendButton", значение имени элемента данных в ресурсах RESW будет равно sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name
Полный список см. в разделе Присоединенные свойства (дополнительные сведения о каждом присоединенном свойстве см. в поле Идентификатор каждого свойства).
Журнал версий
| Версия Windows | Версия пакета SDK | Добавленная стоимость |
|---|---|---|
| 1511 | 10586 | GetLandmarkType |
| 1511 | 10586 | GetLocalizedLandmarkType |
| 1511 | 10586 | SetLandmarkType |
| 1511 | 10586 | SetLocalizedLandmarkType |
| 1607 | 14393 | GetDescribedBy |
| 1607 | 14393 | GetFlowsFrom |
| 1607 | 14393 | GetFlowsTo |
| 1607 | 14393 | GetFullDescription |
| 1607 | 14393 | GetIsDataValidForForm |
| 1607 | 14393 | GetIsPeripheral |
| 1607 | 14393 | GetLocalizedControlType |
| 1607 | 14393 | SetFullDescription |
| 1607 | 14393 | SetIsDataValidForForm |
| 1607 | 14393 | SetIsPeripheral |
| 1607 | 14393 | SetLocalizedControlType |
| 1703 | 15063 | GetCulture |
| 1703 | 15063 | SetCulture |
| 1803 | 17134 | GetHeadingLevel |
| 1803 | 17134 | SetHeadingLevel |
| 1809 | 17763 | GetIsDialog |
| 1809 | 17763 | SetIsDialog |
Свойства
Присоединенные свойства
| AcceleratorKey |
Возвращает или задает строку, содержащую сочетания клавиш ускорителя (также называемые сочетанием клавиш) для элемента автоматизации. |
| AccessibilityView |
Возвращает или задает режим представления в виде дерева Microsoft модель автоматизации пользовательского интерфейса для элемента. |
| AccessKey |
Возвращает или задает строку, содержащую символ ключа доступа для элемента автоматизации. |
| Annotations |
Возвращает список объектов заметки в документе, таких как комментарий, верхний колонтитул, нижний колонтитул и т. д. |
| AutomationControlType |
Возвращает или задает тип элемента управления для Microsoft модель автоматизации пользовательского интерфейса. |
| AutomationId |
Возвращает или задает строку, однозначно идентифицирующая элемент для Microsoft модель автоматизации пользовательского интерфейса. |
| ControlledPeers |
Возвращает коллекцию элементов автоматизации, которыми можно управлять с помощью указанного элемента автоматизации. |
| Culture |
Возвращает или задает идентификатор языкового стандарта для элемента автоматизации (например, 0x0409 для en-US или английского языка (США)). |
| DescribedBy |
Возвращает массив элементов, предоставляющих дополнительные сведения об элементе автоматизации. |
| FlowsFrom |
Возвращает массив элементов автоматизации, который предлагает порядок чтения перед текущим элементом автоматизации. |
| FlowsTo |
Возвращает массив элементов автоматизации, который предлагает порядок чтения после текущего элемента автоматизации. |
| FullDescription |
Возвращает или задает локализованную строку, содержащую расширенный текст описания для элемента. |
| HeadingLevel |
Возвращает или задает уровень заголовка для элемента модель автоматизации пользовательского интерфейса. |
| HelpText |
Возвращает или задает текстовую строку справки, связанную с элементом автоматизации. |
| IsDataValidForForm |
Возвращает или задает значение, указывающее, являются ли данные допустимыми для формы. |
| IsDialog |
Возвращает или задает значение, указывающее, является ли элемент автоматизации диалоговым окном. |
| IsPeripheral |
Возвращает или задает значение, указывающее, представляет ли элемент автоматизации периферийный пользовательский интерфейс. |
| IsRequiredForForm |
Возвращает или задает значение, указывающее, требуется ли заполнение элемента в форме. |
| ItemStatus |
Возвращает или задает описание состояния элемента в элементе . |
| ItemType |
Возвращает или задает описание типа определенного элемента. |
| LabeledBy |
Возвращает или задает элемент автоматизации, содержащий текстовую метку для этого элемента. |
| LandmarkType |
Возвращает или задает идентификатор типа ориентира , связанный с элементом. |
| Level |
Возвращает или задает целое число на основе 1, описывающее расположение элемента внутри иерархических или неработающих иерархических структур. |
| LiveSetting |
Возвращает или задает значение динамического параметра для указанного элемента, которое поддерживается элементом автоматизации, представляющим динамическую область. |
| LocalizedControlType |
Возвращает или задает локализованную текстовую строку, описывающую тип элемента управления, который представляет элемент автоматизации. |
| LocalizedLandmarkType |
Возвращает или задает локализованную текстовую строку, описывающую тип ориентира, который представляет элемент автоматизации. |
| Name |
Возвращает или задает имя модель автоматизации пользовательского интерфейса элемента. |
| PositionInSet |
Возвращает или задает целое число на основе 1, описывающее порядковый номер элемента в наборе элементов, которые считаются элементами того же уровня. |
| SizeOfSet |
Возвращает или задает количество элементов в наборе элементов, которые считаются элементами того же уровня. |