Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Observação
Este tópico descreve Editar Controle objetos para fins de Referência de Elemento da Interface do Usuário do MSAA. Como criar Editar Controle objetos em várias estruturas de interface do usuário não é descrito aqui. Consulte a documentação de referência da API para a estrutura da interface do usuário que você está usando.
Os controles de edição permitem que um usuário visualize 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 do cliente do Bloco de Notas, e ES_READONLY, que cria um controle de edição somente leitura.
O Microsoft Ative Accessibility não faz distinção entre controles de edição criados com o nome de classe de janela "EDIT" e controles de edição avançados criados com o nome de classe de janela "RichEdit" ou "RichEdit20A".
Métodos IAccessible
Os controles Edit suportam os seguintes métodos IAccessible:
Propriedades IAccessible
Os controles Edit suportam as seguintes propriedades IAccessible:
| Propriedade | Observações |
|---|---|
| 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 padrão Abrir Arquivo, como no WordPad, o KeyboardShortcut para o controle de edição rotulado "Nome do arquivo:" é "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 Nome do 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 window class name 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 estiver 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
O Microsoft Ative Accessibility não oferece suporte à seleção do texto contido nos controles edit e rich edit porque o texto é exposto como uma cadeia de caracteres na propriedade Value do objeto.
O controle de edição avançada fornecido pelo 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 SHIFT e teclas de seta para selecionar texto, o objeto de cursor não aciona 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 apresentam esse problema. Os aplicativos que usam versões anteriores do controle rich edit enviam corretamente eventos com base na seleção.
O valor State para controles de edição de senha sempre inclui o sinalizador de bit STATE_SYSTEM_PROTECTED.