Método ITextRange::EndOf (tom.h)

Artigo
03/03/2024

Move as extremidades desse intervalo para o final da última Unidade sobreposta no intervalo.

Sintaxe

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

Parâmetros

Unit

Tipo: long

Unidade a ser usada. Valor padrão: tomWord. Para obter uma lista dos outros valores de Unidade , consulte a discussão em ITextRange.

Extend

Tipo: long

Indicador de como a mudança do intervalo termina é continuar. Pode ser um dos seguintes.

0 ou tomMove	Recolhe um intervalo não descrigente para o Final do intervalo original movendo o ponto de inserção. Esse é o padrão.
1 (ou tomExtend)	Move End para o final da Unidade sobreposta. Não move Iniciar.

pDelta

Tipo: long*

A contagem de caracteres passados por End. O valor do ponteiro pode ser nulo. No retorno, o valor de pDelta é o número de caracteres que o ponto de inserção ou End é movido mais 1 se ocorrer um recolhimento para a entrada End. Se o intervalo incluir o CR final (retorno de carro) (no final da história) e Extend = tomMove, pDelta será definido como –1, para indicar que o colapso ocorreu antes do final do intervalo (porque um ponto de inserção não pode existir além do CR final).

Retornar valor

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_NOTIMPL	Não há suporte para unidade.
S_FALSE	Falha por algum outro motivo.

Comentários

Para comparação, o método ITextRange::StartOf move o intervalo termina para o início da primeira Unidade sobreposta no intervalo. Observe que os métodos ITextRange::StartOf e ITextRange::EndOf diferem dos métodos HomeKey e EndKey , pois este último se estende do final ativo, enquanto ITextRange::StartOf se estende de Start e ITextRange::EndOf se estende de End. Se o intervalo for um ponto de inserção em um limite entre a Unidades, ITextRange::EndOf não alterará End. Em particular, chamar ITextRange::EndOf (tomCharacter, *, *) não altera End, exceto para um ponto de inserção no início de uma história.

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