Tipos de Anotação Dinâmica

Há três tipos de Anotação Dinâmica com suporte na Acessibilidade Ativa da Microsoft: anotação direta, anotação mapeada por valor e anotação de servidor. Cada tipo oferece vantagens específicas, portanto, é importante entender as diferenças.

Anotação direta

A anotação direta é a forma mais simples de Anotação Dinâmica. Ele é mais aplicável a elementos acessíveis cuja propriedade anotada não depende do estado do controle e não requer o suporte adicional fornecido pela anotação mapeada por valor e anotação de servidor. A anotação direta é usada para substituir o valor de uma ou mais propriedades de Acessibilidade Ativa da Microsoft de um elemento acessível e para substituir ou adicionar uma propriedade do Microsoft Automação da Interface do Usuário ao controle. Todas as anotações feitas em uma propriedade microsoft Active Accessibility são refletidas na tradução de Automação da Interface do Usuário, bem como no proxy microsoft Active Accessibility-to-Automação da Interface do Usuário. Para obter mais informações, consulte Anotação Direta.

Anotação do Mapa de Valor

Além de anotar diretamente as propriedades IAccessible , geralmente há a necessidade de converter um valor específico do controle em uma cadeia de caracteres que pode ser compreendida por um usuário final. Um exemplo é o controle deslizante de resolução de tela na guia Configurações na janela Propriedades de Exibição (de Painel de Controle). Embora cada posição do controle deslizante corresponda a uma resolução diferente (por exemplo, 640 x 480, 1024 x 768), o controle não tem conhecimento dessa relação e não pode transmitir essas informações para a Acessibilidade Ativa da Microsoft.

A anotação mapeada por valor facilita essa tarefa. Usando essa forma de anotação, você pode especificar cadeias de caracteres para valores de controle deslizante e especificar funções, estados e descrições para ícones em exibições de lista e árvore. Para obter mais informações, consulte Anotação do Mapa de Valor.

Anotação do servidor

A anotação de servidor permite que os desenvolvedores registrem um objeto de retorno de chamada para atender às solicitações de cliente para a propriedade anotada de um elemento. Esse objeto de retorno de chamada deve implementar a interface IAccPropServer e ser registrado com os serviços de anotação de Acessibilidade Ativa da Microsoft. Depois de registrado, ele será solicitado a atender a todas as solicitações de cliente para o valor da propriedade desse elemento acessível.

Um recurso particularmente útil da anotação do servidor é que um servidor pode ser registrado uma vez para lidar com solicitações para um contêiner e todos os seus filhos. Portanto, por exemplo, um único servidor pode ser configurado uma vez para lidar com solicitações de todos os itens é uma caixa de listagem. Para obter mais informações, consulte Anotação do servidor.