Role (propiedad)

La propiedad Role describe el elemento de interfaz de usuario de un objeto. Todos los objetos admiten la propiedad Role .

En muchos casos, el rol del objeto es obvio. Por ejemplo, las ventanas tienen el rol ROLE_SYSTEM_WINDOW y los botones de inserción tienen el rol ROLE_SYSTEM_PUSHBUTTON .

La propiedad Role se recupera llamando a IAccessible::get_accRole.

Identificación del rol de un objeto

La accesibilidad activa de Microsoft proporciona constantes de rol, definidas en oleacc.h, que identifican roles de objeto comunes. Se recomienda que los desarrolladores de servidores usen estos valores de rol predefinidos. Si se devuelve una constante de rol predefinida, los clientes usan la función GetRoleText para recuperar una cadena localizada que describe el rol.

Para los controles de animación, como el control de animación que se muestra al copiar archivos, use ROLE_SYSTEM_ANIMATION. Los gráficos que se animan ocasionalmente se describen como ROLE_SYSTEM_GRAPHIC con la propiedad State establecida en STATE_SYSTEM_ANIMATED.

Tenga en cuenta que algunos roles no son fáciles de describir. Por ejemplo, la vista de iconos grandes de una carpeta permite la organización arbitraria de iconos, por lo que su rol se podría describir como ROLE_SYSTEM_GROUPING. O bien, un control que proporciona elementos en filas y columnas fijas podría tener el rol ROLE_SYSTEM_TABLE . Dado que un rol se usa para comunicar el modelo de uso a un usuario final, es importante usar el rol adecuado. Por ejemplo, si el control actúa como un botón, use ROLE_SYSTEM_PUSHBUTTON.