IDWriteTextLayout ::HitTestTextPosition, méthode (dwrite.h)

  • Article

L’application appelle cette fonction pour obtenir l’emplacement des pixels par rapport à la partie supérieure gauche de la zone de disposition en fonction de la position du texte et du côté logique de la position. Cette fonction est normalement utilisée dans le cadre du positionnement de la carete du texte où le caret est dessiné à l’emplacement correspondant à la position de modification de texte actuelle. Il peut également être utilisé comme un moyen d’obtenir par programmation la géométrie d’une position de texte particulière dans l’automatisation de l’interface utilisateur.

Syntaxe

HRESULT HitTestTextPosition(
        UINT32                  textPosition,
        BOOL                    isTrailingHit,
  [out] FLOAT                   *pointX,
  [out] FLOAT                   *pointY,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

Paramètres

textPosition

Type : UINT32

Position de texte utilisée pour obtenir l’emplacement des pixels.

isTrailingHit

Type : BOOL

Indicateur booléen qui indique si l’emplacement des pixels est du côté de début ou de fin de la position de texte spécifiée.

[out] pointX

Type : FLOAT*

Lorsque cette méthode retourne, contient l’emplacement de pixel de sortie X, par rapport à l’emplacement supérieur gauche de la zone de disposition.

[out] pointY

Type : FLOAT*

Lorsque cette méthode retourne, contient l’emplacement de pixel de sortie Y, par rapport à l’emplacement supérieur gauche de la zone de disposition.

[out] hitTestMetrics

Type : DWRITE_HIT_TEST_METRICS*

Lorsque cette méthode retourne, contient la géométrie de sortie englobant entièrement la position de texte spécifiée.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête dwrite.h
Bibliothèque Dwrite.lib
DLL Dwrite.dll

Voir aussi

IDWriteTextLayout