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

Article
08/26/2023

Avertit l’objet services de texte de définir le curseur.

Syntaxe

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

Paramètres

[in] dwDrawAspect

Type : DWORD

L’aspect Dessiner peut être l’une des valeurs suivantes.

Valeur	Signification
DVASPECT_CONTENT	Restitue une image d’écran du contenu texte dans le contexte de l’appareil hdcDraw . Les paramètres hicTargetDev et ptd fournissent des informations sur le contexte de l’appareil cible le cas échéant (généralement une imprimante).
DVASPECT_DOCPRINT	Restitue l’objet dans le contexte de l’appareil hdcDraw comme s’il était imprimé sur une imprimante. Ainsi, l’objet services de texte peut optimiser pour l’imprimante (par exemple, ne pas peindre la couleur d’arrière-plan, s’il est blanc). En outre, certains éléments spécifiques à l’écran (tels que la sélection) ne doivent pas être rendus. ITextServices ::OnTxSetCursor doit afficher le rectangle lprcClient , en commençant à la position de défilement actuelle.

Valeur

Signification

DVASPECT_CONTENT

Restitue une image d’écran du contenu texte dans le contexte de l’appareil hdcDraw . Les paramètres hicTargetDev et ptd fournissent des informations sur le contexte de l’appareil cible le cas échéant (généralement une imprimante).

DVASPECT_DOCPRINT

Restitue l’objet dans le contexte de l’appareil hdcDraw comme s’il était imprimé sur une imprimante. Ainsi, l’objet services de texte peut optimiser pour l’imprimante (par exemple, ne pas peindre la couleur d’arrière-plan, s’il est blanc). En outre, certains éléments spécifiques à l’écran (tels que la sélection) ne doivent pas être rendus.

ITextServices ::OnTxSetCursor doit afficher le rectangle lprcClient , en commençant à la position de défilement actuelle.

lindex

Type : LONG

Non pris en charge.

[in] pvAspect

Type : void*

Informations sur les optimisations de dessin.

[in] ptd

Type : DVTARGETDEVICE*

Appareil cible.

[in] hdcDraw

Type : HDC

Rendu du contexte d’appareil.

[in] hicTargetDev

Type : HDC

Contexte d’informations cibles.

[in] lprcClient

Type : LPCRECT

Rectangle client du contrôle. Les coordonnées du rectangle se trouvent dans les coordonnées clientes de la fenêtre contenante. NULL est une valeur légale.

[in] x

Type : INT

x position du curseur, dans les coordonnées du client de la fenêtre contenante.

[in] y

Type : INT

y position du curseur, dans les coordonnées client de la fenêtre contenante.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est S_OK.

Si la méthode échoue, la valeur de retour est le code HRESULT suivant. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour	Description
E_INVALIDARG	Un ou plusieurs paramètres non autorisés.

Remarques

L’objet services de texte peut effectuer une nouvelle mesure à la suite de cet appel pour déterminer le curseur correct. Le curseur correct est défini via TxSetCursor.

Le paramètre lprcClient est le rectangle client de la vue du contrôle sur lequel le curseur de la souris est positionné. Le paramètre lprcClient se trouve dans les coordonnées de l’appareil de la fenêtre contenante de la même manière que le message WM_SIZE . Il se peut qu’il ne s’agit pas de la vue qui a été rendue en dernier. En outre, si le contrôle est actif sur place, il se peut qu’il ne s’agit pas de la vue active actuelle . Par conséquent, l’objet services de texte doit case activée ce rectangle par rapport à la valeur de son cache actuel et déterminer si le recalcul des lignes est nécessaire ou non. Le facteur de zoom doit être inclus dans ce calcul. Pour une présentation du facteur de zoom, consultez TxGetExtent.

Cette méthode doit être appelée uniquement pour les vues d’écran du contrôle. Par conséquent, le contexte de l’appareil (DC) n’est pas transmis, mais doit être supposé être un contrôleur de domaine d’écran.

Pour plus d’informations, consultez remarques dans ITextServices ::TxDraw.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	textserv.h
DLL	Msftedit.dll