Compartir a través de


Proporcionar información de accesibilidad de controles en un formulario Windows Forms

Actualización: noviembre 2007

Las ayudas de accesibilidad son programas y dispositivos especializados, que ayudan a las personas con discapacidades a utilizar de forma más eficiente los equipos. Algunos ejemplos son los lectores de pantalla para invidentes y las utilidades de entrada por voz para personas que utilizan comandos verbales en lugar de utilizar el mouse (ratón) o el teclado. Estas ayudas de accesibilidad interactúan con las propiedades de accesibilidad expuestas por los controles de formularios Windows Forms. Estas propiedades son las siguientes:

  • AccessibilityObject

  • AccessibleDefaultActionDescription

  • AccessibleDescription

  • AccessibleName

  • AccessibleRole

Propiedad AccessibilityObject

Esta propiedad de sólo lectura contiene una instancia de la clase AccessibleObject. AccessibleObject implementa la interfaz IAccessible, que proporciona información sobre la descripción del control, su ubicación en la pantalla, las funciones de desplazamiento y su valor. El diseñador establece este valor cuando se agrega el control al formulario.

Propiedad AccessibleDefaultActionDescription

Esta cadena describe la acción del control. No aparece en la ventana Propiedades y sólo puede establecerse en el código. El ejemplo siguiente establece esta propiedad para un control de botón:

' Visual Basic
Button1.AccessibleDefaultActionDescription = _
   "Closes the application."

// C#
Button1.AccessibleDefaultActionDescription = 
   "Closes the application.";

// C++
button1->AccessibleDefaultActionDescription =
   "Closes the application.";

Propiedad AccessibleDescription

Esta cadena describe el control. Puede establecerse en la ventana Propiedades o en el código, de la manera siguiente:

' Visual Basic
Button1.AccessibleDescription = "A button with text 'Exit'."

// C#
Button1.AccessibleDescription = "A button with text 'Exit'";

// C++
button1->AccessibleDescription = "A button with text 'Exit'";

Propiedad AccessibleName

Es el nombre de control del que se informa a las ayudas de accesibilidad. Puede establecerse en la ventana Propiedades o en el código, de la manera siguiente:

' Visual Basic
Button1.AccessibleName = "Order"

// C#
Button1.AccessibleName = "Order";

// C++
button1->AccessibleName = "Order";

Propiedad AccessibleRole

Esta propiedad, que contiene una enumeración AccessibleRole, describe la función de la interfaz del usuario del control. Los controles nuevos tienen su valor establecido en Default. Esto significa que, de forma predeterminada, un control Button actúa como Button. Puede restablecer esta propiedad si un control tiene otra función. Por ejemplo, puede que esté utilizando un control PictureBox como control Chart y que desee que las ayudas de accesibilidad informen de su función como Chart, no como PictureBox. También es posible que desee especificar esta propiedad para los controles personalizados que programe. Esta propiedad puede establecerse en la ventana Propiedades o en el código, de la manera siguiente:

' Visual Basic
PictureBox1.AccessibleRole = AccessibleRole.Chart

// C#
PictureBox1.AccessibleRole = AccessibleRole.Chart;

// C++
pictureBox1->AccessibleRole = AccessibleRole::Chart;

Vea también

Referencia

AccessibleObject

Control.AccessibilityObject

Control.AccessibleDefaultActionDescription

Control.AccessibleDescription

Control.AccessibleName

Control.AccessibleRole

AccessibleRole