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

Artigo
03/03/2024

Obtém a posição do caractere final do intervalo.

Sintaxe

HRESULT GetEnd(
  long *pcpLim
);

Parâmetros

pcpLim

Tipo: long*

A posição do caractere final.

Retornar valor

Tipo: HRESULT

O método retorna um valor HRESULT . Se o método for bem-sucedido, ele retornará S_OK. Se pcpLim for nulo, o método falhará e retornará E_INVALIDARG.

Comentários

Embora um ponteiro para um intervalo permaneça válido quando o texto é editado, esse não é o caso da posição do caractere. Uma posição de caractere é volátil; ou seja, ele se torna inválido assim que o texto é inserido ou excluído antes da posição do caractere. Tenha cuidado ao usar métodos que retornam valores de posição de caractere, especialmente se os valores devem ser armazenados por qualquer duração.

Esse método é semelhante ao método ITextRange::GetStart que obtém a posição do caractere inicial do intervalo.

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