Тип элемента управления ползунка
В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса Майкрософт для типа элемента управления Slider.
Ползунок — это составной элемент управления с кнопками, которые позволяют пользователю задать числовый диапазон или выбрать из набора элементов.
В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления ползунка. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления ползункам, где платформа пользовательского интерфейса интегрирует поддержку автоматизации пользовательского интерфейса для типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие разделы.
- типичная структура дерева
- соответствующие свойства
- обязательные шаблоны элементов управления
- обязательные события
- связанные разделы
Типичная структура дерева
В следующей таблице представлено типичное представление элемента управления и содержимого дерева автоматизации пользовательского интерфейса, относящегося к элементам управления ползунка и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве автоматизации пользовательского интерфейса см. в обзоре дерева автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Соответствующие свойства
В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значение или определение которых особенно важно для элементов управления ползунка. Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в получения свойств из элементов автоматизации пользовательского интерфейса.
| Свойство автоматизации пользовательского интерфейса | Ценность | Примечания |
|---|---|---|
| UIA_AutomationIdPropertyId | См. заметки. | Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса. |
| UIA_BoundingRectanglePropertyId | См. заметки. | Самый внешний прямоугольник, содержащий весь элемент управления. |
| UIA_ClickablePointPropertyId | См. заметки. | Большинство элементов управления ползунка должны возвращать ошибку UIA_E_NOCLICKABLEPOINT, так как весь ограничивающий прямоугольник элемента управления ползунка занят дочерними элементами управления. |
| UIA_ControlTypePropertyId | ползунка | Это значение одинаково для всех платформ. |
| UIA_IsContentElementPropertyId | ИСТИННЫЙ | Элемент управления ползунок всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса. |
| UIA_IsControlElementPropertyId | ИСТИННЫЙ | Элемент управления ползунок всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса. |
| UIA_IsKeyboardFocusablePropertyId | См. заметки. | Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство. Дочерние элементы управления (кнопки и палец) элемента управления ползунка никогда не должны принимать фокус. Фокус всегда должен оставаться на самом элементе управления ползунка. |
| UIA_LabeledByPropertyId | См. заметки. | При наличии статической текстовой метки, связанной с элементом управления, это свойство должно предоставить ссылку на этот элемент управления. Если текстовый элемент управления является подкомпонентом другого элемента управления, он не будет иметь набор свойств LabeledBy. |
| UIA_LocalizedControlTypePropertyId | См. заметки. | Локализованная строка, соответствующая типу элемента управления ползунка. Значение по умолчанию — "ползунок" для en-US или английского (США). |
| UIA_NamePropertyId | См. заметки. | Имя элемента управления ползунка обычно создается из статической текстовой метки. Если нет статической текстовой метки, значение свойства для Name должно быть назначено разработчиком приложения. |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления ползунка. Дополнительные сведения о шаблонах элементов управления см. в шаблонах элементов управления автоматизации пользовательского интерфейса.
| Управление шаблоном или свойством шаблонов | Поддержка и значение | Примечания |
|---|---|---|
| IRangeValueProvider | Зависит | Ползунок должен поддерживать шаблон управления RangeValue, если содержимое может быть задано в числовом диапазоне. |
| ISelectionProvider | Зависит | Ползунок должен поддерживать шаблон элемента управления выбора, если содержимое представляет одно значение среди дискретного набора параметров. Если поддерживается шаблон элемента управления "Выбор", соответствующий выбор должен быть представлен как один или несколько дочерних элементов списка ползунка. |
| IValueProvider | Зависит | Ползунок должен поддерживать шаблон управления значением, если содержимое представляет одно значение среди дискретного набора параметров. |
Обязательные события
В следующей таблице перечислены события автоматизации пользовательского интерфейса, которые требуются для поддержки элементов управления ползунка. Дополнительные сведения о событиях см. в обзоре событий автоматизации пользовательского интерфейса.
| Событие автоматизации пользовательского интерфейса | Примечания |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| событие UIA_BoundingRectanglePropertyId изменено свойством. | |
| событие UIA_IsEnabledPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие. |
| событие UIA_IsOffscreenPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие. |
| событие UIA_RangeValueValuePropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления RangeValue, он должен поддерживать это событие. |
| UIA_Selection_InvalidatedEventId | Если элемент управления поддерживает шаблон элемента управления selection, он должен поддерживать это событие. |
| UIA_StructureChangedEventId | |
| UIA_ValueValuePropertyId событие изменения свойства. | Если элемент управления поддерживает шаблон Value, он должен поддерживать это событие. |
Связанные разделы
-
концептуальные
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса