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 |