Поделиться через

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

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

Элемент управления "Разделенная кнопка" позволяет выполнять действие на элементе управления и развернуть элемент управления, чтобы просмотреть список других возможных действий, которые можно выполнить.

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

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

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

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

Представление элемента управления Представление содержимого
  • SplitButton
    • Изображение (0 или 1)
    • Текст (0 или 1)
    • Кнопка (1 или 2)
      • Меню (0 или 1; отображается как дочерний элемент вложенной кнопки, поддерживающей шаблон ExpandCollapse).
        • MenuItem (1 ко многим)
  • SplitButton
    • Кнопка (1 или 2)
      • MenuItem (1 ко многим)

 

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

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания
UIA_AutomationIdPropertyId См. заметки. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. заметки. Поддерживается, если существует ограничивающий прямоугольник. Если не каждая точка в ограничивающем прямоугольнике можно щелкнуть, а элемент выполняет специализированное тестирование попаданий, переопределите и укажите точку, доступную для щелчка.
UIA_ControlTypePropertyId SplitButton Это значение одинаково для всех платформ пользовательского интерфейса.
UIA_HelpTextPropertyId См. заметки. Текст справки может указать результат активации кнопки разделения, которая обычно совпадает с типом информации, представленной с помощью подсказки.
UIA_IsContentElementPropertyId ИСТИННЫЙ Элемент управления "Разделенная кнопка" содержит сведения для конечного пользователя.
UIA_IsControlElementPropertyId ИСТИННЫЙ Элемент управления "Разделить" отображается для конечного пользователя.
UIA_IsKeyboardFocusablePropertyId См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId НЕДЕЙСТВИТЕЛЬНЫЙ Элементы управления "Разделение кнопки" не имеют статической текстовой метки.
UIA_LocalizedControlTypePropertyId См. заметки. Локализованная строка, соответствующая типу элемента управления SplitButton SplitButton. Значение по умолчанию — "разделить кнопку" для en-US или английского языка (США).
UIA_NamePropertyId См. заметки. Текст, используемый для метки кнопки разделения. Всякий раз, когда изображение используется для метки кнопки разделения, для свойства "Имя разделенной кнопки" необходимо указать альтернативный текст.

 

Обязательные шаблоны элементов управления

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

Шаблон элемента управления Поддержка Примечания
IExpandCollapseProvider Обязательно Так как кнопки разделения всегда имеют возможность развернуть список параметров, они должны поддерживать шаблон элемента управления ExpandCollapse.
IInvokeProvider Обязательно Так как кнопки разделения всегда имеют действие по умолчанию, связанное с методом IInvokeProvider::Invoke, они должны поддерживать шаблон элемента управления Invoke.

 

Обязательные события

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

Событие автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
событие UIA_BoundingRectanglePropertyId изменено свойством.
UIA_ExpandCollapseExpandCollapseStatePropertyId событие изменения свойства.
UIA_Invoke_InvokedEventId
событие UIA_IsEnabledPropertyId изменено свойством. Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие.
событие UIA_IsOffscreenPropertyId изменено свойством. Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие.
UIA_StructureChangedEventId

 

Пример типа элемента управления SplitButton

На следующем рисунке показан элемент управления, реализующий тип элемента управления SplitButton.

снимок экрана с примером элемента управления splitbutton

Дерево автоматизации пользовательского интерфейса — представление элемента управления Дерево автоматизации пользовательского интерфейса — представление содержимого
  • SplitButton "Name" (Invoke, ExpandCollapse)
    • Кнопка "Дополнительно" (Invoke)
      • Меню
        • MenuItem
        • ...
  • SplitButton "Name" (Invoke, ExpandCollapse)
    • Кнопка "Дополнительно" (Invoke)
      • Меню
        • MenuItem
        • ...

 

концептуальные

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

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