IDWriteTextLayout ::HitTestPoint, méthode (dwrite.h)
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour