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

Artigo
03/03/2024

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 ou no mesmo texto que pRange.

Retornar valor

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.

Comentários

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

As posições de caractere inicial e final de range1 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 geral com posições de caractere inicial e final em 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 as famílias de métodos ITextRange::FindText, ITextRange::MoveWhile e ITextRange::MoveUntil são usadas, você pode usar um intervalo para percorrer outro especificando a contagem de limite apropriada de caracteres (por exemplo, consulte os Comentários em ITextRange::Find).

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

Requisitos

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