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

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

Замечание

Эта документация предназначена для разработчиков .NET Framework, которые хотят использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в разделе API автоматизации Windows: автоматизация пользовательского интерфейса.

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

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

В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления SplitButton. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления разделенной кнопкой, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

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

Вид управления Просмотр содержимого
Раздельная кнопка

  • Изображение (0 или 1)
  • Текст (0 или 1)
  • Кнопка (1 или 2)

    • Меню (0 или 1; отображается как дочерний элемент кнопки, поддерживающей шаблон ExpandCollapse)
    • MenuItem (1 ко многим)
 Раздельная кнопка

- ЭлементМеню (1 к многим)

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

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания.
AutomationIdProperty См. заметки. Значение этого свойства должно быть уникальным для всех элементов управления в приложении.
BoundingRectangleProperty См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty См. заметки. Поддерживается, если существует ограничивающий прямоугольник. Если не на каждую точку в ограничивающем прямоугольнике можно щелкнуть, и вы проводите специализированную проверку на попадание, то переопределите и укажите точку, на которую можно щелкнуть.
IsKeyboardFocusableProperty См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
NameProperty "Назад" Имя элемента управления "разделённая кнопка" отображается на самой кнопке.
LabeledByProperty Недействительный Элементы управления "Разделение кнопки" не имеют статической текстовой метки.
ControlTypeProperty Раздельная кнопка Это значение одинаково для всех платформ пользовательского интерфейса.
LocalizedControlTypeProperty "Разбиение кнопки" Локализованная строка, соответствующая типу элемента управления SplitButton.
HelpTextProperty См. заметки. Текст справки может указать результат активации кнопки разделения, которая обычно совпадает с типом информации, представленной с помощью подсказки.
IsContentElementProperty Верно Элемент управления "Разделенная кнопка" содержит сведения для конечного пользователя.
IsControlElementProperty Верно Элемент управления "Разделить" отображается для конечного пользователя.

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

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

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

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

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

Событие автоматизации пользовательского интерфейса Поддержка Примечания.
InvokedEvent Обязательно Отсутствует
BoundingRectangleProperty событие изменения свойства. Обязательно Отсутствует
IsOffscreenProperty событие изменения свойства. Обязательно Отсутствует
IsEnabledProperty событие изменения свойства. Обязательно Отсутствует
ExpandCollapseStateProperty событие изменения свойства. Обязательно Отсутствует
AutomationFocusChangedEvent Обязательно Отсутствует
StructureChangedEvent Обязательно Отсутствует

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

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

Разделите кнопку

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

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

    • Меню
    • Элемент меню
    • …
  • SplitButton "Name" (вызов, развернуть/свернуть)
  • Кнопка "Дополнительные параметры" (Вызов)

    • Меню
    • Элемент меню
    • …

См. также

  • Last updated on