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

Статья
08/26/2023

Уведомляет объект текстовых служб о настройке курсора.

Синтаксис

HRESULT OnTxSetCursor(
  [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
);

Параметры

[in] dwDrawAspect

Тип: DWORD

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

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

Значение

DVASPECT_CONTENT

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

DVASPECT_DOCPRINT

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

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

lindex

Тип: LONG

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

[in] pvAspect

Тип: void*

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

[in] ptd

Тип: DVTARGETDEVICE*

Целевое устройство.

[in] hdcDraw

Тип: HDC

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

[in] hicTargetDev

Тип: HDC

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

[in] lprcClient

Тип: LPCRECT

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

[in] x

Тип: INT

x положение курсора в клиентских координатах содержащего окна.

[in] y

Тип: INT

Положение курсора y в клиентских координатах содержащего окна.

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

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет S_OK.

Если метод завершается сбоем, возвращается следующий код HRESULT . Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок в COM.

Код возврата	Описание
E_INVALIDARG	Один или несколько недопустимых параметров.

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

Параметр lprcClient — это клиентский прямоугольник представления элемента управления, над которым находится курсор мыши. Параметр lprcClient находится в координатах устройства содержащего окна так же, как и WM_SIZE сообщение. Возможно, это не то представление, которое было отрисовывается последним. Кроме того, если элемент управления активен на месте, это может быть не текущее активное представление . В результате объект текстовых служб должен проверка этот прямоугольник со значением текущего кэша и определить, требуется ли пересчет строк. В это вычисление следует включить коэффициент масштабирования. Описание коэффициента масштабирования см. в разделе TxGetExtent.

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

Дополнительные сведения см. в разделе Примечания в ITextServices::TxDraw.

Требования

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