Поддержка автоматизации пользовательского интерфейса для типа элемента управления SplitButton
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о поддержке модель автоматизации пользовательского интерфейса для типа элемента управления SplitButton. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, модель автоматизации пользовательского интерфейса значения свойств и шаблоны элементов управления.
Элемент управления "Разворачивающаяся кнопка" позволяет выполнять действие в элементе управления и разворачивать этот элемент управления для просмотра списка других возможных действий, которые могут быть выполнены.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса структура дерева, свойства, шаблоны элементов управления и события для типа элемента управления SplitButton. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления разделенной кнопкой, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице показано представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, которое относится к элементам управления с разделением кнопки и описывает, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
SplitButton
|
SplitButton - MenuItem (1 ко многим) |
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которого особенно относится к элементам управления с разделением кнопки. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| ClickablePointProperty | См. примечания. | Поддерживается при наличии ограничивающего прямоугольника. Если не все точки внутри ограничивающего прямоугольника являются интерактивными и выполняется специализированная проверка на наличие данных, выполните переопределение и предоставьте интерактивную точку. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| NameProperty | "Назад" | Имя элемента управления "Разворачивающаяся кнопка" отображается на кнопке. |
| LabeledByProperty | Null | Элементы управления "Разворачивающаяся кнопка" не имеют меток со статическим текстом. |
| ControlTypeProperty | SplitButton | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| LocalizedControlTypeProperty | "разворачивающаяся кнопка" | Локализованная строка, соответствующая типу элемента управления SplitButton. |
| HelpTextProperty | См. примечания. | Текст справки может указывать результат активации разворачивающейся кнопки и обычно предоставляет тот же тип сведений, что и подсказка. |
| IsContentElementProperty | Истина | Элемент управления "Разворачивающаяся кнопка" содержит сведения для конечного пользователя. |
| IsControlElementProperty | Истина | Элемент управления "Разворачивающаяся кнопка" является видимым для конечного пользователя. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления разделенными кнопками. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| IInvokeProvider | Обязательное поле | Разворачивающиеся кнопки всегда имеют действие по умолчанию, связанное с Invoke. |
| IExpandCollapseProvider | Обязательное поле | Разворачивающиеся кнопки всегда имеют возможность развернуть список вариантов. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления с разделением кнопки. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| InvokedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваExpandCollapseStateProperty | Обязательное поле | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |
Пример элемента управления "Разворачивающаяся кнопка"
На следующем рисунке показан тип элемента управления SplitButton в элементе управления "Сетка данных".
Представление элемента управления и представление содержимого дерева модели автоматизации пользовательского интерфейса, относящиеся к элементам управления "Сетка данных" и "Разворачивающаяся кнопка", показаны ниже. Шаблоны элементов управления для каждого элемента автоматизации отображаются в круглых скобках.
| дерево модель автоматизации пользовательского интерфейса — представление элемента управления | дерево модель автоматизации пользовательского интерфейса — представление содержимого |
|---|---|
|
|