Propiedad Description (características de accesibilidad de Windows)

  • Artículo

Nota

La propiedad Description se usa a menudo incorrectamente y no es compatible con Microsoft Automatización de la interfaz de usuario. Los desarrolladores de servidores de accesibilidad activa de Microsoft no deben usar esta propiedad. Si se necesita más información para escenarios de accesibilidad y automatización, use las propiedades admitidas por Automatización de la interfaz de usuario elementos y patrones de control.

 

La propiedad Description de un objeto proporciona una descripción textual sobre la apariencia visual de un objeto. La descripción se usa principalmente para proporcionar un contexto mayor para usuarios ciegos o de visión baja, pero también se usa para la búsqueda de contextos u otras aplicaciones. Esta propiedad puede ayudar a los usuarios a comprender un icono o la apariencia visual general.

La propiedad Description se recupera llamando a IAccessible::get_accDescription.

Cuándo admitir la propiedad Description

Los servidores admiten la propiedad Description si la descripción no es obvia o cuando no es redundante en función de las propiedades Name, Role, State y Value del objeto. Por ejemplo, un botón con la etiqueta "Ok" no necesitaría información adicional, mientras que un botón que muestra una imagen de un cactus. Las propiedades Name, Role y Help de este tipo de botón describen su propósito, pero la propiedad Description transmite información que es menos tangible; por ejemplo, "Este botón muestra una imagen de un cactus".

Un servidor de accesibilidad activa de Microsoft puede agregar compatibilidad con Automatización de la interfaz de usuario mediante anotación directa, mediante la interfaz IAccessibleEx o mediante la implementación de Microsoft Active Accessibility y Automatización de la interfaz de usuario en paralelo con ambas implementaciones que controlan el WM_ Mensaje GETOBJECT.

Usar anotación directa

Interfaz IAccessibleEx