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

Artigo
08/26/2023

Imita a funcionalidade da tecla End.

Sintaxe

HRESULT EndKey(
  long Unit,
  long Extend,
  long *pDelta
);

Parâmetros

Unit

Tipo: long

Unidade a ser usada. Pode ser um dos seguintes.

Valor	Significado
tomLine	Dependendo de Estender, ele move o ponto de inserção ou a extremidade ativa para o final da última linha na seleção. Esse é o padrão.
tomStory	Dependendo de Estender, ele move o ponto de inserção ou a extremidade ativa para o final da última linha da história.
tomColumn	Dependendo de Estender, ele move o ponto de inserção ou a extremidade ativa para o final da última coluna na seleção. Isso só estará disponível se o mecanismo TOM der suporte a tabelas.
tomRow	Dependendo de Estender, ele move o ponto de inserção ou a extremidade ativa para o final da última linha na seleção. Isso só estará disponível se o mecanismo TOM der suporte a tabelas.

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. Se Extend for 1 (ou tomExtend), o método moverá a extremidade ativa e deixará a outra extremidade sozinha. O valor padrão é zero.

pDelta

Tipo: long*

Ponteiro para uma variável que recebe a contagem de caracteres que o ponto de inserção ou o final ativo é movido. Este parâmetro pode ser nulo.

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 é tomLine nem tomStory.
S_FALSE	Falha por algum outro motivo.

Comentários

Definir Estender como tomExtend (ou diferente de zero) corresponde à tecla Shift que está sendo pressionada. Definir Unidadecomo tomLine corresponde à tecla Ctrl que não está sendo pressionada. Definindo Unidadecomo tomStory como Ctrl sendo pressionada. Os parâmetros pDelta recebem o número de caracteres que o ponto de inserção ou o final ativo é movido.

Os métodos ITextSelection::HomeKey e ITextSelection::EndKey são usados para imitar o comportamento padrão da chave Home/End.

O valor tomLine imita o comportamento da tecla Home ou End sem a tecla Ctrl pressionada, enquanto tomStory imita o comportamento com a tecla Ctrl pressionada. Da mesma forma, tomMove imita o comportamento da tecla Home ou End sem a tecla Shift pressionada, enquanto tomExtend imita o comportamento com a tecla Shift pressionada. Portanto, EndKey(tomStory) converte a seleção em um ponto de inserção no final da história associada, enquanto EndKey(tomStory, tomExtend) move o final ativo da seleção para o final da história e deixa a outra extremidade onde ela estava.

Os métodos HomeKey e EndKey são métodos lógicos como os métodos Move* , em vez de métodos direcionais. Assim, eles dependem da linguagem envolvida. Por exemplo, em texto árabe, HomeKey move-se para a extremidade direita de uma linha, enquanto no texto em inglês, ela se move para a esquerda. Portanto, HomeKey e EndKey são diferentes dos métodos MoveLeft e MoveRight . Além disso, observe que o método EndKey é bem diferente da propriedade End , que é o cp no final da seleção. HomeKey e EndKey também diferem dos métodos StartOf e EndOf , pois eles se estendem do final ativo, enquanto StartOf se estende de Start e EndOf se estende de End.

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