Método ITextRange::InRange (tom.h)

Determina si este intervalo está dentro o en el mismo texto que un intervalo especificado.

Sintaxis

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

Parámetros

pRange

Tipo: ITextRange

Texto que se compara con el intervalo actual.

pValue

Tipo: long*

Resultado de la comparación. El puntero puede ser NULL. El método devuelve pB es tomTrue solo si el intervalo está en o en el mismo texto que pRange.

Valor devuelto

Tipo: HRESULT

El método devuelve un valor de HRESULT. Si el método se realiza correctamente, devuelve S_OK. Si se produce un error en el método, devuelve S_FALSE.

Observaciones

Para que range2 se contenga en range1, ambos intervalos deben estar en la misma historia y los límites de range2 deben satisfacer cualquiera de las siguientes instrucciones.

• Las posiciones de carácter inicial y final de range1 son las mismas que range2. Es decir, ambos intervalos se degeneran y tienen puntos de inserción idénticos.
• Range2 es un rango no degenerado con posiciones de carácter inicial y final en o dentro de las de range1.

    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

Cuando se usa el ITextRange::FindText, ITextRange::MoveWhiley las familias de métodos ITextRange::MoveUntil, puede usar un intervalo para recorrer otro especificando el recuento de límites adecuado de caracteres (por ejemplo, vea los comentarios en ITextRange::Find).

ITextRange::IsEqual es un caso especial de ITextRange::InRange que devuelve pBtomTrue si el pRange tiene las mismas posiciones de carácter inicial y final y pertenece a la misma historia.

Requisitos

Consulte también

conceptual de

findText

ITextRange

moveUntil

MoveWhile

de referencia de

modelo de objetos de texto de