Método ITextSelection::MoveLeft (tom.h)

Artigo
08/26/2023

Generaliza a funcionalidade da tecla seta para a esquerda.

Sintaxe

HRESULT MoveLeft(
  long Unit,
  long Count,
  long Extend,
  long *pDelta
);

Parâmetros

Unit

Tipo: long

Unidade a ser usada. Pode ser um dos seguintes.

Valor	Combinação de teclas correspondente	Significado
tomCharacter	Seta para a Esquerda	Mova uma posição de caractere para a esquerda. Esse é o padrão.
tomWord	Ctrl+Seta para a Esquerda	Mova uma palavra para a esquerda.

Observação: se Count for menor que zero, o movimento será à direita.

Count

Tipo: long

Número de unidades a serem passadas. O valor padrão é 1. Se Count for menor que zero, o movimento será à direita.

Extend

Tipo: long

Sinalizador que indica como alterar a seleção. Se Extend for zero (ou tomMove), o método recolherá a seleção para um ponto de inserção na extremidade ativa e a moverá. Se Extend for 1 (ou tomExtend), o método moverá a extremidade ativa e deixará a outra extremidade sozinha. O valor padrão é zero. Um valor Extend diferente de zero corresponde à tecla Shift que está sendo pressionada, além da combinação de teclas descrita em Unidade.

pDelta

Tipo: long*

A contagem real de unidades que o ponto de inserção ou a extremidade ativa são movidas para a esquerda. Este parâmetro pode ser nulo. Recolher a seleção, quando Estender for 0, conta como uma unidade.

Valor retornado

Tipo: HRESULT

O método retorna um valor HRESULT . Se o método for bem-sucedido, ele retornará S_OK. Se o método falhar, ele retornará um dos seguintes códigos de erro. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno	Descrição
E_INVALIDARG	A unidade não é válida.
S_FALSE	Falha por algum outro motivo.

Comentários

Os métodos de movimentação do WordBasic como CharRight, CharLeft, WordRight e WordLeft são híbridos que podem fazer quatro coisas que estão intimamente relacionadas ao comportamento de edição de tecla de seta padrão:

Mova o ponto de inserção atual se não houver seleção.
Mova o final ativo da seleção se houver uma seleção.
Transforme um ponto de inserção em uma seleção e vice-versa.
Retornar um booliano informando se o movimento ocorreu.

O argumento Extend de MoveLeft e MoveRight permite que você seja consistente com os três primeiros itens acima e o pDelta é uma generalização do quarto. Por exemplo, dada uma seleção que consiste em um único intervalo, você tem as correspondências a seguir (para caracteres da esquerda para a direita).

ITextSelection	WordBasic	Função
Seleção. MoveRight tomWord, 1, 1	WordRight 1,1	Move a extremidade ativa uma palavra para a direita.
Seleção. MoveLeft tomCharacter, 1, 1	CharLeft 1,1	Move a extremidade ativa um caractere para a esquerda.

Como no WordBasic, se Count for menor que zero, os significados de esquerda e direita serão intercambiáveis, o equivalente MoveLeft (Unit, Count, Extend) a MoveRight (Unit, -Count, Extend).

Semelhante ao comportamento da interface do usuário do WordBasic e da tecla de seta para a esquerda, chamar MoveLeft ( Unit, Count) em uma seleção degenerada move o ponto de inserção do número especificado de Unidades. Em um intervalo degenerado, chamar MoveLeft( Unit, Count, 1) em Count que é maior que zero faz com que o intervalo se torne não descrigente com a extremidade esquerda sendo a extremidade ativa.

Quando Extend é tomExtend (ou é diferente de zero), MoveLeft move apenas a extremidade ativa da seleção, deixando a outra extremidade onde ela está. No entanto, se Extend for igual a zero e a seleção for iniciada como um intervalo não geral, MoveLeft(Unit, Count) em Count que é maior que zero move a extremidade Count ativa - 1 unidade para a esquerda e move a outra extremidade para a extremidade ativa. Em outras palavras, ele faz um ponto de inserção na extremidade ativa. Recolher o intervalo conta como uma unidade. Assim, MoveLeft(tomCharacter) converte uma seleção não genérica em uma degenerada na extremidade esquerda da seleção. Aqui, Count tem o valor padrão de 1 e Extend tem o valor padrão de zero. Este exemplo corresponde ao pressionamento da tecla seta para a esquerda. MoveLeft e MoveRight estão relacionados aos métodos de movimentação ITextRange , mas diferem porque usam explicitamente a extremidade ativa (o final é movido pressionando a tecla Shift).

Requisitos


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
DLL	Msftedit.dll