Metodo ITextRange::MoveEndUntil (tom.h)

Articolo
08/26/2023

Sposta la fine dell'intervallo alla posizione del primo carattere trovato nel set di caratteri specificato da Cset, purché il carattere venga trovato all'interno dei caratteri Count della fine dell'intervallo.

Sintassi

HRESULT MoveEndUntil(
  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 che l'estremità dell'intervallo viene spostata, più 1 per una corrispondenza se Count è maggiore di zero e -1 per una corrispondenza se Count è minore di zero. 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
Valore	Significato
E_INVALIDARG	Cset non è valido.
S_FALSE	Errore per un altro motivo.

Commenti

Se non viene trovato alcun carattere dal set specificato da Cset all'interno delle posizioni Count della fine dell'intervallo, l'intervallo rimane invariato. Se il nuovo termine precede l'inizio precedente, il nuovo inizio viene impostato su uguale alla nuova fine.

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