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

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

  • Статья

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

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

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

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

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

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

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

 

Релевантные свойства

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

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

 

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

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

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

 

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

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

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

 

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

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

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

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

 

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

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

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