Compartir a través de

Función EvaluateProximityToRect (winuser.h)

  • Artículo

Devuelve la puntuación de un rectángulo como destino táctil probable, en comparación con todos los demás rectángulos que intersecan el área de contacto táctil y un punto táctil ajustado dentro del rectángulo.

Sintaxis

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

Parámetros

[in] controlBoundingBox

Estructura RECT que define el rectángulo delimitador del elemento de la interfaz de usuario.

[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, el punto táctil no cambia.
  • 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 más alto del 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

   
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

Vea también

Funciones