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

Статья
08/11/2011

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

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

В этом разделе содержатся сведения о поддержке UI Automation для типа элемента управления SplitButton. В UI Automation тип элемента управления представляет собой набор условий, которым элемент управления должен удовлетворять, чтобы использовать свойство ControlTypeProperty. К этим условиям относятся конкретные правила для древовидной структуры UI Automation, значений свойств UI Automation и шаблонов элементов управления.

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

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

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

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

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

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

Представление элементов управления	Представление содержимого
SplitButton Рисунок (0 или 1) Текст (0 или 1) Кнопка (1 или 2) Menu (0 или 1; выглядит как дочерний элемент кнопки, который поддерживает шаблон ExpandCollapse) MenuItem (1 или несколько)	SplitButton MenuItem (1 или несколько)

SplitButton

Рисунок (0 или 1)
Текст (0 или 1)
Кнопка (1 или 2)
- Menu (0 или 1; выглядит как дочерний элемент кнопки, который поддерживает шаблон ExpandCollapse)
- MenuItem (1 или несколько)

SplitButton

MenuItem (1 или несколько)

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

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

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

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

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

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

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

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

Событие UI Automation	Поддержка	Примечания
InvokedEvent	Обязательно	Нет
Событие, изменяемое свойством BoundingRectangleProperty.	Обязательно	Нет
Событие, изменяемое свойством IsOffscreenProperty.	Требуется	Нет
Событие, изменяемое свойством IsEnabledProperty.	Требуется	Нет
Событие, изменяемое свойством ExpandCollapseStateProperty.	Обязательно	Нет
AutomationFocusChangedEvent	Обязательно	Нет
StructureChangedEvent	Обязательно	Нет

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

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

Разворачивающаяся кнопка

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

Дерево UI Automation — представление элемента управления	Дерево UI Automation — представление содержимого
SplitButton "Name" (Invoke, ExpandCollapse) Button "More options" (Invoke) Меню MenuItem …	SplitButton "Name" (Invoke, ExpandCollapse) Button "More options" (Invoke) Меню MenuItem …