Interface ITextSelection (tom.h)

Uma seleção de texto é um intervalo de texto com realce de seleção.

Herança

A interface ITextSelection herda de ITextRange. ITextSelection também tem estes tipos de membros:

Métodos

A interface ITextSelection tem esses métodos.

ITextSelection::EndKey Imita a funcionalidade da tecla End.
ITextSelection::GetFlags Obtém os sinalizadores de seleção de texto.
ITextSelection::GetType Obtém o tipo de seleção de texto.
ITextSelection::HomeKey Generaliza a funcionalidade da tecla Home.
ITextSelection::MoveDown Imita a funcionalidade das teclas Seta para baixo e Page Down.
ITextSelection::MoveLeft Generaliza a funcionalidade da tecla seta para a esquerda.
ITextSelection::MoveRight Generaliza a funcionalidade da tecla seta para a direita.
ITextSelection::MoveUp Imita a funcionalidade das teclas Seta para Cima e Page Up.
ITextSelection::SetFlags Define os sinalizadores de seleção de texto.
ITextSelection::TypeText Digita a cadeia de caracteres fornecida por bstr nesta seleção como se alguém a digitasse. Isso é semelhante ao método SetText subjacente, mas é sensível ao estado da chave Insert/Overtype e às configurações da interface do usuário, como AutoCorreção e aspas inteligentes.

Comentários

A seleção está associada a algum tipo de exibição e tem alguns métodos orientados à interface do usuário que permitem emular a entrada do teclado. Assim, um aplicativo pode usar os métodos ITextRange em uma seleção de texto, bem como os métodos ITextSelection .

Para a emulação de entrada do teclado, os intervalos usados nas seleções usam o conceito de final ativo, que normalmente é o final que foi movido pela última vez. Por exemplo, se um método ITextRange::Move* opera em um intervalo que, na verdade, é uma seleção de texto, a extremidade movida mais recentemente é a ativa. Os exemplos mais familiares da extremidade ativa são aqueles que envolvem o tratamento de Shift+Teclas de Direção, em que a extremidade ativa é a que se move. Assim, os métodos ITextSelection incluem métodos de movimentação para o final ativo, como MoveLeft ou MoveRight, e métodos para obter e definir a extremidade ativa status. Esses métodos manipulam seleções de maneiras semelhantes às operações padrão do teclado de cursor. Isso permite que você implemente, por exemplo, uma instalação de gravador de macros.

Para ver como os métodos cursor-keypad funcionam, consulte a tabela a seguir. Um determinado método corresponde a uma tecla de teclado de cursor com as teclas Ctrl e Shift. O parâmetro Unit é selecionado pressionando ou não pressionando a tecla Ctrl, enquanto o parâmetro Extend é selecionado pressionando ou não pressionando a tecla Shift. Observe que MoveUp e MoveDown correspondem a mais de uma tecla do teclado. Para obter mais informações, consulte as descrições dos métodos.

Método	Tecla do teclado de cursor	Unidade fornecida por CTRL pressionada (não pressionada)	Estender dado por SHIFT pressionado (não pressionado)
EndKey	End	tomStory (tomLine)	tomExtend (tomMove)
Homekey	Página Inicial	tomStory (tomLine)	tomExtend (tomMove)
Moveleft	Seta para a Esquerda	tomWord (tomCharacter)	tomExtend (tomMove)
Moveright	Seta para a Direita	tomWord (tomCharacter)	tomExtend (tomMove)
MoveUp	Seta para Cima	tomParagraph (tomLine)	tomExtend (tomMove)
Movedown	Seta para Baixo	tomParagraph (tomLine)	tomExtend (tomMove)
MoveUp	Page Up	tomWindow (tomScreen)	tomExtend (tomMove)
Movedown	Page Down	tomWindow (tomScreen)	tomExtend (tomMove)

 

Os aplicativos normalmente não implementam a interface ITextSelection . Em vez disso, soluções de texto da Microsoft, como controles de edição avançada, implementam ITextSelection como parte da implementação do TOM (Text Object Model).

Os aplicativos podem recuperar um ponteiro ITextSelection chamando o método GetSelection .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tom.h