Fornecendo a propriedade Name

Os desenvolvedores de servidores devem ter cuidado ao criar controles predefinidos e comuns para garantir que a Acessibilidade Ativa da Microsoft possa expor a propriedade Name para o controle. Dependendo do tipo de controle, o texto da propriedade Name vem de um dos seguintes:

• Texto da janela do controle (ou legenda)
• Texto estático que rotula o controle

Para localizar o texto da janela do controle, o Microsoft Active Accessibility envia a mensagem WM_GETTEXT para o controle. Esse texto corresponde ao parâmetro text na instrução de definição de recurso do controle. Para alguns controles, como botões, esse é o mesmo texto exibido com o controle . Para outros controles, como barras de ferramentas, esse texto não é exibido. Portanto, os desenvolvedores de servidores devem fornecer texto significativo na instrução de definição de recurso do controle para ajudar os usuários de utilitários cliente a identificar o controle.

Para localizar o rótulo do controle, a Acessibilidade Ativa da Microsoft pesquisa um controle de texto estático chamando GetWindow com o sinalizador GW_HWNDPREV. A pesquisa será interrompida se um controle de texto estático for encontrado ou se um controle tiver os estilos de janela WS_GROUP | WS_TABSTOP. Essa ordem de pesquisa corresponde à ordem de tabulação inversa em uma caixa de diálogo. Os desenvolvedores de servidor devem observar a ordem de tabulação ao criar controles para que um controle de texto estático preceda imediatamente o controle que ele rotula.

Para obter mais informações sobre as técnicas que o Microsoft Active Accessibility usa para expor a propriedade Name, consulte Referência de elemento de interface do usuário.