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

  • Статья

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

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

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

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

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

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

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

 

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

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

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

 

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

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

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