Метод IDWriteTextLayout::HitTestPoint (dwrite.h)

Статья
08/23/2023

Приложение вызывает эту функцию, передавая определенное расположение пикселей относительно левого верхнего расположения поля макета, и получает сведения о метриках проверки совпадения текстовой строки, в которой произошел тест попадания. Если указанное расположение пикселя находится за пределами текстовой строки, функция устанавливает выходное значение *isInside в значение FALSE.

Синтаксис

HRESULT HitTestPoint(
        FLOAT                   pointX,
        FLOAT                   pointY,
  [out] BOOL                    *isTrailingHit,
  [out] BOOL                    *isInside,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

Параметры

pointX

Тип: FLOAT

Расположение пикселей X для проверки нажатия относительно верхнего левого расположения поля макета.

pointY

Тип: FLOAT

Расположение пикселя Y для проверки нажатия относительно верхнего левого расположения поля макета.

[out] isTrailingHit

Тип: BOOL*

Выходной флаг, указывающий, находится ли место проверки нажатия на начальной или конечной стороне символа. Если для выходных данных *isInside задано значение FALSE, это значение устанавливается в соответствии со значением output hitTestMetrics-textPosition>, чтобы представить край, ближайший к расположению проверки попадания.

[out] isInside

Тип: BOOL*

Выходной флаг, указывающий, находится ли расположение проверки попадания внутри текстовой строки. При значении FALSE возвращается позиция, ближайшая к краю текста.

[out] hitTestMetrics

Тип: DWRITE_HIT_TEST_METRICS*

Геометрия выходных данных, полностью включающая расположение проверки попадания. Если для выходных данных *isInside задано значение FALSE, эта структура представляет геометрию, включающую край, ближайший к расположению проверки попадания.

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

Тип: HRESULT

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	dwrite.h
Библиотека	Dwrite.lib
DLL	Dwrite.dll

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

IDWriteTextLayout