Metodo ITextRange::SetEnd (tom.h)

Articolo
03/13/2024

Imposta la posizione finale dell'intervallo.

Sintassi

HRESULT SetEnd(
  long cpLim
);

Parametri

cpLim

Tipo: long

Nuova posizione finale.

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

Se la nuova posizione finale è minore della posizione iniziale, questo metodo imposta anche la posizione iniziale su cp; ovvero, l'intervallo diventa un punto di inserimento.

Se l'intervallo è effettivamente la selezione, la posizione finale diventa l'estremità attiva e, se la visualizzazione non è bloccata, viene visualizzata.

ITextRange::SetStart imposta la posizione iniziale dell'intervallo e ITextRange::SetRange imposta entrambi gli intervalli contemporaneamente. Per convertire un intervallo non generato, r, in un degenerato (punto di inserimento) nella posizione iniziale, utilizzare

r.End = r.Start

Analogamente, r.Start = r.End converte r in un punto di inserimento nella posizione finale.

Per aggiungere 1 alla posizione finale, a meno che non sia alla fine del brano, usare:

r.End = r.End + 1

Ciò rende anche la posizione finale finale attiva 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