Метод ITfContextView::GetRangeFromPoint (msctf.h)

Статья
02/29/2024

Метод ITfContextView::GetRangeFromPoint преобразует точку в координатах экрана в пустой диапазон текста, расположенный в соответствующем расположении.

Синтаксис

HRESULT GetRangeFromPoint(
  [in]  TfEditCookie ec,
  [in]  const POINT  *ppt,
  [in]  DWORD        dwFlags,
  [out] ITfRange     **ppRange
);

Параметры

[in] ec

Указывает файл cookie редактирования с доступом только для чтения.

[in] ppt

Указывает точку в экранных координатах.

[in] dwFlags

Задает позицию диапазона, возвращаемую на основе экранных координат точки в ограничивающей рамке символов. По умолчанию возвращаемое положение диапазона — это ограничивающий знак, содержащий экранные координаты точки. Если точка находится за пределами ограничивающего поля символов, метод возвращает значение NULL или TF_E_INVALIDPOINT. Ниже приведены другие битовые флаги для этого параметра.

Битовые флаги можно объединять.

Значение	Значение
GXFPF_ROUND_NEAREST	Если экранные координаты точки содержатся в ограничивающем символьном прямоугольнике, то возвращаемое положение диапазона — это ограничивающий край, ближайший к координатам экрана точки.
GXFPF_NEAREST	Если экранные координаты точки не содержатся в ограничивающем символьном прямоугольнике, возвращается ближайшая позиция диапазона.

[out] ppRange

Получает указатель на интерфейс ITfRange.

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

Этот метод может возвращать одно из этих значений.

Значение	Описание
S_OK	Метод выполнен успешно.
TF_E_INVALIDPOINT	Параметр pptScreen не охватывает текст документа.
TF_E_NOLAYOUT	Приложение не вычислило макет текста.
TF_E_NOLOCK	Указанный файл cookie редактирования недопустим.

По умолчанию метод возвращает диапазон, расположенный в позиции 0 для точки 1 и TF_E_INVALIDPOINT для точки 2. Если параметру dwFlags присвоено значение GXFPF_ROUND_NEAREST, метод возвращает позицию диапазона 1 для точки 1. Если параметру dwFlags присвоено значение GXFPF_NEAREST то метод возвращает позицию диапазона 2 для точки 2.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	msctf.h
DLL	Msctf.dll
Распространяемые компоненты	TSF 1.0 в Windows 2000 Профессиональная

См. также раздел

GXFPF_NEAREST

GXFPF_ROUND_NEAREST

ITfContextView

TF_E_INVALIDPOINT

Поделиться через