Идентификаторы свойств элемента автоматизации

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

Констант/значение Описание
UIA_AcceleratorKeyPropertyId
30006
Идентифицирует свойство AcceleratorKey , которое представляет собой строку, содержащую сочетания клавиш ускорителя (также называемые сочетаниями клавиш) для элемента автоматизации.
Сочетания клавиш вызывают действие. Например, сочетание клавиш CTRL+O часто используется для вызова общего диалогового окна Открытие файла. Элемент автоматизации со свойством AcceleratorKey может реализовать шаблон элемента управления Invoke для действия, эквивалентного команде ярлыка.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_AccessKeyPropertyId
30007
Идентифицирует свойство AccessKey , которое представляет собой строку, содержащую символ ключа доступа для элемента автоматизации.
Клавиша доступа (иногда называемая мнемонической) — это символ в тексте меню, пункта меню или метки элемента управления, например кнопки, который активирует соответствующую функцию меню. Например, чтобы открыть меню Файл, для которого обычно используется клавиша доступа F, пользователь нажимает клавиши ALT+F.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_AnnotationObjectsPropertyId
30156
Определяет свойство AnnotationObjects , которое представляет собой список объектов заметки в документе, таких как комментарий, верхний колонтитул, нижний колонтитул и т. д.
Тип варианта: VT_I4 | VT_ARRAY
Значение по умолчанию: пустой массив
UIA_AnnotationTypesPropertyId
30155
Идентифицирует свойство AnnotationTypes , которое представляет собой список типов заметок в документе, таких как комментарий, верхний колонтитул, нижний колонтитул и т. д.
Тип варианта: VT_I4 | VT_ARRAY
Значение по умолчанию: пустой массив
UIA_AriaPropertiesPropertyId
30102
Определяет свойство AriaProperties , которое представляет собой форматированную строку, содержащую сведения о свойстве ARIA для элемента автоматизации. Дополнительные сведения о сопоставлении состояний и свойств ARIA со свойствами и функциями модели автоматизации пользовательского интерфейса см. в разделе Спецификация автоматизации пользовательского интерфейса для доступных расширенных интернет-приложений W3C.
AriaProperties — это коллекция пар "имя-значение" с разделителями = (равно) и ; (точка с запятой), например "checked=true;disabled=false". (обратная \ косая черта) используется в качестве escape-символа, когда эти символы-разделители или \ отображаются в значениях. По соображениям безопасности и другим причинам реализация этого свойства поставщика может предпринять шаги для проверки исходных свойств ARIA; однако это не обязательно.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_AriaRolePropertyId
30101
Определяет свойство AriaRole , которое представляет собой строку, содержащую сведения о роли ARIA для элемента автоматизации. Дополнительные сведения о сопоставлении ролей ARIA с типами элементов управления автоматизации пользовательского интерфейса см. в разделе Спецификация автоматизации пользовательского интерфейса для доступных расширенных интернет-приложений W3C.

Примечание.
Кроме того, агент пользователя может предложить локализованное описание роли W3C ARIA в свойстве LocalizedControlType . Если локализованная строка не указана, система предоставит для элемента строку LocalizedControlType по умолчанию.



Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка

