Fornecendo informações de acessibilidade para controles em um Windows FormProviding Accessibility Information for Controls on a Windows Form

Os recursos de acessibilidade são programas e dispositivos especializados que ajudam as pessoas com deficiência a usarem computadores de forma mais eficaz.Accessibility aids are specialized programs and devices that help people with disabilities use computers more effectively. Alguns exemplos incluem leitores de tela para pessoas cegas e utilitários de entrada de voz para as pessoas que fornecem comandos verbais em vez de usar o mouse ou teclado.Examples include screen readers for people who are blind and voice input utilities for people who provide verbal commands instead of using the mouse or keyboard. Esses recursos de acessibilidade interagem com as propriedades de acessibilidade expostas pelos controles dos Windows Forms.These accessibility aids interact with the accessibility properties exposed by Windows Forms controls. Essas propriedades são:These properties are:

  • AccessibilityObjectAccessibilityObject

  • AccessibleDefaultActionDescriptionAccessibleDefaultActionDescription

  • AccessibleDescriptionAccessibleDescription

  • AccessibleNameAccessibleName

  • AccessibleRoleAccessibleRole

Propriedade AccessibilityObjectAccessibilityObject Property

Essa propriedade somente leitura contém uma AccessibleObject instância.This read-only property contains an AccessibleObject instance. O AccessibleObject implementa a IAccessible interface, que fornece informações sobre a descrição do controle, o local da tela, as capacidades de navegação e o valor.The AccessibleObject implements the IAccessible interface, which provides information about the control's description, screen location, navigational abilities, and value. O designer define esse valor quando o controle é adicionado ao formulário.The designer sets this value when the control is added to the form.

Propriedade AccessibleDefaultActionDescriptionAccessibleDefaultActionDescription Property

Essa cadeia de caracteres descreve as ações do controle.This string describes the action of the control. Ela não aparece na janela Propriedades e só pode ser definido no código.It does not appear in the Properties window and may only be set in code. O exemplo a seguir define essa propriedade para um controle de botão:The following example sets this property for a button control:

Button1.AccessibleDefaultActionDescription = _  
   "Closes the application."  
Button1.AccessibleDefaultActionDescription =   
   "Closes the application.";  
button1->AccessibleDefaultActionDescription =  
   "Closes the application.";  

Propriedade AccessibleDescriptionAccessibleDescription Property

Essa cadeia de caracteres descreve o controle.This string describes the control. Ele pode ser definido na janela Propriedades ou no código da seguinte maneira:It may be set in the Properties window, or in code as follows:

Button1.AccessibleDescription = "A button with text 'Exit'."  
Button1.AccessibleDescription = "A button with text 'Exit'";  
button1->AccessibleDescription = "A button with text 'Exit'";  

Propriedade AccessibleNameAccessibleName Property

Esse é o nome de um controle relatado para os recursos de acessibilidade.This is the name of a control reported to accessibility aids. Ele pode ser definido na janela Propriedades ou no código da seguinte maneira:It may be set in the Properties window, or in code as follows:

Button1.AccessibleName = "Order"  
Button1.AccessibleName = "Order";  
button1->AccessibleName = "Order";  

Propriedade AccessibleRoleAccessibleRole Property

Essa propriedade, que contém uma AccessibleRole enumeração, descreve a função de interface do usuário do controle.This property, which contains an AccessibleRole enumeration, describes the user interface role of the control. Um novo controle tem o valor definido como Default.A new control has the value set to Default. Isso significa que, por padrão, um controle Botão atua como um Botão.This would mean that by default, a Button control acts as a Button. Pode ser útil redefinir essa propriedade se um controle tiver outra função.You may want to reset this property if a control has another role. Por exemplo, você pode estar usando um controle PictureBox como um Gráfico e pode desejar que os recursos de acessibilidade relatem a função como um Gráfico, não como PictureBox.For example, you may be using a PictureBox control as a Chart, and you may want accessibility aids to report the role as a Chart, not as a PictureBox. Também pode ser útil especificar essa propriedade para controles personalizados desenvolvidos por você.You may also want to specify this property for custom controls you have developed. Essa propriedade pode ser definida na janela Propriedades ou no código da seguinte maneira:This property may be set in the Properties window, or in code as follows:

PictureBox1.AccessibleRole = AccessibleRole.Chart  
PictureBox1.AccessibleRole = AccessibleRole.Chart;  
pictureBox1->AccessibleRole = AccessibleRole::Chart;  

Consulte tambémSee also