Тип элемента управления "Спиннер"

  • Статья

В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления Spinner.

Элементы управления "Счетчик" используются для выбора из домена элементов или диапазона чисел.

В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидная структура, свойства, шаблоны элементов управления и события для типа элемента управления Spinner. Требования к модель автоматизации пользовательского интерфейса применяются ко всем элементам управления spinner, в которых платформа пользовательского интерфейса интегрируется модель автоматизации пользовательского интерфейса поддержки типов элементов управления и шаблонов элементов управления.

В этом разделе содержатся следующие подразделы.

Типичная древовидная структура

В следующей таблице представлен типичный элемент управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящиеся к элементам управления spinner, если они поддерживают шаблоны элементов управления RangeValue и Selection, а также описывается, что может содержаться в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в разделе Общие сведения о дереве модель автоматизации пользовательского интерфейса.

Шаблон элемента управления RangeValue

Представление элемента управления Представление содержимого
  • Spinner
    • Edit (0 или 1)
    • Button (2)
  • Spinner

 

Selection - шаблон элемента управления

Представление элемента управления Представление содержимого
  • Spinner
    • Edit (0 или 1)
    • Button (2)
    • ListItem (0 или более)
  • Spinner
    • ListItem (0 или более)

 

Чтобы убедиться, что две кнопки в поддереве представления элемента управления можно различить с помощью автоматизированных средств тестирования, назначьте значение 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 событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления "Значение ", он должен поддерживать это событие.

 

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

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

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