Metodo ITextRange::EndOf (tom.h)

Articolo
03/13/2024

Sposta le estremità di questo intervallo alla fine dell'ultima unità sovrapposta nell'intervallo.

Sintassi

HRESULT EndOf(
  long Unit,
  long Extend,
  long *pDelta
);

Parametri

Unit

Tipo: long

Unità da usare. Valore predefinito: tomWord. Per un elenco degli altri valori unit , vedere la discussione in ITextRange.

Extend

Tipo: long

Indicatore della modalità di spostamento delle estremità dell'intervallo. Può essere una delle seguenti.

0 o tomMove	Comprime un intervallo non generato fino alla fine dell'intervallo originale spostando il punto di inserimento. Questo è il valore predefinito.
1 (o tomExtend)	Sposta Fine alla fine dell'unità sovrapposta. Non sposta Start.

pDelta

Tipo: long*

Conteggio dei caratteri che Termina viene spostato oltre. Il valore del puntatore può essere Null. In caso contrario, il valore di pDelta è il numero di caratteri che il punto di inserimento o End viene spostato più 1 se si verifica un collasso alla voce Fine. Se l'intervallo include il cr finale (ritorno a capo) (alla fine del brano) e Extend = tomMove, pDelta è impostato su -1, per indicare che il collasso si è verificato prima della fine dell'intervallo (perché un punto di inserimento non può esistere oltre il CR 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 uno dei codici di errore seguenti. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito	Descrizione
E_NOTIMPL	L'unità non è supportata.
S_FALSE	Errore per un altro motivo.

Commenti

Per il confronto, il metodo ITextRange::StartOf sposta l'intervallo all'inizio della prima unità sovrapposta nell'intervallo. Si noti che i metodi ITextRange::StartOf e ITextRange::EndOf differiscono dai metodi HomeKey e EndKey in quanto questi ultimi si estendono dalla fine attiva, mentre ITextRange::StartOf si estende da Start e ITextRange::EndOf si estende da End. Se l'intervallo è un punto di inserimento su un limite tra Units, ITextRange::EndOf non modifica End. In particolare, la chiamata a ITextRange::EndOf (tomCharacter, *, *) non cambia Fine ad eccezione di un punto di inserimento all'inizio di una storia.

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