Метод ITextRange::InRange (tom.h)

Статья
07/16/2024

Определяет, находится ли этот диапазон внутри или в том же тексте, что и указанный диапазон.

Синтаксис

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

Параметры

pRange

Тип: ITextRange*

Текст, который сравнивается с текущим диапазоном.

pValue

Тип: long*

Результат сравнения. Указатель может иметь значение NULL. Метод возвращает pBtomTrue только в том случае, если диапазон находится или находится в том же тексте, что и pRange.

Возвращаемое значение

Тип: HRESULT

Метод возвращает значение HRESULT. Если метод выполнен успешно, он возвращает S_OK. Если метод завершается ошибкой, он возвращает S_FALSE.

Замечания

Для диапазона2, содержащегося в диапазоне1, оба диапазона должны находиться в одной и той же истории, и ограничения диапазона 2 должны соответствовать любой из следующих инструкций.

Позиции начального и конечного символов диапазона1 совпадают с диапазоном 2. То есть оба диапазона являются дегенерными и имеют одинаковые точки вставки.
Range2 — это недегенерный диапазон с позициями начального и конечного символов в диапазоне 1 или в пределах диапазона 1.

В следующем примере показано, как пройти один диапазон с другим.

    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

При использовании ITextRange::FindText, ITextRange::MoveTimeи семейства методов ITextRange::MoveUntil можно использовать один диапазон для обхода другого, указав соответствующее количество символов (например, см. примечания в ITextRange::Find).

ITextRange::IsEqual является особым случаем ITextRange::InRange, которая возвращает pBtomTrue, если pRange имеет одинаковые позиции начального и конечного символов и принадлежит той же истории.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	tom.h
DLL	Msftedit.dll