Fornecendo informações de acessibilidade para controles em um formulário do Windows

Artigo
12/18/2024

Os auxílios de acessibilidade são programas especializados e dispositivos que ajudam pessoas com deficiência a usar computadores com mais eficiência. Os exemplos incluem leitores de tela para pessoas cegas e utilitários de entrada de voz para pessoas que fornecem comandos verbais em vez de usar o mouse ou o teclado. Esses auxílios de acessibilidade interagem com as propriedades de acessibilidade expostas pelos controles do Windows Forms. Essas propriedades são:

AccessibilityObject
DescriçãoAcessívelDeAçãoPadrão
DescriçãoAcessível
NomeAcessível
FunçãoAcessível

Propriedade AccessibilityObject

Essa propriedade somente leitura contém uma instância de AccessibleObject. O AccessibleObject implementa a interface IAccessible, que fornece informações sobre a descrição, o local da tela, as habilidades de navegação e o valor do controle. O designer define esse valor quando o controle é adicionado ao formulário.

Propriedade AccessibleDefaultActionDescription

Essa cadeia de caracteres descreve a ação do controle. Ele não aparece na janela Propriedades e pode ser definido apenas no código. O exemplo a seguir define essa propriedade para um controle de botão:

Button1.AccessibleDefaultActionDescription = _  
   "Closes the application."

Button1.AccessibleDefaultActionDescription =
   "Closes the application.";

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

Propriedade AccessibleDescription

Essa cadeia de caracteres descreve o controle. Ele pode ser definido na janela Propriedades ou no código da seguinte maneira:

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

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

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

Propriedade AccessibleName

Esse é o nome de um controle relatado aos auxílios de acessibilidade. Ele pode ser definido na janela Propriedades ou no código da seguinte maneira:

Button1.AccessibleName = "Order"

Button1.AccessibleName = "Order";

button1->AccessibleName = "Order";

Propriedade AccessibleRole

Essa propriedade, que contém uma enumeração AccessibleRole, descreve o papel do controle na interface do usuário. Um novo controle tem o valor definido como Default. Isso significaria que, por padrão, um controle botão atua como um botão . Talvez você queira redefinir essa propriedade se um controle tiver outra função. Por exemplo, você pode estar usando um controle PictureBox como um gráfico, e talvez queira que os auxílios de acessibilidade relatem a função como um gráfico, não como um PictureBox. Talvez você também queira especificar essa propriedade para controles personalizados desenvolvidos. Essa propriedade pode ser definida na janela Propriedades ou no código da seguinte maneira:

PictureBox1.AccessibleRole = AccessibleRole.Chart

PictureBox1.AccessibleRole = AccessibleRole.Chart;

pictureBox1->AccessibleRole = AccessibleRole::Chart;

Compartilhar via