Metodo ITextRange::StartOf (tom.h)

Articolo
03/09/2024

Sposta l'intervallo all'inizio della prima unità sovrapposta nell'intervallo.

Sintassi

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

Parametri

Unit

Tipo: long

Unità da usare nell'operazione di spostamento. Per un elenco di valori unit , vedere la discussione in ITextRange.

Extend

Tipo: long

Come spostare le estremità dell'intervallo. Può essere uno dei valori seguenti.

0 (o tomMove)	Comprime un intervallo non generato nella posizione iniziale spostando il punto di inserimento. Questo è il valore predefinito.
1 (o tomExtend)	Sposta la posizione iniziale all'inizio dell'unità sovrapposta. Non sposta la posizione finale.

pDelta

Tipo: long*

Puntatore a una variabile che riceve il numero di caratteri spostati dalla posizione iniziale. Può essere Null. In caso di restituzione, pDelta è il numero di caratteri firmato che il punto di inserimento o la posizione iniziale viene spostato. Questo valore è sempre minore o uguale a zero, perché il movimento è sempre verso l'inizio della storia.

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

Se l'intervallo è un punto di inserimento su un limite tra Units, ITextRange::StartOf non modifica la posizione iniziale.

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 dalla posizione iniziale e ITextRange::EndOf si estende dalla posizione finale.

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