Compartilhar via

Editar controle (referência de elemento da interface do usuário do MSAA)

Nota

Este tópico descreve editar objetos de 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 é descrito aqui. Consulte a documentação de referência da API para a estrutura de interface do usuário que você está usando.

Editar controles permite que um usuário exiba e edite texto. Os controles de edição são criados com vários 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 Active Accessibility 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 da classe de janela "RichEdit" ou "RichEdit20A".

Métodos IAccessible

Os controles de edição dão suporte aos seguintes métodos deIAccessible:

  • accHitTest
  • accLocation
  • accNavigate
  • accSelect

Propriedades IAccessible

Os controles de edição dão suporte às seguintes propriedades deIAccessible:

Propriedade Comentários
get_accChild
get_accChildCount
get_accDescription
get_accFocus
get_accKeyboardShortcut A propriedade KeyboardShortcut é a chave 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 "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 Name para o controle de edição é "Nome do arquivo:".
get_accParent A propriedade Pai é uma janela (ROLE_SYSTEM_WINDOW) que envolve o controle e tem a mesma propriedade Name e o nome da 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 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.

Anotações

  • O Microsoft Active Accessibility 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 de cuidado é alterada durante a seleção de texto. Quando os usuários pressionam SHIFT e teclas de direção para selecionar texto, o objeto caret 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 caret não envia eventos 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 rich edit enviam eventos corretamente com base na seleção.

  • O valor de de Estado para controles de edição de senha sempre inclui o sinalizador de bits STATE_SYSTEM_PROTECTED.

interface IAccessible

  • Last updated on