.gif "注意") 注意 |
|---|
本文档的目标读者是欲使用 System.Windows.Automation 命名空间中定义的托管 UI Automation类的 .NET Framework 开发人员。有关 UI Automation的最新信息，请参见 Windows Automation API: UI Automation（Windows 自动化 API：UI 自动化）。 |
本主题介绍 UI Automation对 Edit 控件类型的支持。 在 UI Automation中，控件类型是一组条件，控件必须满足这些条件才能使用 ControlTypeProperty 属性。 这些条件包括 UI Automation树结构的特定准则、UI Automation属性值和控件模式。
Edit 控件允许用户查看和编辑不支持丰富格式的单行文本。
以下几节定义了 Edit 控件类型必需的 UI Automation树结构、属性、控件模式和事件。 UI Automation的要求适用于所有编辑控件，无论是 Windows Presentation Foundation (WPF)、Win32 还是 Windows Forms控件。
本主题包括下列各节。
- 必需的 UI 自动化树结构
- 必需的 UI 自动化属性
- 必需的 UI 自动化控件模式和属性
- 必需的 UI 自动化事件
- 相关主题
必需的 UI 自动化树结构
下表描述了与编辑控件有关的 UI Automation树的控件视图和内容视图，以及每个视图中可包含的内容。 有关 UI Automation树的更多信息，请参见 UI 自动化树概述。
控件视图 |
内容视图 |
|---|---|
Edit |
Edit |
实现 Edit 控件类型的控件在 UI Automation树的控件视图中始终没有滚动条，因为它是单行控件。 单行文本可能会在某些布局方案中换行。 Edit 控件类型最适用于保留少量的可编辑或可选择文本。
必需的 UI 自动化属性
下表列出了值或定义与编辑控件密切相关的 UI Automation属性。 有关 UI Automation 属性的更多信息，请参见 客户端的 UI 自动化属性。
UI Automation属性 |
值 |
注释 |
|---|---|---|
请参见“说明”。 |
此属性的值在应用程序的所有控件中都必须保持唯一。 |
|
请参见“说明”。 |
包含整个控件的最外面的矩形。 |
|
请参见“说明”。 |
编辑控件必须有可单击点，当用户在此单击鼠标时，可将输入焦点定位到控件的编辑部分。 |
|
请参见“说明”。 |
如果该控件可以接收键盘焦点，则它必须支持此属性。 |
|
请参见“说明”。 |
编辑控件的名称通常是从静态文本标签生成的。 如果没有静态文本标签，则 Name 的属性值必须由应用程序开发人员分配。 Name 属性决不应包含编辑控件的文本内容。 |
|
请参见“说明”。 |
如果存在与该控件相关联的静态文本标签，则该属性必须公开对该控件的引用。 如果该文本控件是另一个控件的子组件，则该文本控件没有 LabeledBy 属性集。 |
|
Edit |
此值对于所有 UI 框架均相同。 |
|
“编辑” |
与 Edit 控件类型相对应的本地化字符串。 |
|
True |
编辑控件始终包括在 UI Automation树的内容视图中。 |
|
True |
编辑控件始终包括在 UI Automation树的控件视图中。 |
|
请参见“说明”。 |
在包含密码的编辑控件上，必须设置为 True。 如果编辑控件确实包含密码内容，那么屏幕阅读器可使用该属性确定是否应当在用户击键时读取击键。 |
必需的 UI 自动化控件模式和属性
下表列出了必须由所有编辑控件支持的控件模式。 有关控件模式的更多信息，请参见 UI 自动化控件模式概述。
控件模式/控件模式属性 |
支持/值 |
注释 |
|---|---|---|
视情况而定 |
Edit 控件应支持 Text 控件模式，因为详细的文本信息应始终可用于客户端。 |
|
视情况而定 |
所有采用字符串的编辑控件都必须公开 Value 模式。 |
|
请参见“说明”。 |
必须设置此属性以指明控件是否可以具有以编程方式设置的值或用户可以编辑的值。 |
|
请参见“说明”。 |
此属性将返回编辑控件的文本内容。 如果 IsPasswordProperty 设置为 true，当请求时，此属性必须引发 InvalidOpertaionException。 |
|
视情况而定 |
所有采用数字范围的编辑控件必须公开 Range Value 控件模式。 |
|
请参见“说明”。 |
此属性必须是编辑控件内容所能设置的最小值。 |
|
请参见“说明”。 |
此属性必须是编辑控件内容所能设置的最大值。 |
|
请参见“说明”。 |
此属性必须指明该值所能设置的小数位数。 如果该编辑控件只能采用整数，则 SmallChangeProperty 必须为 1。 如果该编辑控件采用 1.0 到 2.0 之间的数，则 SmallChangeProperty 必须为 0.1。 如果该编辑控件采用 1.00 到 2.00 之间的数，那么 SmallChangeProperty 必须为 0.001。 |
|
Null |
此属性不需要在编辑控件上公开。 |
|
请参见“说明”。 |
此属性将指明编辑控件的数值内容。 当 UI Automation客户端设置了更精确的值（在 Minimum 和 Maximum 属性指定的范围内）时，Value 属性将自动四舍五入到最接近的可接受值。 |
必需的 UI 自动化事件
下表列出了所有编辑控件需要支持的 UI Automation事件。 有关事件的更多信息，请参见 UI 自动化事件概述。
UI Automation事件 |
支持 |
注释 |
|---|---|---|
必需 |
无 |
|
必需 |
无 |
|
必需 |
无 |
|
BoundingRectangleProperty property-changed 事件。 |
必需 |
无 |
IsOffscreenProperty property-changed 事件。 |
必需 |
无 |
IsEnabledProperty property-changed 事件。 |
必需 |
无 |
NameProperty property-changed 事件。 |
必需 |
无 |
ValueProperty property-changed 事件。 |
视情况而定 |
无 |
HorizontallyScrollableProperty property-changed 事件。 |
从不 |
无 |
HorizontalScrollPercentProperty property-changed 事件。 |
从不 |
无 |
HorizontalViewSizeProperty property-changed 事件。 |
从不 |
无 |
VerticalScrollPercentProperty property-changed 事件。 |
从不 |
无 |
VerticallyScrollableProperty property-changed 事件。 |
从不 |
无 |
VerticalViewSizeProperty property-changed 事件。 |
从不 |
无 |
ValueProperty property-changed 事件。 |
视情况而定 |
如果控件支持 Range Value 控件模式，则它必须支持此事件。 |
必需 |
无 |
|
必需 |
无 |