Тип элемента управления "Ползунок"

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

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

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

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

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

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

Представление элемента управления Представление содержимого
  • Slider
    • Button (2 или 4)
    • Большой палец (1)
    • ListItem (0 или более)
  • Slider
    • ListItem (0 или более)

 

Соответствующие свойства

В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которых особенно актуально для элементов управления ползунка. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе "Получение свойств из элементов модель автоматизации пользовательского интерфейса".

Свойство модели автоматизации пользовательского интерфейса Значение Примечания
UIA_AutomationIdPropertyId См. примечания. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева модель автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. примечания. Внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. примечания. Большинство элементов управления ползунка должны возвращать ошибку UIA_E_NOCLICKABLEPOINT , так как весь ограничивающий прямоугольник элемента управления ползунка занят дочерними элементами управления.
UIA_ControlTypePropertyId Ползунок Это значение одинаково для всех инфраструктур.
UIA_IsContentElementPropertyId TRUE Элемент управления ползунок всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId TRUE Элемент управления ползунок всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId См. примечания. Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. Дочерние элементы (кнопки и большой палец) элемента управления ползунка никогда не должны принимать фокус. Фокус всегда должен оставаться на самом элементе управления ползунка.
UIA_LabeledByPropertyId См. примечания. При наличии статической текстовой метки, связанной с элементом управления, это свойство должно предоставлять ссылку на этот элемент управления. Если текстовый элемент управления является подкомпонентом другого элемента управления, он не будет иметь набор свойств LabeledBy .
UIA_LocalizedControlTypePropertyId См. примечания. Локализованная строка, соответствующая типу элемента управления Slider . Значение по умолчанию — "ползунок" для en-US или английского (США).
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 событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления "Значение ", он должен поддерживать это событие.

 

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

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

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