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

  • Статья

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

Синтаксис

HRESULT HitTestTextPosition(
        UINT32                  textPosition,
        BOOL                    isTrailingHit,
  [out] FLOAT                   *pointX,
  [out] FLOAT                   *pointY,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

Параметры

textPosition

Тип: UINT32

Позиция текста, используемая для получения расположения пикселя.

isTrailingHit

Тип: BOOL

Логический флаг, указывающий, является ли расположение пикселя начальной или конечной стороной указанной позиции текста.

[out] pointX

Тип: FLOAT*

При возврате этого метода содержит выходное расположение пикселя X относительно левого верхнего расположения поля макета.

[out] pointY

Тип: FLOAT*

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

[out] hitTestMetrics

Тип: DWRITE_HIT_TEST_METRICS*

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

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

Тип: 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