Метод ITextServices::TxQueryHitPoint (textserv.h)

Статья
08/26/2023

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

Синтаксис

HRESULT TxQueryHitPoint(
  [in]  DWORD          dwDrawAspect,
        LONG           lindex,
  [in]  void           *pvAspect,
  [in]  DVTARGETDEVICE *ptd,
  [in]  HDC            hdcDraw,
  [in]  HDC            hicTargetDev,
  [in]  LPCRECT        lprcClient,
  [in]  INT            x,
  [in]  INT            y,
  [out] DWORD          *pHitResult
);

Параметры

[in] dwDrawAspect

Тип: DWORD

Аспект рисования может иметь одно из следующих значений.

Значение	Значение
DVASPECT_CONTENT	Отображает изображение экрана с текстовым содержимым в контексте устройства hdcDraw . Параметры hicTargetDev и ptd предоставляют сведения о контексте целевого устройства, если таковой имеется (обычно это принтер).
DVASPECT_DOCPRINT	Отрисовывает объект в контексте устройства hdcDraw , как если бы он был напечатан на принтере. Таким образом, объект текстовых служб может оптимизировать для принтера (например, не закраив цвет фона, если белый). Кроме того, некоторые элементы, относящиеся к экрану (например, выделение) не должны отображаться. ITextServices::TxGetNaturalSize должен отображать прямоугольник lprcClient , начиная с текущей позиции прокрутки.

Значение

DVASPECT_CONTENT

Отображает изображение экрана с текстовым содержимым в контексте устройства hdcDraw .

Параметры hicTargetDev и ptd предоставляют сведения о контексте целевого устройства, если таковой имеется (обычно это принтер).

DVASPECT_DOCPRINT

Отрисовывает объект в контексте устройства hdcDraw , как если бы он был напечатан на принтере. Таким образом, объект текстовых служб может оптимизировать для принтера (например, не закраив цвет фона, если белый). Кроме того, некоторые элементы, относящиеся к экрану (например, выделение) не должны отображаться.

ITextServices::TxGetNaturalSize должен отображать прямоугольник lprcClient , начиная с текущей позиции прокрутки.

lindex

Тип: LONG

Не поддерживается.

[in] pvAspect

Тип: void*

Сведения об оптимизации рисования.

[in] ptd

Тип: DVTARGETDEVICE*

Сведения о целевом устройстве.

[in] hdcDraw

Тип: HDC

Отрисовка контекста устройства.

[in] hicTargetDev

Тип: HDC

Контекст целевой информации.

[in] lprcClient

Тип: LPCRECT

Клиентский прямоугольник элемента управления в координатах клиента (устройства) представления, в котором выполняется проверка попадания.

[in] x

Тип: INT

Координата x для проверка в координатах клиента представления, в котором выполняется проверка нажатия.

[in] y

Тип: INT

Координата y для проверка в клиентских координатах представления, в котором выполняется проверка попадания.

[out] pHitResult

Тип: DWORD*

Результат проверки попадания. Это может быть любое из следующих значений перечисления TXTHITRESULT .

Значение	Значение
TXTHITRESULT_CLOSE	Точка находится в клиентском прямоугольнике и близка к непрозрачной области.
TXTHITRESULT_HIT	Точка находится в клиентском прямоугольнике и над текстом или фоном не является прозрачным.
TXTHITRESULT_NOHIT	Точка находится за пределами клиентского прямоугольника.
TXTHITRESULT_TRANSPARENT	Точка находится в клиентском прямоугольнике и либо не над текстом, либо фон был прозрачным.

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

Тип: HRESULT

Возвращаемое значение — это код HRESULT .

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	textserv.h
DLL	Msftedit.dll