Propriedade Description (recursos de acessibilidade do Windows)

Observação

A propriedade Description geralmente é usada incorretamente e não tem suporte do Microsoft Automação da Interface do Usuário. Os desenvolvedores de servidores do Microsoft Active Accessibility não devem usar essa propriedade. Se mais informações forem necessárias para cenários de acessibilidade e automação, use as propriedades compatíveis com elementos Automação da Interface do Usuário e padrões de controle.

 

A propriedade Description de um objeto fornece uma descrição textual sobre a aparência visual de um objeto. A descrição é usada principalmente para fornecer maior contexto para usuários com baixa visão ou cegos, mas também é usada para pesquisa de contexto ou outros aplicativos. Essa propriedade pode ajudar os usuários a entender um ícone ou a aparência visual geral.

A propriedade Description é recuperada chamando IAccessible::get_accDescription.

Quando dar suporte à propriedade Description

Os servidores dão suporte à propriedade Description se a descrição não for óbvia ou quando ela não for redundante com base nas propriedades Nome, Função, Estado e Valor do objeto. Por exemplo, um botão rotulado como "OK" não precisaria de informações adicionais, enquanto um botão que mostra uma imagem de um cacto precisaria. As propriedades Name, Role e Help para esse botão descrevem sua finalidade, mas a propriedade Description transmite informações menos tangíveis; por exemplo, "Este botão mostra uma imagem de um cacto".

Um servidor microsoft Active Accessibility pode adicionar suporte para Automação da Interface do Usuário usando a Anotação Direta, usando a interface IAccessibleEx ou implementando a Acessibilidade Ativa da Microsoft e Automação da Interface do Usuário lado a lado com ambas as implementações que lidam com a mensagem WM_GETOBJECT.

Tópicos relacionados

Usando anotação direta

A interface IAccessibleEx