UIA_AutomationIdPropertyId
30011
Идентифицирует свойство AutomationId , которое представляет собой строку, содержащую идентификатор автоматизации пользовательского интерфейса для элемента автоматизации.
Если он доступен, значение AutomationId элемента должно быть одинаковым в любом экземпляре приложения, независимо от локального языка. Значение должно быть уникальным среди элементов того же уровня, но не обязательно уникальным для всего рабочего стола. Например, несколько экземпляров приложения или несколько представлений папок в Microsoft Windows Обозреватель могут содержать элементы с одинаковым свойством AutomationId, например SystemMenuBar.
Хотя поддержка AutomationId всегда рекомендуется для улучшения поддержки автоматического тестирования, это свойство не является обязательным. Там, где он поддерживается, AutomationId полезен для создания скрипта автоматизации тестирования, который выполняется независимо от языка пользовательского интерфейса. Клиенты не должны делать никаких предположений относительно значений AutomationId , предоставляемых другими приложениями. AutomationId не гарантирует стабильность в разных выпусках или сборках приложения.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_BoundingRectanglePropertyId
30001
Определяет свойство BoundingRectangle , указывающее координаты прямоугольника, полностью включающего элемент автоматизации. Прямоугольник выражается в физических координатах экрана. Он может содержать точки, которые нельзя щелкать, если фигура или область элемента пользовательского интерфейса нерегулярны или элемент скрыт другими элементами пользовательского интерфейса.
Тип варианта: VT_R8 | VT_ARRAY
Значение по умолчанию: [0,0,0,0]

Примечание.
Это свойство имеет значение NULL , если элемент в настоящее время не отображает пользовательский интерфейс.



UIA_CenterPointPropertyId
30165
Идентифицирует свойство CenterPoint , указывающее координаты центра X и точки Y элемента автоматизации. Пространство координат — это то, что поставщик логически считает страницей.
Тип варианта: VT_R8 | VT_ARRAY
Значение по умолчанию: VT_EMPTY
UIA_ClassNamePropertyId
30012
Идентифицирует свойство ClassName , которое представляет собой строку, содержащую имя класса для элемента автоматизации, назначенное разработчиком элемента управления.
Имя класса зависит от реализации поставщика автоматизации пользовательского интерфейса и, следовательно, не всегда имеет стандартный формат. Однако если имя класса известно, его можно использовать для проверки того, работает ли приложение с ожидаемым элементом автоматизации.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_ClickablePointPropertyId
30014
Определяет свойство ClickablePoint , которое является точкой на элементе автоматизации, который можно щелкнуть. Невозможно щелкнуть элемент, если он полностью или частично скрыт другим окном.
Тип варианта: VT_R8 | VT_ARRAY
Значение по умолчанию: VT_EMPTY
UIA_ControllerForPropertyId
30104
Идентифицирует свойство ControllerFor , которое представляет собой массив элементов автоматизации, которыми управляет элемент автоматизации, поддерживающий это свойство.
ControllerFor используется, когда элемент автоматизации влияет на один или несколько сегментов пользовательского интерфейса приложения или рабочего стола; В противном случае трудно связать влияние операции элемента управления с элементами пользовательского интерфейса.
Этот идентификатор обычно используется для автоматического предложения специальных возможностей.
Тип variant для поставщиков: VT_UNKNOWN | VT_ARRAY
Тип variant для клиентов: VT_UNKNOWN (IUIAutomationElementArray )
Значение по умолчанию: пустой массив
UIA_ControlTypePropertyId
30003
Идентифицирует свойство ControlType , которое является классом, определяющим тип элемента автоматизации. ControlType определяет характеристики элементов пользовательского интерфейса с помощью известных примитивов элементов управления пользовательского интерфейса, таких как кнопка или проверка поле.
Тип варианта: VT_I4
Значение по умолчанию: UIA_CustomControlTypeId

Примечание.
Используйте значение по умолчанию, только если элемент автоматизации представляет совершенно новый тип элемента управления.



