Función EvaluateProximityToPolygon (winuser.h)
Devuelve la puntuación de un polígono como el destino táctil probable (en comparación con todos los demás polígonos que cruzan el área de contacto táctil) y un punto táctil ajustado dentro del polígono.
Sintaxis
BOOL EvaluateProximityToPolygon(
UINT32 numVertices,
[in] const POINT *controlPolygon,
[in] const TOUCH_HIT_TESTING_INPUT *pHitTestingInput,
[out] TOUCH_HIT_TESTING_PROXIMITY_EVALUATION *pProximityEval
);
Parámetros
numVertices
Número de vértices en el polígono. Este valor debe ser mayor o igual que 3.
Este valor indica el tamaño de la matriz, tal y como especifica el parámetro controlPolygon .
[in] controlPolygon
Matriz de coordenadas de pantalla x-y que definen la forma del elemento de la interfaz de usuario.
El parámetro numVertices especifica el número de coordenadas.
[in] pHitTestingInput
Estructura TOUCH_HIT_TESTING_INPUT que contiene los datos del área de contacto táctil.
[out] pProximityEval
Estructura TOUCH_HIT_TESTING_PROXIMITY_EVALUATION que contiene la puntuación y los datos de punto táctil ajustados.
Valor devuelto
Si esta función se ejecuta correctamente, devuelve TRUE.
De lo contrario, devuelve FALSE. Para recuperar información de error extendida, llame a la función GetLastError .
Comentarios
Para mantener la coherencia con Windows, los marcos que controlan WM_TOUCHHITTESTING deben usar los siguientes principios para el destino:
- Inclusión: si el punto táctil está dentro de los límites de un control, no se cambia el punto táctil.
- Intersección: incluya solo los controles que intersecan la geometría de contacto.
- Orden Z: si más de un control interseca la geometría de contacto y los controles se superponen, el control que es más alto en el orden z recibe prioridad.
- Ambigüedad: si más de un control interseca la geometría de contacto y los controles no se superponen, el control más cercano al punto táctil original recibe prioridad.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | winuser.h |
| Library | User32.lib |
| Archivo DLL | User32.dll |