Método ITextServices::OnTxSetCursor (textserv.h)

Artículo
03/05/2024

Notifica al objeto de servicios de texto para establecer el cursor.

Sintaxis

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
);

Parámetros

[in] dwDrawAspect

Tipo: DWORD

El aspecto de dibujo puede ser uno de los siguientes valores.

Valor	Significado
DVASPECT_CONTENT	Representa una imagen de pantalla del contenido de texto en el contexto del dispositivo hdcDraw . Los parámetros hicTargetDev y ptd proporcionan información sobre el contexto del dispositivo de destino si existe (normalmente una impresora).
DVASPECT_DOCPRINT	Representa el objeto en el contexto del dispositivo hdcDraw como si se imprimiese en una impresora. Por lo tanto, el objeto de servicios de texto puede optimizar para la impresora (por ejemplo, no pintar el color de fondo, si es blanco). Además, ciertos elementos específicos de la pantalla (como la selección) no deben representarse. ITextServices::OnTxSetCursor debe representar el rectángulo lprcClient , empezando por la posición de desplazamiento actual.

Valor

Significado

DVASPECT_CONTENT

Representa una imagen de pantalla del contenido de texto en el contexto del dispositivo hdcDraw . Los parámetros hicTargetDev y ptd proporcionan información sobre el contexto del dispositivo de destino si existe (normalmente una impresora).

DVASPECT_DOCPRINT

Representa el objeto en el contexto del dispositivo hdcDraw como si se imprimiese en una impresora. Por lo tanto, el objeto de servicios de texto puede optimizar para la impresora (por ejemplo, no pintar el color de fondo, si es blanco). Además, ciertos elementos específicos de la pantalla (como la selección) no deben representarse.

ITextServices::OnTxSetCursor debe representar el rectángulo lprcClient , empezando por la posición de desplazamiento actual.

lindex

Tipo: LONG

No compatible.

[in] pvAspect

Tipo: void*

Información sobre las optimizaciones de dibujo.

[in] ptd

Tipo: DVTARGETDEVICE*

Dispositivo de destino.

[in] hdcDraw

Tipo: HDC

Representación del contexto del dispositivo.

[in] hicTargetDev

Tipo: HDC

Contexto de información de destino.

[in] lprcClient

Tipo: LPCRECT

Rectángulo de cliente del control. Las coordenadas del rectángulo están en coordenadas de cliente de la ventana contenedora. NULL es un valor legal.

[in] x

Tipo: INT

x posición del cursor, en las coordenadas de cliente de la ventana contenedora.

[in] y

Tipo: INT

posición y del cursor, en las coordenadas de cliente de la ventana contenedora.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto se S_OK.

Si se produce un error en el método, el valor devuelto es el siguiente código HRESULT . Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto	Descripción
E_INVALIDARG	Uno o varios parámetros no válidos.

Comentarios

El objeto de servicios de texto puede reasignarse como resultado de esta llamada para determinar el cursor correcto. El cursor correcto se establece a través de TxSetCursor.

El parámetro lprcClient es el rectángulo del cliente de la vista del control sobre el que se coloca el cursor del mouse. El parámetro lprcClient está en las coordenadas del dispositivo de la ventana contenedora de la misma manera que el mensaje de WM_SIZE es. Es posible que no sea la vista que se ha representado por última vez. Además, si el control está activo en contexto, es posible que no sea la vista activa actual. Como consecuencia, el objeto de servicios de texto debe comprobar este rectángulo con respecto al valor de la memoria caché actual y determinar si es necesario o no volver a calcular las líneas. El factor de zoom debe incluirse en este cálculo. Para obtener una explicación del factor de zoom, consulte TxGetExtent.

Solo se debe llamar a este método para las vistas de pantalla del control. Por lo tanto, el contexto del dispositivo (DC) no se pasa, pero se debe suponer que es un controlador de dominio de pantalla.

Para obtener más información, vea comentarios en ITextServices::TxDraw.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	textserv.h
Archivo DLL	Msftedit.dll