IDWriteTextLayout ::HitTestTextPosition, méthode (dwrite.h)
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 |