Description 属性 (Windows 辅助功能)

注意

Description 属性通常使用不当,不受 Microsoft UI 自动化支持。 Microsoft Active Accessibility 服务器开发人员不应使用此属性。 如果辅助功能和自动化方案需要更多信息,请使用UI 自动化元素和控件模式支持的属性。

 

对象的 Description 属性提供有关对象的视觉外观的文本说明。 该说明主要用于为弱视或盲人用户提供更深入的上下文,但也用于上下文搜索或其他应用程序。 此属性可帮助用户了解图标或整体视觉外观。

通过调用 IAccessible::get_accDescription 检索 Description 属性。

何时支持 Description 属性

如果 说明 不明显,或者根据对象的 NameRoleStateValue 属性不冗余,则服务器支持 Description 属性。 例如,标记为“确定”的按钮不需要其他信息,而显示仙人掌图片的按钮则不需要其他信息。 此类按钮 的名称角色帮助 属性描述了其用途,但 Description 属性传达的信息不太明显;例如,“此按钮显示仙人掌的图片。”

Microsoft Active Accessibility 服务器可以通过使用直接注释IAccessibleEx 接口或通过同时实现 Microsoft Active Accessibility 和 UI 自动化 这两个处理WM_GETOBJECT消息的实现来添加对UI 自动化的支持

使用直接批注

IAccessibleEx 接口