Funzione EvaluateProximityToRect (winuser.h)

Articolo
03/15/2023

Restituisce il punteggio di un rettangolo come destinazione di tocco probabile, rispetto a tutti gli altri rettangoli che intersecano l'area di contatto tocco e un punto di tocco regolato all'interno del rettangolo.

Sintassi

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

Parametri

[in] controlBoundingBox

Struttura RECT che definisce il rettangolo di selezione dell'elemento dell'interfaccia utente.

[in] pHitTestingInput

Struttura TOUCH_HIT_TESTING_INPUT che contiene i dati per l'area di contatto tocco.

[out] pProximityEval

Struttura TOUCH_HIT_TESTING_PROXIMITY_EVALUATION che contiene il punteggio e i dati del punto di tocco modificati.

Valore restituito

Se questa funzione ha esito positivo, restituisce TRUE.

In caso contrario, restituisce FALSE. Per recuperare informazioni sull'errore estese, chiamare la funzione GetLastError .

Commenti

Per coerenza con Windows, i framework che gestiscono WM_TOUCHHITTESTING devono usare i principi seguenti per la destinazione:

Inclusione: se il punto di tocco si trova entro i limiti di un controllo, il punto di tocco non viene modificato.
Intersezione: includere solo i controlli che intersecano la geometria del contatto.
Ordine Z: se più controlli intersecano la geometria del contatto e i controlli si sovrappongono, il controllo più alto nell'ordine z riceve la priorità.
Ambiguità: se più controlli intersecano la geometria del contatto e i controlli non si sovrappongono, il controllo più vicino al punto di tocco originale riceve la priorità.

Requisiti


Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	Winuser
Libreria	User32.lib
DLL	User32.dll

Vedi anche

Funzioni

Condividi tramite