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

Artigo
03/03/2024

Define a posição final do intervalo.

Sintaxe

HRESULT SetEnd(
  long cpLim
);

Parâmetros

cpLim

Tipo: long

A nova posição 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á S_FALSE.

Comentários

Se a nova posição final for menor que a posição inicial, esse método também definirá a posição inicial como cp; ou seja, o intervalo se torna um ponto de inserção.

Se esse intervalo for realmente a seleção, a posição final se tornará a extremidade ativa e, se a exibição não estiver congelada, ela será rolada para exibição.

ITextRange::SetStart define a posição inicial do intervalo e ITextRange::SetRange define ambas as extremidades de intervalo simultaneamente. Para converter um intervalo nãogenerado, r, em um degenerado (ponto de inserção) na posição inicial, use

r.End = r.Start

Da mesma forma, r.Start = r.End converte r em um ponto de inserção na posição final.

Para adicionar 1 à posição final, a menos que esteja no final da história, use:

r.End = r.End + 1

Isso também torna a posição final a extremidade ativa e pode transformar um intervalo degenerado em um não descrigêniono.

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