AutomationProperties.NameProperty 属性

定义

命名空间:

Microsoft.UI.Xaml.Automation

标识 AutomationProperties.Name 附加属性，该属性是保存自动化元素名称的字符串。

public:
 static property DependencyProperty ^ NameProperty { DependencyProperty ^ get(); };

static DependencyProperty NameProperty();

public static DependencyProperty NameProperty { get; }

var dependencyProperty = AutomationProperties.nameProperty;

Public Shared ReadOnly Property NameProperty As DependencyProperty

属性值

DependencyProperty

AutomationProperties.Name 附加属性的标识符。

注解

Name 属性应与屏幕上的标签文本相同。 例如，标签为“Browse”的按钮元素 的名称 应为“Browse”。 Name 属性不得包含访问键的助记键字符， (即“&”) ，该字符在 UI 文本演示文稿中带有下划线。 此外， Name 属性不应是屏幕标签的扩展或修改版本，因为名称和标签之间的不一致可能会导致客户端应用程序和用户混淆。

当相应的标签文本在屏幕上不可见时，或者当它被图形替换时，应选择替代文本。 替代文本应简洁直观，并本地化为应用程序 UI 语言或操作系统默认 UI 语言。 替代文本不应是视觉细节的详细说明，而应是 UI 函数或功能的简洁说明，就像用简单文本标记一样。 例如，Windows“开始”菜单按钮名为“开始” (按钮) ，而不是“蓝色圆形图形上的 Windows 徽标” (按钮) 。 有关详细信息，请参阅 为图像创建文本等效项。

例如，当 UI 标签使用文本图形 (将“”>>用于从左到右) 添加项的按钮时， Name 属性应由相应的文本替代项 (例如“添加”) 。 但是，由于本地化和辅助功能方面的考虑，不建议使用文本图形作为 UI 标签的做法。

Name 属性不得包含控件角色或类型信息，例如“按钮”或“列表”;否则，当将这两个属性追加 (许多现有辅助技术执行此操作时，它将与 LocalizedControlType 属性中的文本冲突) 。

Name 属性不能用作同级之间的唯一标识符。 但是，只要它与 UI 表示形式一致，对等方就可以支持相同的 Name 值。 对于测试自动化，客户端应考虑使用 AutomationId 或 RuntimeId 属性。

只要文本模式也受支持，文本控件不必始终具有 与 控件中显示的文本相同的 Name 属性。