Compartilhar via


Propriedade Description (recursos de acessibilidade do Windows)

Nota

A propriedade de Descrição do geralmente é usada incorretamente e não é suportada pela Automação da Interface do Usuário da Microsoft. 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 de Automação da Interface do Usuário e padrões de controle.

 

A propriedade Descrição de um objeto fornece uma descrição textual sobre a aparência visual de um objeto. A descrição é usada principalmente para fornecer um contexto maior 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 geral do visual.

A propriedade de Descrição é 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 Name, Role, Statee Value. 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, Rolee 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 de Acessibilidade Ativa da Microsoft pode adicionar suporte à Automação de Interface do Usuário usando de Anotação Direta, usando a interface deIAccessibleExou implementando a Acessibilidade Ativa da Microsoft e a Automação da Interface do Usuário lado a lado com ambas as implementações que lidam com a mensagem WM_GETOBJECT.

usando de anotação direta

a interface IAccessibleEx