Metodo ITextRange::MoveStart (tom.h)

Articolo
03/13/2024

Sposta la posizione iniziale dell'intervallo il numero specificato di unità nella direzione specificata.

Sintassi

HRESULT MoveStart(
  long Unit,
  long Count,
  long *pDelta
);

Parametri

Unit

Tipo: long

Unità utilizzata nello spostamento. Il valore predefinito è tomCharacter. Per un elenco degli altri valori unit , vedere la discussione in ITextRange.

Count

Tipo: long

Numero di unità da spostare. Il valore predefinito è 1. Se Count è maggiore di zero, il movimento è avanti, verso la fine della storia, e se Count è minore di zero, il movimento è indietro verso l'inizio. Se Count è zero, la posizione iniziale è invariata.

pDelta

Tipo: long*

Numero effettivo di unità spostate dalla fine. Il valore può essere Null.

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 qualche altro motivo.

Commenti

Se il nuovo inizio segue la fine precedente, la nuova fine è impostata come uguale al nuovo inizio.

Il movimento descritto da ITextRange::MoveStart è logico anziché geometrico. Questo è il movimento verso la fine o verso l'inizio di una storia. A seconda della lingua, lo spostamento alla fine della storia potrebbe spostarsi a sinistra o spostarsi verso destra.

Per altre informazioni, vedere ITextRange e ITextRange::Move.

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