Fonction EvaluateProximityToPolygon (winuser.h)

Article
08/27/2023

Retourne le score d’un polygone en tant que cible tactile probable (par rapport à tous les autres polygones qui croisent la zone de contact tactile) et un point tactile ajusté dans le polygone.

Syntaxe

BOOL EvaluateProximityToPolygon(
        UINT32                                 numVertices,
  [in]  const POINT                            *controlPolygon,
  [in]  const TOUCH_HIT_TESTING_INPUT          *pHitTestingInput,
  [out] TOUCH_HIT_TESTING_PROXIMITY_EVALUATION *pProximityEval
);

Paramètres

numVertices

Nombre de sommets dans le polygone. Cette valeur doit être supérieure ou égale à 3.

Cette valeur indique la taille du tableau, comme spécifié par le paramètre controlPolygon .

[in] controlPolygon

Tableau de coordonnées d’écran x-y qui définissent la forme de l’élément d’interface utilisateur.

Le paramètre numVertices spécifie le nombre de coordonnées.

[in] pHitTestingInput

Structure TOUCH_HIT_TESTING_INPUT qui contient les données de la zone de contact tactile.

[out] pProximityEval

Structure TOUCH_HIT_TESTING_PROXIMITY_EVALUATION qui contient le score et les données de point tactile ajustées.

Valeur retournée

Si cette fonction réussit, elle retourne TRUE.

Sinon, il retourne FALSE. Pour récupérer des informations d’erreur étendues, appelez la fonction GetLastError .

Remarques

À des fins de cohérence avec Windows, les frameworks qui gèrent WM_TOUCHHITTESTING doivent utiliser les principes suivants pour le ciblage :

Inclusion : si le point tactile se trouve dans les limites d’un contrôle, le point tactile n’est pas modifié.
Intersection : incluez uniquement les contrôles qui croisent la géométrie du contact.
Ordre Z : si plusieurs contrôles croisent la géométrie du contact et que les contrôles se chevauchent, le contrôle le plus élevé dans l’ordre z reçoit la priorité.
Ambiguïté : si plusieurs contrôles croisent la géométrie du contact et que les contrôles ne se chevauchent pas, le contrôle le plus proche du point de contact d’origine reçoit la priorité.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	winuser.h
Bibliothèque	User32.lib
DLL	User32.dll

Voir aussi

Fonctions

Partager via