Propriedade Description (recursos de acessibilidade do Windows)
Observação
A propriedade Description é frequentemente usada incorretamente e não é suportada pela automação da interface do usuário da Microsoft. Os desenvolvedores do servidor Microsoft Ative Accessibility não devem usar essa propriedade. Se forem necessárias mais informações para cenários de acessibilidade e automação, use as propriedades suportadas pelos elementos de 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 cegos ou com baixa visão, mas também é usada para pesquisa de contexto ou outras aplicações. 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 suportam a propriedade Description se a descrição não for óbvia ou quando não for redundante com base nas propriedades Name, Role, Statee Value propriedades. 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. O Name, Rolee Help propriedades 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 Ative Accessibility pode adicionar suporte para automação da interface do usuário usando de anotação direta, usando a interfaceIAccessibleExou implementando o Microsoft Ative Accessibility e a automação da interface do usuário lado a lado com ambas as implementações manipulando a mensagem WM_GETOBJECT.
Tópicos relacionados