Fonction EvaluateProximityToRect (winuser.h)

Article
08/27/2023

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

Syntaxe

BOOL EvaluateProximityToRect(
  [in]  const RECT                             *controlBoundingBox,
  [in]  const TOUCH_HIT_TESTING_INPUT          *pHitTestingInput,
  [out] TOUCH_HIT_TESTING_PROXIMITY_EVALUATION *pProximityEval
);

Paramètres

[in] controlBoundingBox

Structure RECT qui définit le cadre englobant de l’élément d’interface utilisateur.

[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


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