Compartilhar via


Caret (Referência de elemento de interface do usuário do MSAA)

Nota

Este tópico descreve os conjuntos para fins de referência de elemento de interface do usuário do MSAA. Como usar carets 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.

 

O cursor é uma linha piscando, bloco ou bitmap na área do cliente de uma janela ou em um controle que aceita entrada de teclado. Indica o local em que o texto ou os elementos gráficos são inseridos. Como apenas uma janela de cada vez tem o foco do teclado, há apenas um cursor no sistema.

Métodos IAccessible

O cursor dá suporte aos seguintes métodos deIAccessible:

  • accHitTest
  • accLocation

Propriedades IAccessible

O cursor dá suporte às seguintes propriedades de IAccessible:

Propriedade Comentários
get_accChildCount A propriedade ChildCount é zero.
get_accName A propriedade Name é "Editar".
get_accRole A propriedade Role é ROLE_SYSTEM_CARET.
get_accState Os valores possíveis para a propriedade state incluem:

 

Anotações

  • Ao contrário de outros elementos da interface do usuário, o objeto caret não tem um identificador de janela associado. Para obter acesso ao objeto caret, os clientes devem definir um WinEventProc e aguardar o objeto caret gerar eventos.

  • O objeto caret no controle de edição avançada fornecido pelo Riched20.dll (que é usado em editores de texto como o Microsoft WordPad no Windows 98) não envia nenhum WinEvents quando sua posição é 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. Da mesma forma, 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.

interface IAccessible