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

Article
08/26/2023

Teste si un point spécifié se trouve dans le rectangle de l’objet services de texte.

Syntaxe

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

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::TxGetNaturalSize 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::TxGetNaturalSize 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*

Informations sur l’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, dans les coordonnées du client (appareil) de la vue dans laquelle le test d’accès est effectué.

[in] x

Type : INT

x-coordonnée pour case activée, dans les coordonnées du client, de la vue dans laquelle le test d’accès est effectué.

[in] y

Type : INT

coordonnée y pour case activée, dans les coordonnées du client, de la vue dans laquelle le test d’accès est effectué.

[out] pHitResult

Type : DWORD*

Résultat du test d'atteinte. Il peut s’agir de l’une des valeurs d’énumération TXTHITRESULT suivantes.

Valeur	Signification
TXTHITRESULT_CLOSE	Le point se trouve dans le rectangle client et près d’une zone nontransparente.
TXTHITRESULT_HIT	Le point se trouve dans le rectangle client et sur le texte ou l’arrière-plan n’est pas transparent.
TXTHITRESULT_NOHIT	Le point se trouve en dehors du rectangle client.
TXTHITRESULT_TRANSPARENT	Le point se trouve dans le rectangle client et soit pas sur le texte, soit l’arrière-plan était transparent.

Valeur retournée

Type : HRESULT

La valeur de retour est un code HRESULT .

Remarques

Cette méthode permet à l’hôte d’implémenter un test d’accès transparent sur du texte.

Pour plus d’informations, consultez la section Remarques dans ITextServices::TxDraw et ITextServices::OnTxSetCursor.

Configuration requise


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