Метод ITfProperty::FindRange (msctf.h)
Получает диапазон, охватывающий текст, содержащий непустое значение свойства .
Синтаксис
HRESULT FindRange(
[in] TfEditCookie ec,
[in] ITfRange *pRange,
[out] ITfRange **ppRange,
[in] TfAnchor aPos
);
Параметры
[in] ec
Содержит файл cookie редактирования, определяющий контекст редактирования. Он получен из ITfDocumentMgr::CreateContext или ITfEditSession::D oEditSession.
[in] pRange
Указатель на интерфейс ITfRange , содержащий точку для получения диапазона свойств. Точка будет либо начальной, либо конечной привязкой этого диапазона на основе значения aPos.
[out] ppRange
Указатель на указатель интерфейса ITfRange , который получает запрошенный объект диапазона.
[in] aPos
Содержит одно из значений TfAnchor , которое указывает, какая привязка pRange используется в качестве точки для получения диапазона свойств.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Значение | Описание |
|---|---|
|
Метод выполнен успешно. |
|
PRange не является более или не находится рядом со свойством . ppRange получает значение NULL. |
|
Один или несколько параметров недопустимы. |
|
Произошел сбой выделения памяти. |
|
Произошла неизвестная ошибка. |
|
Контекст редактирования, определенный ec , не имеет блокировки только для чтения или чтения и записи. |
Комментарии
Этот метод получает диапазон текста, содержащий непустое значение свойства . Если свойство не имеет значения в указанной точке, ppRange получает значение NULL , а метод возвращает S_FALSE. В следующем примере, если aPos содержит TF_ANCHOR_START, возвращаемый диапазон будет содержать "is". Если объект aPos содержит TF_ANCHOR_END, метод возвращает S_FALSE, так как свойство не существует в конечной точке диапазона.
COLOR: RRRRR RR GGGGGGGG
TEXT: this <a>is som</a>e colored text
Если aPos содержит TF_ANCHOR_START, этот метод игнорирует диапазоны свойств, которые заканчиваются непосредственно перед начальной привязкой. Аналогичным образом, если aPos содержит TF_ANCHOR_END, этот метод игнорирует диапазоны свойств, которые начинаются сразу после конечной привязки. В следующем примере, если aPos содержит TF_ANCHOR_START, возвращаемый диапазон будет содержать "colored", а не "some", так как свойство R value заканчивается в начальной точке привязки, а значение G начинается с начальной привязки. Если объект aPos содержит TF_ANCHOR_END, возвращаемый диапазон будет содержать "colored", а не "text".
COLOR: RRRRR GGGGGGGG BBBB
TEXT: this is some <a>colored </a>text
Требования
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | msctf.h |
| DLL | Msctf.dll |
| Распространяемые компоненты | TSF 1.0 в Windows 2000 Professional |