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

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

  • Статья

Метод 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 редактирования недопустим.

Комментарии

Точка 1 находится в ограничивающем поле символов, а точка 2 находится за пределами ограничивающего поля символов. По умолчанию метод возвращает диапазон, расположенный в позиции 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