Funzione EvaluateProximityToPolygon (winuser.h)

Articolo
08/27/2023

Restituisce il punteggio di un poligono come destinazione del tocco probabile (rispetto a tutti gli altri poligoni che intersecano l'area del contatto tocco) e un punto di tocco modificato all'interno del poligono.

Sintassi

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

Parametri

numVertices

Numero di vertici nel poligono. Questo valore deve essere maggiore o uguale a 3.

Questo valore indica le dimensioni della matrice, come specificato dal parametro controlPolygon .

[in] controlPolygon

Matrice di coordinate dello schermo x-y che definiscono la forma dell'elemento dell'interfaccia utente.

Il parametro numVertices specifica il numero di coordinate.

[in] pHitTestingInput

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

[out] pProximityEval

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

Valore restituito

Se questa funzione ha esito positivo, restituisce TRUE.

In caso contrario, restituisce FALSE. Per recuperare informazioni di 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 all'interno dei limiti di un controllo, il punto di tocco non viene modificato.
Intersezione: includere solo 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

Requisito	Valore
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