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

Article
08/23/2023

L’application appelle cette fonction en passant un emplacement de pixel spécifique par rapport à l’emplacement supérieur gauche de la zone de disposition et obtient les informations sur les métriques correspondantes de test de positionnement de la chaîne de texte où le test d’accès a eu lieu. Lorsque l’emplacement de pixel spécifié est en dehors de la chaîne de texte, la fonction définit la valeur de sortie *isInside sur FALSE.

Syntaxe

HRESULT HitTestPoint(
        FLOAT                   pointX,
        FLOAT                   pointY,
  [out] BOOL                    *isTrailingHit,
  [out] BOOL                    *isInside,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

Paramètres

pointX

Type : FLOAT

Emplacement de pixel X à tester par rapport à l’emplacement supérieur gauche de la zone de disposition.

pointY

Type : FLOAT

Emplacement du pixel Y à tester par rapport à l’emplacement supérieur gauche de la zone de disposition.

[out] isTrailingHit

Type : BOOL*

Indicateur de sortie qui indique si l’emplacement du test d’accès se trouve au début ou à la fin du caractère. Lorsque la valeur de sortie *isInside est définie sur FALSE, cette valeur est définie en fonction de la valeur hitTestMetrics-textPosition> de sortie pour représenter l’arête la plus proche de l’emplacement de test d’accès.

[out] isInside

Type : BOOL*

Indicateur de sortie qui indique si l’emplacement du test de positionnement se trouve à l’intérieur de la chaîne de texte. Lorsque la valeur est FALSE, la position la plus proche du bord du texte est retournée.

[out] hitTestMetrics

Type : DWRITE_HIT_TEST_METRICS*

Géométrie de sortie englobant entièrement l’emplacement du test de positionnement. Lorsque la valeur de sortie *isInside est définie sur FALSE, cette structure représente la géométrie englobant le bord le plus proche de l’emplacement de test de positionnement.

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 Platform Update 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

Partager via