Controle editar (referência de elemento de interface do usuário do MSAA)
Observação
Este tópico descreve os objetos Editar Controle para fins de Referência de Elemento de Interface do Usuário do MSAA. Como criar objetos Editar Controle em várias estruturas de interface do usuário não está descrito aqui. Consulte a documentação de referência de API para a estrutura de interface do usuário que você está usando.
Editar controles permitem que um usuário exiba e edite texto. Os controles de edição são criados com muitos estilos diferentes, como ES_MULTILINE. Esse estilo cria um controle de edição de várias linhas, como a área de cliente do Bloco de Notas e ES_READONLY, que cria um controle de edição somente leitura.
A Acessibilidade Ativa da Microsoft não faz uma distinção entre os controles de edição criados com o nome da classe de janela "EDIT" e os controles de edição avançada criados com o nome de classe de janela "RichEdit" ou "RichEdit20A".
Métodos IAccessible
Os controles de edição dão suporte aos seguintes métodos IAccessible :
Propriedades IAccessible
Os controles de edição dão suporte às seguintes propriedades IAccessible :
| Propriedade | Comentários |
|---|---|
| get_accChild | |
| get_accChildCount | |
| get_accDescription | |
| Get_accfocus | |
| Get_acckeyboardshortcut | A propriedade KeyboardShortcut é a tecla de acesso do controle de edição, que é um caractere sublinhado no texto do rótulo do controle de edição. Por exemplo, em uma caixa de diálogo Abrir Arquivo padrão, como no WordPad, o KeyboardShortcut para o controle de edição rotulado "Filename:" é "Alt+n". |
| Get_accname | A propriedade Name é o texto de um controle de texto estático que rotula o controle de edição. Por exemplo, em uma caixa de diálogo Abrir Arquivo padrão, como no WordPad, a propriedade Name para o controle de edição é "Nome do arquivo:". |
| get_accParent | A propriedade Parent é uma janela ( ROLE_SYSTEM_WINDOW ) que envolve o controle e tem a mesma propriedade Name e nome de classe de janela que o controle. |
| Get_accrole | A propriedade Role é ROLE_SYSTEM_TEXT. |
| Get_accselection | |
| Get_accstate | A propriedade State é uma combinação de um ou mais dos seguintes valores:STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_READONLY | STATE_SYSTEM_PROTECTED | STATE_SYSTEM_NORMAL |
| get_accValue | A propriedade Value é uma única cadeia de caracteres que contém o texto no controle de edição. No entanto, se o controle for protegido por senha, a propriedade Value retornará E_ACCESSDENIED. Para controles de edição de várias linhas, a cadeia de caracteres contém um retorno de carro e um caractere de nova linha no final de cada linha. |
Observações
A Acessibilidade Ativa da Microsoft não dá suporte à seleção do texto contido em controles de edição e edição avançada porque o texto é exposto como uma cadeia de caracteres na propriedade Value do objeto.
O controle de edição avançada fornecido por Riched20.dll (que é usado em editores de texto como o WordPad no Windows 98) não envia nenhum WinEvents quando a posição do cursor é alterada durante a seleção de texto. Quando os usuários pressionam as teclas SHIFT e seta para selecionar o texto, o objeto de cursor não dispara o EVENT_OBJECT_LOCATIONCHANGE WinEvent. Quando a seleção é definida programaticamente por meio de mensagens de edição avançadas, o objeto de cursor não envia nenhum evento para indicar sua nova posição.
Todos os aplicativos que usam Riched20.dll exibem esse problema. Os aplicativos que usam versões anteriores do controle de edição avançada enviam eventos corretamente com base na seleção.
O valor state para controles de edição de senha sempre inclui o sinalizador de bit STATE_SYSTEM_PROTECTED.