Metodo ITextRange::SetStart (tom.h)

Articolo
03/03/2024

Imposta la posizione del carattere per l'inizio di questo intervallo.

Sintassi

HRESULT SetStart(
  [in] long cpFirst
);

Parametri

[in] cpFirst

Tipo: long

Nuova posizione di carattere per l'inizio dell'intervallo.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un valore HRESULT . Se il metodo ha esito positivo, restituisce S_OK. Se il metodo ha esito negativo, restituisce S_FALSE.

Commenti

Si noti che se cpFirst è maggiore della posizione finale dell'intervallo, questo metodo imposta la posizione finale uguale a cpFirst, rendendo l'intervallo un punto di inserimento. Se questo intervallo è la selezione, la posizione iniziale diventa la fine attiva e viene scorrere in visualizzazione se la visualizzazione non è bloccata.

ITextRange::SetEnd imposta la posizione finale dell'intervallo e ITextRange::SetRange imposta entrambi gli intervalli contemporaneamente. Nell'esempio seguente viene illustrato come convertire un intervallo non generato in un degenerato (punto di inserimento).

range.End = range.Start

Analogamente, range.Start = range.End converte l'intervallo in un punto di inserimento nella posizione finale.

L'esempio seguente aggiunge 1 alla posizione finale, se non è alla fine della storia.

range.End = range.End + 1

Ciò rende anche la posizione finale alla fine dell'intervallo e può trasformare un intervallo degenerato in uno non generato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tom.h
DLL	Msftedit.dll