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

Artigo
03/03/2024

Define a posição do caractere para o início desse intervalo.

Sintaxe

HRESULT SetStart(
  [in] long cpFirst
);

Parâmetros

[in] cpFirst

Tipo: long

A nova posição de caractere para o início do intervalo.

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

Observe que, se cpFirst for maior que a posição final do intervalo, esse método definirá a posição final igual a cpFirst, tornando o intervalo um ponto de inserção. Se esse intervalo for a seleção, a posição inicial se tornará a extremidade ativa e será rolada para exibição se a exibição não estiver congelada.

ITextRange::SetEnd define a posição final do intervalo e ITextRange::SetRange define ambas as extremidades de intervalo simultaneamente. O exemplo a seguir mostra como converter um intervalo nãogenerado em um degenerado (ponto de inserção).

range.End = range.Start

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

O exemplo a seguir adiciona 1 à posição final, se não estiver no final da história.

range.End = range.End + 1

Isso também torna a posição final a extremidade ativa do intervalo 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