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

Determina se esse intervalo está dentro ou no mesmo texto de um intervalo especificado.

Sintaxe

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

Parâmetros

pRange

Tipo: * ITextRange

Texto comparado ao intervalo atual.

pValue

Tipo: long*

O resultado da comparação. O ponteiro pode ser nulo. O método retorna pB é tomTrue somente se o intervalo estiver no mesmo texto que pRange.

Valor de retorno

Tipo: HRESULT

O método retorna um valor HRESULT . Se o método for bem-sucedido, ele retornará S_OK. Se o método falhar, ele retornará S_FALSE.

Observações

Para que o intervalo2 seja contido no intervalo1, ambos os intervalos devem estar na mesma história e os limites de intervalo2 devem atender a qualquer uma das instruções a seguir.

  • As posições de caractere inicial e final do intervalo1 são iguais ao intervalo2. Ou seja, ambos os intervalos são degenerados e têm pontos de inserção idênticos.
  • Range2 é um intervalo não descritivo com posições de caractere inicial e final dentro ou dentro das do intervalo1.
O exemplo a seguir mostra como percorrer um intervalo com outro.
    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 o ITextRange::FindText, ITextRange::MoveWhilee ITextRange::MoveUntil famílias de métodos são usados, você pode usar um intervalo para percorrer outro especificando a contagem de limite apropriada de caracteres (por exemplo, consulte as Observações em ITextRange::Find).

ITextRange::IsEqual é um caso especial de ITextRange::InRange que retorna pBtomTrue se o pRange tiver as mesmas posições de caractere inicial e final e pertence à mesma história.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho tom.h
de DLL Msftedit.dll

Consulte também

Conceitual

FindText

ITextRange

MoveUntil

movewhile

de referência de

modelo de objeto de texto