UIA_CulturePropertyId
30015
Идентифицирует свойство Culture, содержащее идентификатор языкового стандарта для элемента автоматизации (например, 0x0409 для en-US или english (США)).
Каждый языковой стандарт имеет уникальный идентификатор, 32-разрядное значение, состоящее из идентификатора языка и идентификатора порядка сортировки. Идентификатор языкового стандарта является стандартным международным числовым сокращением и содержит компоненты, необходимые для уникальной идентификации одного из установленных языковых стандартов, определенных операционной системой. Дополнительные сведения см. в разделе Константы и строки идентификатора языка.
Это свойство может существовать для каждого элемента управления, но обычно доступно только на уровне приложения.
Тип варианта: VT_I4
Значение по умолчанию: 0
UIA_DescribedByPropertyId
30105
Идентифицирует свойство DescribedBy , представляющее собой массив элементов, предоставляющих дополнительные сведения об элементе автоматизации.
ОписаниеBy используется, когда элемент автоматизации объясняется другим сегментом пользовательского интерфейса приложения. Например, свойство может указывать на текстовый элемент "2529 элементов в 85 группах, 10 выбранных элементов" из сложного пользовательского объекта списка. Вместо того, чтобы использовать объектную модель для клиентов для переваривания аналогичных сведений, свойство DescribeBy может обеспечить быстрый доступ к элементу пользовательского интерфейса, который уже может предоставлять полезные сведения для конечного пользователя, описывающие элемент пользовательского интерфейса.
Тип variant для поставщиков: VT_UNKNOWN | VT_ARRAY
Тип Variant для клиентов: VT_UNKNOWN (IUIAutomationElementArray)
Значение по умолчанию: пустой массив
UIA_FillColorPropertyId
30160
Определяет свойство FillColor , указывающее цвет, используемый для заполнения элемента автоматизации. Этот атрибут задается как COLORREF, 32-битовое значение, используемое для указания цвета RGB или RGBA.
Тип варианта: VT_I4
Значение по умолчанию: 0
UIA_FillTypePropertyId
30162
Идентифицирует свойство FillType , указывающее шаблон, используемый для заполнения элемента автоматизации, например none, color, градиент, picture, pattern и т. д.
Тип варианта: VT_I4
Значение по умолчанию: 0
UIA_FlowsFromPropertyId
30148
Идентифицирует свойство FlowsFrom , представляющее собой массив элементов автоматизации, который предлагает порядок чтения перед текущим элементом автоматизации. Поддерживается начиная с Windows 8.
Свойство FlowsFrom определяет порядок чтения, если элементы автоматизации не предоставляются или структурированы в том же порядке чтения, который воспринимается пользователем. Хотя свойство FlowsFrom может указать несколько предыдущих элементов, оно обычно содержит только предыдущий элемент в порядке чтения.
Тип variant для поставщиков: VT_UNKNOWN | VT_ARRAY
Тип Variant для клиентов: VT_UNKNOWN (IUIAutomationElementArray)
Значение по умолчанию: пустой массив
UIA_FlowsToPropertyId
30106
Определяет свойство FlowsTo , представляющее собой массив элементов автоматизации, который предлагает порядок чтения после текущего элемента автоматизации.
Свойство FlowsTo задает порядок чтения, если элементы автоматизации не предоставляются или не структурированы в том же порядке чтения, который воспринимается пользователем. Хотя свойство FlowsTo может указать несколько последующих элементов, оно обычно содержит только следующий элемент в порядке чтения.
Тип variant для поставщиков: VT_UNKNOWN | VT_ARRAY
Тип Variant для клиентов: VT_UNKNOWN (IUIAutomationElementArray)
Значение по умолчанию: пустой массив
UIA_FrameworkIdPropertyId
30024
Идентифицирует свойство FrameworkId , которое представляет собой строку, содержащую имя базовой платформы пользовательского интерфейса, к которой принадлежит элемент автоматизации.
FrameworkId позволяет клиентским приложениям обрабатывать элементы автоматизации по-разному в зависимости от конкретной платформы пользовательского интерфейса. Примеры значений свойств включают "Win32", "WinForm" и "DirectUI".
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_FullDescriptionPropertyId
30159
Свойство FullDescription предоставляет локализованную строку, которая может содержать расширенный текст описания для элемента. FullDescription может содержать более полное описание элемента, чем может быть уместно для элемента Name.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_HasKeyboardFocusPropertyId
30008
Определяет свойство HasKeyboardFocus , представляющее собой логическое значение, указывающее, имеет ли элемент автоматизации фокус клавиатуры.
Тип варианта: VT_BOOL
Значение по умолчанию: FALSE
UIA_HeadingLevelPropertyId
30173
Определяет свойство HeadingLevel , указывающее уровень заголовка элемента автоматизации пользовательского интерфейса.
Тип варианта: VT_I4
Значение по умолчанию: HeadingLevel_None
UIA_HelpTextPropertyId
30013
Определяет свойство HelpText , которое представляет собой текстовую строку справки, связанную с элементом автоматизации.
Свойство HelpText может поддерживаться с текстом заполнителя, отображаемым в элементах управления "Редактирование" или "Список". Например, "Введите текст здесь для поиска" является хорошим кандидатом для свойства HelpText для элемента управления редактированием, который помещает текст до фактического ввода пользователя. Однако он не подходит для свойства name элемента управления редактированием.
При поддержке HelpText строка должна соответствовать языку пользовательского интерфейса приложения или языку пользовательского интерфейса операционной системы по умолчанию.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_IsContentElementPropertyId
30017
Определяет свойство IsContentElement , представляющее собой логическое значение, указывающее, отображается ли элемент в представлении содержимого дерева элементов автоматизации. Дополнительные сведения см. в разделе Общие сведения о дереве автоматизации пользовательского интерфейса.

