Метод ITextStoreACP2::GetACPFromPoint (texttor.h)

Статья
03/13/2024

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

Синтаксис

HRESULT GetACPFromPoint(
  [in]  TsViewCookie vcView,
  [in]  const POINT  *ptScreen,
  [in]  DWORD        dwFlags,
  [out] LONG         *pacp
);

Параметры

[in] vcView

Задает представление контекста.

[in] ptScreen

Указатель на структуру POINT с экранными координатами точки.

[in] dwFlags

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

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

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

[out] pacp

Получает позицию символа, соответствующую экранным координатам точки.

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

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

Значение	Описание
S_OK	Метод выполнен успешно.
TS_E_INVALIDPOINT	Параметр ptScreen не находится в ограничивающем прямоугольнике какого-либо символа.
TS_E_NOLAYOUT	Приложение не вычислило макет текста.

Требования

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

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

константы GXFPF_*

ITextStoreACP2

ITfContextOwner::GetACPFromPoint

ITfContextView::GetRangeFromPoint

Возвращаемые значения диспетчером

TsViewCookie

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