Тип элемента управления "Спиннер"
В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления Spinner.
Элементы управления "Счетчик" используются для выбора из домена элементов или диапазона чисел.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидная структура, свойства, шаблоны элементов управления и события для типа элемента управления Spinner. Требования к модель автоматизации пользовательского интерфейса применяются ко всем элементам управления spinner, в которых платформа пользовательского интерфейса интегрируется модель автоматизации пользовательского интерфейса поддержки типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие подразделы.
- Типичная древовидная структура
- Релевантные свойства
- Обязательные шаблоны элементов управления
- Обязательные события
- Связанные темы
Типичная древовидная структура
В следующей таблице представлен типичный элемент управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящиеся к элементам управления spinner, если они поддерживают шаблоны элементов управления RangeValue и Selection, а также описывается, что может содержаться в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в разделе Общие сведения о дереве модель автоматизации пользовательского интерфейса.
Шаблон элемента управления RangeValue
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Selection - шаблон элемента управления
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Чтобы убедиться, что две кнопки в поддереве представления элемента управления можно различить с помощью автоматизированных средств тестирования, назначьте значение ScrollAmount_SmallIncrement или ScrollAmount_SmallDecrement свойству AutomationId соответствующим образом. В некоторых реализациях связанный элемент управления редактированием может быть одноранговым элементом элемента управления spinner.
Релевантные свойства
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которых особенно важно для элементов управления spinner. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе Извлечение свойств из элементов модель автоматизации пользовательского интерфейса.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания |
|---|---|---|
| UIA_AutomationIdPropertyId | См. примечания. | Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева модель автоматизации пользовательского интерфейса. |
| UIA_BoundingRectanglePropertyId | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| UIA_ClickablePointPropertyId | См. примечания. | Активная точка управления "Счетчик" перемещает фокус в область редактирования элемента управления. |
| UIA_ControlTypePropertyId | Spinner | Это значение одинаково для всех инфраструктур. |
| UIA_IsContentElementPropertyId | TRUE | Элемент управления "Счетчик" всегда должен быть содержимым. |
| UIA_IsControlElementPropertyId | TRUE | Элемент управления спиннер всегда должен быть элементом управления. |
| UIA_IsKeyboardFocusablePropertyId | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. Элемент управления вращающегося элемента управления редко принимает фокус, но в этом случае фокус должен оставаться на самом элементе управления вращающегося, а не на дочерних кнопках. Пользователь должен иметь возможность выполнять все действия прокрутки с помощью клавиш СТРЕЛКА ВВЕРХ и СТРЕЛКА ВНИЗ. |
| UIA_LabeledByPropertyId | См. примечания. | Элементы управления "Счетчик" имеют метку со статическим текстом. |
| UIA_LocalizedControlTypePropertyId | См. примечания. | Локализованная строка, соответствующая типу элемента управления Spinner . Значение по умолчанию — "spinner" для en-US или english (США). |
| UIA_NamePropertyId | См. примечания. | Обычно элемент управления "Счетчик" получает имя из статической текстовой метки. |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления spinner. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления/свойство шаблона | Поддержка/значение | Примечания |
|---|---|---|
| IRangeValueProvider | Зависит | Элементы управления Spinner, охватывающие числовой диапазон, могут поддерживать шаблон элемента управления RangeValue . |
| ISelectionProvider | Зависит | Элементы управления Spinner, имеющие список элементов для выбора, должны поддерживать шаблон элемента управления Selection . |
| CanSelectMultiple | Ложь. | Элементы управления "Счетчик" всегда являются контейнерами с возможностью выбора одного варианта. |
| IValueProvider | Зависит | Элементы управления spinner, охватывающие набор параметров или чисел, могут поддерживать шаблон элемента управления "Значение ". |
Обязательные события
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, для поддержки которых требуются элементы управления спиннером. Дополнительные сведения о событиях см. в разделе 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 событие изменения свойства. | Если элемент управления поддерживает шаблон элемента управления "Значение ", он должен поддерживать это событие. |
Связанные темы
-
Основные понятия
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса
-
Общие сведения о модели автоматизации пользовательского интерфейса