Примечание.
Чтобы элемент отображался в представлении содержимого, свойства IsContentElement и IsControlElement должны иметь значение TRUE.



Тип варианта: VT_BOOL
Значение по умолчанию: TRUE

UIA_IsControlElementPropertyId
30016
Определяет свойство IsControlElement , представляющее собой логическое значение, указывающее, отображается ли элемент в представлении элемента управления дерева элементов автоматизации. Дополнительные сведения см. в разделе Общие сведения о дереве автоматизации пользовательского интерфейса.
Тип варианта: VT_BOOL
Значение по умолчанию: TRUE
UIA_IsDataValidForFormPropertyId
30103
Определяет свойство IsDataValidForForm , представляющее собой логическое значение, указывающее, является ли введенное или выбранное значение допустимым для правила формы, связанного с элементом автоматизации. Например, если пользователь ввел "425-555-5555" для поля почтового индекса, которое требует 5 или 9 цифр, свойство IsDataValidForForm может иметь значение FALSE , чтобы указать, что данные являются недопустимыми.
Тип варианта: VT_BOOL
Значение по умолчанию: FALSE
UIA_IsDialogPropertyId
30174
Определяет свойство IsDialog , представляющее собой логическое значение, указывающее, является ли элемент автоматизации диалоговым окном. Например, специальные возможности, такие как средства чтения с экрана, обычно говорят название диалогового окна, элемент управления с фокусом в диалоговом окне, а затем содержимое диалога вплоть до элемента управления с фокусом ("Сохранить изменения перед закрытием"). Для стандартных окон средство чтения с экрана обычно произносит заголовок окна, за которым следует элемент управления с фокусом. Для свойства IsDialog можно задать значение TRUE , чтобы указать, что клиентское приложение должно рассматривать элемент как диалоговое окно.
Тип варианта: VT_BOOL
Значение по умолчанию: FALSE
UIA_IsEnabledPropertyId
30010
Определяет свойство IsEnabled , представляющее собой логическое значение, указывающее, включен ли элемент пользовательского интерфейса, на который ссылается элемент автоматизации, и с ним можно взаимодействовать.
Если для элемента управления включено состояние FALSE, предполагается, что дочерние элементы управления также не включены. Клиенты не должны ожидать события изменения свойств от дочерних элементов при изменении состояния родительского элемента управления.
Тип варианта: VT_BOOL
Значение по умолчанию: FALSE
UIA_IsKeyboardFocusablePropertyId
30009
Определяет свойство IsKeyboardFocusable , представляющее собой логическое значение, указывающее, может ли элемент автоматизации принимать фокус клавиатуры.
Тип варианта: VT_BOOL
Значение по умолчанию: FALSE
UIA_IsOffscreenPropertyId
30022
Идентифицирует свойство IsOffscreen , которое является логическим значением, которое указывает, полностью ли элемент автоматизации прокручивается за пределы представления (например, элемент в списке, который находится за пределами окна просмотра объекта контейнера) или свернут из представления (например, элемент в представлении в виде дерева или меню или в свернутом окне). Если элемент имеет доступную для щелчка точку, которая может привести к тому, что он получает фокус, он считается на экране, а часть элемента находится за его экраном.
Значение свойства не зависит от окклюзии другими окнами или от того, отображается ли элемент на определенном мониторе.
Если свойство IsOffscreen имеет значение TRUE, элемент пользовательского интерфейса прокручивается за экран или свернут. Элемент временно скрыт, но остается в представлении конечного пользователя и продолжает включаться в модель пользовательского интерфейса. Объект можно вернуть в представление путем прокрутки, щелчка раскрывающегося списка и т. д.
Объекты, которые конечный пользователь вообще не воспринимает или которые являются "программно скрытыми" (например, диалоговое окно, которое было отклонено, но базовый объект по-прежнему кэшируется приложением), не должны находиться в дереве элементов автоматизации (вместо установки состояния IsOffscreen в значение TRUE).
Тип варианта: VT_BOOL
Значение по умолчанию: FALSE
UIA_IsPasswordPropertyId
30019
Определяет свойство IsPassword , которое представляет собой логическое значение, указывающее, содержит ли элемент автоматизации защищенное содержимое или пароль.
Если свойство IsPassword имеет значение TRUE и элемент имеет фокус клавиатуры, клиентское приложение должно отключить эхо клавиатуры или обратную связь ввода клавиатуры, которые могут предоставлять защищенную информацию пользователя. Попытка доступа к свойству Value защищенного элемента (элемент управления "Изменить") может привести к ошибке.
Тип варианта: VT_BOOL
Значение по умолчанию: FALSE
UIA_IsPeripheralPropertyId
30150
Определяет свойство IsPeripheral , представляющее собой логическое значение, указывающее, представляет ли элемент автоматизации периферийный пользовательский интерфейс. Периферийный пользовательский интерфейс отображается и поддерживает взаимодействие с пользователем, но не принимает фокус клавиатуры при появлении. Примеры периферийного пользовательского интерфейса включают всплывающие окна, всплывающие элементы, контекстные меню или плавающие уведомления. Поддерживается начиная с Windows 8.1.
Если свойство IsPeripheral имеет значение TRUE, клиентское приложение не может предположить, что фокус был взят элементом, даже если он в настоящее время является интерактивным с помощью клавиатуры.
Это свойство относится к следующим типам элементов управления:
  • UIA_GroupControlTypeId
  • UIA_MenuControlTypeId
  • UIA_PaneControlTypeId
  • UIA_ToolBarControlTypeId
  • UIA_ToolTipControlTypeId
  • UIA_WindowControlTypeId
  • UIA_CustomControlTypeId
