Метод 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 |