Metodo ITextRange::InRange (tom.h)

Articolo
03/09/2024

Determina se l'intervallo è compreso o nello stesso testo di un intervallo specificato.

Sintassi

HRESULT InRange(
  ITextRange *pRange,
  long       *pValue
);

Parametri

pRange

Tipo: ITextRange*

Testo confrontato con l'intervallo corrente.

pValue

Tipo: long*

Risultato del confronto. Il puntatore può essere Null. Il metodo restituisce pB è tomTrue solo se l'intervallo è incluso o nello stesso testo di pRange.

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 S_FALSE.

Commenti

Affinché range2 sia contenuto in range1, entrambi gli intervalli devono trovarsi nello stesso brano e i limiti di range2 devono soddisfare una delle istruzioni seguenti.

Le posizioni del carattere iniziale e finale di range1 sono uguali a range2. Ovvero, entrambi gli intervalli vengono degenerati e hanno punti di inserimento identici.
Range2 è un intervallo non generato con posizioni di caratteri di inizio e fine in corrispondenza o all'interno di quelle di range1.

Nell'esempio seguente viene illustrato come camminare un intervallo con un altro.

    range2 = range1.Duplicate
    range2.End = range2.Start       ' Collapse range2 to its start position 
    While range2.InRange(range1)    ' Iterate so long as range2 remains within range1
         ...   ' This code would change the range2 character positions 
    Wend

Quando vengono usate le famiglie di metodi ITextRange::FindText, ITextRange::MoveWhile e ITextRange::MoveUntil , è possibile utilizzare un intervallo per spostarsi a un altro specificando il numero di caratteri limite appropriato(ad esempio, vedere la sezione Osservazioni in ITextRange::Find).

ITextRange::IsEqual è un caso speciale di ITextRange::InRange che restituisce pBtomTrue se pRange ha le stesse posizioni dei caratteri iniziale e finale e appartiene alla stessa storia.

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