Metodo ITextRange::InRange (tom.h)

Articolo
07/16/2024

Determina se questo intervallo si trova all'interno o allo 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.

Osservazioni

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 dei caratteri 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 iniziale e finale 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 utilizzate ITextRange::FindText, ITextRange::MoveWhilee famiglie di metodi ITextRange::MoveUntil, è possibile usare un intervallo per spostarsi a un altro specificando il numero di caratteri appropriato, ad esempio vedere le osservazioni in ITextRange::Find).

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	tom.h
dll	Msftedit.dll