Metodo ITextRange::MoveStartWhile (tom.h)

Articolo
03/13/2024

Sposta la posizione iniziale dell'intervallo Conteggio caratteri o semplicemente incolla tutti i caratteri contigui trovati nel set di caratteri specificato da Cset, a meno.

Sintassi

HRESULT MoveStartWhile(
  VARIANT *Cset,
  long    Count,
  long    *pDelta
);

Parametri

Cset

Tipo: VARIANT*

Set di caratteri da utilizzare nella corrispondenza. Può trattarsi di una stringa esplicita di caratteri o di un indice del set di caratteri. Per altre informazioni, vedere Set di corrispondenze di caratteri.

Count

Tipo: long

Numero massimo di caratteri da passare. Il valore predefinito è tomForward, che cerca fino alla fine della storia. Se Count è maggiore di zero, la ricerca è in avanti, verso la fine del brano, e se Count è minore di zero, la ricerca è all'indietro verso l'inizio. Se Count è zero, la posizione iniziale rimane invariata.

pDelta

Tipo: long*

Numero effettivo di caratteri spostati dalla posizione iniziale. Questo parametro 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_INVALIDARG	Cset non è valido.
S_FALSE	Errore per un altro motivo.

Commenti

Se il nuovo inizio segue la fine precedente, la nuova fine viene impostata su uguale al nuovo inizio.

Il movimento descritto da ITextRange::MoveStartWhile è logico anziché geometrico. Cioè, il movimento è verso la fine o verso l'inizio di una storia. A seconda della lingua, lo spostamento alla fine della storia può essere 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