Metodo ITextRange::MoveStartUntil (tom.h)

Articolo
03/03/2024

Sposta la posizione iniziale dell'intervallo la posizione del primo carattere trovato nel set di caratteri specificato da Cset, a condizione che il carattere venga trovato all'interno dei caratteri Count della posizione iniziale.

Sintassi

HRESULT MoveStartUntil(
  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*

Il numero effettivo di caratteri all'inizio dell'intervallo viene spostato, 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
E_INVALIDARG	Cset non è valido.
S_FALSE	Errore per un altro motivo.

Commenti

Se non viene trovato alcun carattere da Cset all'interno delle posizioni Count della posizione iniziale, l'intervallo rimane invariato.

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

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