Usando a anotação do servidor

Este tópico fornece informações sobre como usar a anotação do servidor para especificar um objeto de retorno de chamada.

Para substituir uma propriedade que especifica um objeto de retorno de chamada

1. Obtenha um ponteiro de interface IAccessible para o elemento acessível que deve ser anotado.
2. Chame QueryInterface no elemento acessível para obter um ponteiro de interface IAccIdentity.
3. Chame IAccIdentity::GetIdentityString() no ponteiro da interface IAccIdentity para obter uma cadeia de caracteres que identifica exclusivamente o elemento acessível a ser anotado.
4. Use CoCreateInstance ou CoCreateInstanceEx para criar o objeto IAccPropServices.
5. Crie um objeto COM (Component Object Model) que implemente IAccPropServer.
6. Chame IAccPropServices::SetPropServer, passando a cadeia de caracteres de identidade, um GUID que indica a propriedade a ser substituída e um ponteiro para o objeto de retorno de chamada IAccPropServer.
7. Libere os ponteiros de interface e a memória.

Quando um cliente solicita a propriedade do elemento acessível, o objeto de retorno de chamada será chamado e retornará o valor para o cliente.

Como ao especificar um valor, os desenvolvedores de servidor podem, alternativamente, usar o método IAccPropServices::ComposeHwndIdentityString para obter uma cadeia de caracteres de identidade; ou eles podem usar o método IAccPropServices::SetHwndPropServer e especificar o hwnd, idObjectou parâmetros idChild em vez de uma cadeia de caracteres de identidade.

Ao usar SetPropServer ou SetHwndPropServer em um objeto de contêiner, os desenvolvedores de servidor podem, opcionalmente, especificar que as informações de substituição também devem se aplicar a todos os elementos filhos desse contêiner.

Os servidores podem limpar explicitamente a anotação a qualquer momento usando IAccPropServices::ClearProps. Isso geralmente não é necessário, pois o serviço de anotação limpará e liberará automaticamente as informações de anotação quando o elemento acessível que está sendo anotado desaparecer.

Abaixo está uma lista de propriedades que podem ser anotadas usando este procedimento.

Propriedades suportadas ao especificar um callback

Ao especificar uma função de retorno, as seguintes propriedades podem ser anotadas. Atualmente, essas propriedades não podem ser anotadas diretamente especificando um valor.