Metodo ITextRange::MoveEndWhile (tom.h)

Articolo
08/26/2023

Sposta la fine dell'intervallo tra i caratteri Count o solo oltre tutti i caratteri contigui trovati nel set di caratteri specificato da Cset, a qualsiasi valore minore.

Sintassi

HRESULT MoveEndWhile(
  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 si sposta in avanti (verso la fine del brano). Se Count è minore di zero, la ricerca si sposta all'indietro (verso l'inizio della storia). Se Count è zero, la posizione finale rimane invariata.

pDelta

Tipo: long*

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

Commenti

Se il nuovo termine precede l'inizio precedente, il nuovo inizio viene impostato su uguale alla nuova fine.

Il movimento descritto da ITextRange::MoveEndWhile è 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


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