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