Тип варианта: VT_BOOL
Значение по умолчанию: FALSE
UIA_IsRequiredForFormPropertyId
30025
Определяет свойство IsRequiredForForm , представляющее собой логическое значение, указывающее, требуется ли заполнение элемента автоматизации в форме.
Тип варианта: VT_BOOL
Значение по умолчанию: FALSE
UIA_ItemStatusPropertyId
30026
Определяет свойство ItemStatus , которое представляет собой текстовую строку, описывающую состояние элемента элемента автоматизации.
ItemStatus позволяет клиенту определить, передает ли элемент состояние элемента, а также его состояние. Например, элемент, связанный с контактом в приложении для обмена сообщениями, может быть "Занят" или "Подключен".
При поддержке ItemStatus строка должна соответствовать языку пользовательского интерфейса приложения или языку пользовательского интерфейса операционной системы по умолчанию.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_ItemTypePropertyId
300021
Определяет свойство ItemType , которое представляет собой текстовую строку, описывающую тип элемента автоматизации.
ItemType используется для получения сведений об элементах в списке, представлении в виде дерева или сетке данных. Например, элементом в представлении каталога файлов может быть "Файл документа" или "Папка".
Если itemType поддерживается, строка должна соответствовать языку пользовательского интерфейса приложения или языку пользовательского интерфейса операционной системы по умолчанию.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_LabeledByPropertyId
30018
Идентифицирует свойство LabeledBy , которое является элементом автоматизации, содержащим текстовую метку для этого элемента.
Это свойство можно использовать для получения, например, статической текстовой метки для поля со списком.
Тип варианта: VT_UNKNOWN
Значение по умолчанию: NULL
UIA_LandmarkTypePropertyId
30157
Определяет свойство LandmarkType , которое является идентификатором типа ориентира , связанным с элементом.
Свойство LandmarkType описывает элемент, представляющий группу элементов. Например, ориентир поиска может представлять набор связанных элементов управления для поиска.
Если используется UIA_CustomLandmarkTypeId , для описания пользовательского ориентира требуется UIA_LocalizedLandmarkTypePropertyId .
Тип варианта: VT_I4
Значение по умолчанию: 0
UIA_LevelPropertyId
30154
Определяет свойство Level , которое представляет собой целое число на основе 1, связанное с элементом автоматизации.
Свойство Level описывает расположение элемента внутри иерархической или неработающие иерархические структуры. Например, маркированный или нумерованный список, заголовки или другие структурированные элементы данных могут иметь различные связи "родители-потомки". Уровень описывает расположение элемента в структуре.
Рекомендуется использовать шаблон элемента управления CustomNavigation в сочетании с level.
Тип варианта: VT_I4
Значение по умолчанию: 0
UIA_LiveSettingPropertyId
30135
Определяет свойство LiveSetting , которое поддерживается элементом автоматизации, представляющим динамическую область. Свойство LiveSetting указывает уровень "вежливости", который клиент должен использовать для уведомления пользователя об изменениях в активном регионе. Это свойство может быть одним из значений перечисления LiveSetting . Поддерживается начиная с Windows 8.
Тип варианта: VT_I4
Значение по умолчанию: 0
UIA_LocalizedControlTypePropertyId
30004
Определяет свойство LocalizedControlType , представляющее собой текстовую строку, описывающую тип элемента управления, который представляет элемент автоматизации. Строка должна содержать только символы нижнего регистра:
  • Правильно: "кнопка"
  • Неправильно: "Кнопка"

Если localizedControlType не указан поставщиком элементов, локализованная строка по умолчанию предоставляется платформой в соответствии с типом элемента управления (например, "кнопка" для типа элемента управления Button ). Элемент автоматизации с типом пользовательского элемента управления должен поддерживать локализованную строку типа элемента управления, представляющую роль элемента (например, "палитра" для пользовательского элемента управления, который позволяет пользователям выбирать и задавать цвета).
При указании пользовательского значения строка должна соответствовать языку пользовательского интерфейса приложения или языку пользовательского интерфейса операционной системы по умолчанию.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_LocalizedLandmarkTypePropertyId
30158
Идентифицирует LocalizedLandmarkType, представляющий собой текстовую строку, описывающую тип ориентира, который представляет элемент автоматизации.
Его следует использовать совместно с UIA_CustomLandmarkTypeId однако LocalizedLandmarkType всегда должен иметь приоритет над LandmarkType и использоваться для описания ориентира перед LandmarkType.
Строка должна соответствовать языку пользовательского интерфейса приложения или языку пользовательского интерфейса операционной системы по умолчанию.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_NamePropertyId
30005
Идентифицирует свойство Name , которое представляет собой строку, содержащую имя элемента автоматизации.
Свойство Name должно совпадать с текстом метки на экране. Например, имя должно быть "Обзор" для элемента кнопки с меткой "Обзор". Свойство Name не должно содержать мнемонический символ для клавиш доступа (т. е. "&"), который подчеркивается в текстовом представлении пользовательского интерфейса. Кроме того, свойство Name не должно быть расширенной или измененной версией экранной метки, так как несоответствие между именем и меткой может привести к путанице между клиентскими приложениями и пользователями.
Если соответствующий текст метки не отображается на экране или когда он заменяется графикой, следует выбрать альтернативный текст. Альтернативный текст должен быть кратким, интуитивно понятным и локализованным для языка пользовательского интерфейса приложения или языка пользовательского интерфейса операционной системы по умолчанию. Альтернативный текст должен быть не подробным описанием визуальных элементов, а кратким описанием функции или функции пользовательского интерфейса, как если бы они были помечены простым текстом. Например, кнопка меню "Пуск" Windows называется "Пуск" (кнопка) вместо "Логотип Windows на синей круглой шарной графике" (кнопка). Дополнительные сведения см. в разделе Создание текстовых эквивалентов для изображений.
Если метка пользовательского интерфейса использует текстовые рисунки (например, используя ">>" для кнопки, которая добавляет элемент слева направо), свойство Name должно быть переопределено соответствующим текстовым вариантом (например, "Добавить"). Однако использование текстовой графики в качестве метки пользовательского интерфейса не рекомендуется из-за проблем с локализацией и специальными возможностями.
Свойство Name не должно содержать сведения о роли или типе элемента управления, например "кнопка" или "список"; В противном случае он будет конфликтовать с текстом из свойства LocalizedControlType при добавлении этих двух свойств (многие существующие вспомогательные технологии делают это).
Свойство Name нельзя использовать в качестве уникального идентификатора для одноуровневых элементов. Тем не менее, если оно соответствует представлению пользовательского интерфейса, одно и то же значение Name может поддерживаться для одноранговых узлов. Для автоматизации тестирования клиентам следует использовать свойство AutomationId или RuntimeId .
Для элементов управления "Текст" свойство Name не всегда должно совпадать с текстом, отображаемым в элементе управления , при условии, что шаблон "Текст " также поддерживается.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_NativeWindowHandlePropertyId
30020
Определяет свойство NativeWindowHandle , представляющее собой целое число, представляющее дескриптор (HWND) окна элемента автоматизации, если оно существует; В противном случае это свойство равно 0.
Тип варианта: VT_I4
Значение по умолчанию: 0
UIA_OptimizeForVisualContentPropertyId
30111
Определяет свойство OptimizeForVisualContent , представляющее собой логическое значение, указывающее, предоставляет ли поставщик только видимые элементы. Поставщик может использовать это свойство для оптимизации производительности при работе с очень большими фрагментами содержимого. Например, когда пользователь просматривает большой фрагмент содержимого, поставщик может уничтожить элементы содержимого, которые больше не видны. При уничтожении элемента содержимого поставщик должен вернуть код ошибки UIA_E_ELEMENTNOTAVAILABLE . Поддерживается начиная с Windows 8.
Тип варианта: VT_BOOL
Значение по умолчанию: FALSE
UIA_OrientationPropertyId
300023
Определяет свойство Orientation , указывающее ориентацию элемента управления, представленного элементом автоматизации. Свойство выражается в виде значения из перечисленного типа OrientationType .
Свойство Orientation поддерживается элементами управления, такими как полосы прокрутки и ползунки, которые могут иметь вертикальную или горизонтальную ориентацию. В противном случае его всегда можно OrientationType_None, что означает, что элемент управления не имеет ориентации.
Тип варианта: VT_I4
Значение по умолчанию: 0 (OrientationType_None)
UIA_OutlineColorPropertyId
30161
Определяет свойство OutlineColor , указывающее цвет, используемый для контура элемента автоматизации. Этот атрибут задается как COLORREF, 32-разрядное значение, используемое для указания цвета RGB или RGBA.
Тип варианта: VT_I4 | VT_ARRAY
Значение по умолчанию: 0
UIA_OutlineThicknessPropertyId
30164
Определяет свойство OutlineThickness , указывающее ширину контура элемента автоматизации.
Тип варианта: VT_R8 | VT_ARRAY
Значение по умолчанию: VT_EMPTY
UIA_PositionInSetPropertyId
30152
Определяет свойство PositionInSet , которое представляет собой целое число на основе 1, связанное с элементом автоматизации. PositionInSet описывает порядковый номер элемента в наборе элементов, которые считаются одноуровневые.
PositionInSet работает в координации со свойством SizeOfSet , чтобы описать порядковый номер в наборе.
Тип варианта: VT_I4
Значение по умолчанию: 0
UIA_ProcessIdPropertyId
30002
Идентифицирует свойство ProcessId , представляющее собой целое число, представляющее идентификатор процесса (ID) элемента автоматизации.
Идентификатор процесса (ID) назначается операционной системой. Его можно увидеть в столбце PID на вкладке Процессы в диспетчере задач.
Тип варианта: VT_I4
Значение по умолчанию: 0
UIA_ProviderDescriptionPropertyId
30107
Определяет свойство ProviderDescription , которое представляет собой форматированную строку, содержащую сведения об источнике поставщика автоматизации пользовательского интерфейса для элемента автоматизации, включая сведения о прокси-сервере.
Тип варианта: VT_BSTR
Значение по умолчанию: пустая строка
UIA_RotationPropertyId
30166
Идентифицирует свойство Rotation , указывающее угол поворота в неопределенных единицах.
Тип варианта: VT_R8
Значение по умолчанию: 0
UIA_RuntimeIdPropertyId
30 000
Идентифицирует свойство RuntimeId , которое представляет собой массив целых чисел, представляющих идентификатор элемента автоматизации.
Идентификатор уникален на рабочем столе, но он гарантированно будет уникальным только в пользовательском интерфейсе рабочего стола, на котором он был создан. Идентификаторы можно использовать повторно со временем.
Формат RuntimeId может измениться. Возвращаемый идентификатор следует рассматривать как непрозрачное значение и использовать только для сравнения; например, чтобы определить, находится ли элемент автоматизации в кэше.
Тип варианта: VT_I4 | VT_ARRAY
Значение по умолчанию: VT_EMPTY
UIA_SizePropertyId
30167
Определяет свойство Size , указывающее ширину и высоту элемента автоматизации.
Тип варианта: VT_R8 | VT_ARRAY
Значение по умолчанию: VT_EMPTY
UIA_SizeOfSetPropertyId
30153
Определяет свойство SizeOfSet , которое представляет собой целое число на основе 1, связанное с элементом автоматизации. SizeOfSet описывает количество элементов автоматизации в группе или наборе, которые считаются одноуровневые элементы.
SizeOfSet работает в координации со свойством PositionInSet , чтобы описать количество элементов в наборе.
Тип варианта: VT_I4
Значение по умолчанию: 0
UIA_VisualEffectsPropertyId
30163
Идентифицирует свойство VisualEffects , представляющее собой битовое поле, указывающее эффекты на элемент автоматизации, такие как тень, отражение, свечение, мягкие края или скос.
VisualEffects:
  • VisualEffects_Shadow: 0x1
  • VisualEffects_Reflection: 0x2
  • VisualEffects_Glow: 0x4
  • VisualEffects_SoftEdges: 0x8
  • VisualEffects_Bevel: 0x10
Тип варианта: VT_I4
Значение по умолчанию: 0

Требования

Требование Значение
Минимальная версия клиента
Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера
Windows Server 2003 [классические приложения | Приложения UWP]
Заголовок
UIAutomationClient.h

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

Основные понятия

Общие сведения о свойствах автоматизированного пользовательского интерфейса

Получение свойств из элементов автоматизации пользовательского интерфейса