更新：2007 年 11 月
本主题提供有关 UI 自动化对 SplitButton 控件类型的支持的信息。在 UI 自动化中，控件类型是一组条件，控件必须满足这些条件才能使用 ControlTypeProperty 属性。这些条件包括 UI 自动化树结构的特定准则、UI 自动化属性值以及控件模式。
使用拆分按钮控件，可以针对某个控件执行操作，并展开该控件以查看可以针对其执行的其他可能操作的列表。
以下几节定义了 SplitButton 控件类型必需的 UI 自动化树结构、属性、控件模式和事件。无论控件是 Windows Presentation Foundation (WPF)、Win32 还是 Windows 窗体，UI 自动化要求适用于所有拆分按钮控件.
本主题包括下列各节。
- 必需的 UI 自动化树结构
- 必需的 UI 自动化属性
- 必需的 UI 自动化控件模式
- 必需的 UI 自动化事件
- SplitButton 控件示例
- 相关主题
必需的 UI 自动化树结构
下表描述了与拆分按钮控件有关的 UI 自动化树的控件视图和内容视图，以及每个视图中可包含的内容。有关 UI 自动化树的更多信息，请参见 UI 自动化树概述。
控件视图 |
内容视图 |
|---|---|
|
|
必需的 UI 自动化属性
下表列出了值或定义与拆分按钮控件密切相关的 UI 自动化属性。有关 UI 自动化属性的更多信息，请参见客户端的 UI 自动化属性。
UI 自动化属性 |
值 |
说明 |
|---|---|---|
AutomationIdProperty() |
请参见“说明”。 |
此属性的值必须在应用程序中的所有控件中保持唯一。 |
请参见“说明”。 |
包含整个控件的最外面的矩形。 |
|
请参见“说明”。 |
有边框时支持。如果并非边框中的每个点都是可单击的，那么，当您执行专用的命中测试时，请重写并提供一个可单击的点。 |
|
请参见“说明”。 |
如果该控件可以接收键盘焦点，则它必须支持此属性。 |
|
"Back" |
拆分按钮控件的名称显示在相应的按钮上。 |
|
Null |
拆分按钮控件没有静态文本标签。 |
|
SplitButton |
此值对于所有的 UI 框架均相同。 |
|
"拆分按钮" |
与 SplitButton 控件类型相对应的本地化字符串。 |
|
"Left Arrow Symbol" |
该按钮中包含的图像的可视化说明。 |
|
True |
拆分按钮控件包含面向最终用户的信息。 |
|
True |
拆分按钮控件对最终用户可见。 |
必需的 UI 自动化控件模式
下表列出了必须由拆分按钮控件支持的 UI 自动化控件模式。有关控件模式的更多信息，请参见 UI 自动化控件模式概述。
控件模式/模式属性 |
支持/值 |
说明 |
|---|---|---|
必需 |
拆分按钮总是具有与 Invoke 相关联的默认操作。 |
|
必需 |
拆分按钮总是能够展开选项列表。 |
必需的 UI 自动化事件
下表列出了必须由所有拆分按钮控件支持的 UI 自动化事件。有关事件的更多信息，请参见 UI 自动化事件概述。
UI 自动化事件 |
支持 |
说明 |
|---|---|---|
必需 |
无 |
|
BoundingRectangleProperty property-changed 事件。 |
必需 |
无 |
IsOffscreenProperty property-changed 事件。 |
必需 |
无 |
IsEnabledProperty property-changed 事件。 |
必需 |
无 |
ExpandCollapseStateProperty property-changed 事件。 |
必需 |
无 |
必需 |
无 |
|
必需 |
无 |
SplitButton 控件示例
下图说明了数据网格控件中的 SplitButton 控件类型。
.gif)
下面显示了与数据网格和拆分按钮控件有关的 UI 自动化树的控件视图和内容视图。每个自动化元素的控件模式都显示在括号中。
UI 自动化树 - 控件视图 |
UI 自动化树 - 内容视图 |
|---|---|
DataGrid（Sort、Table、Selection 和 Grid）
|
DataGrid（Sort、Table、Selection 和 Grid）
|