Função EvaluateProximityToRect (winuser.h)

Retorna a pontuação de um retângulo como o provável destino de toque, em comparação com todos os outros retângulos que cruzam a área de contato de toque e um ponto de toque ajustado dentro do retângulo.

Sintaxe

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

Parâmetros

[in] controlBoundingBox

A estrutura RECT que define a caixa delimitadora do elemento de interface do usuário.

[in] pHitTestingInput

A estrutura TOUCH_HIT_TESTING_INPUT que contém os dados da área de contato por toque.

[out] pProximityEval

A estrutura TOUCH_HIT_TESTING_PROXIMITY_EVALUATION que contém a pontuação e os dados de ponto de toque ajustados.

Valor retornado

Se essa função for bem-sucedida, ela retornará TRUE.

Caso contrário, retornará FALSE. Para recuperar informações de erro estendidas, chame a função GetLastError .

Comentários

Para consistência com o Windows, as estruturas que lidam com WM_TOUCHHITTESTING devem usar os seguintes princípios para direcionamento:

• Inclusão: se o ponto de toque estiver dentro dos limites de um controle, o ponto de toque não será alterado.
• Interseção: inclua apenas os controles que cruzam a geometria de contato.
• Ordem Z: se mais de um controle cruza a geometria de contato e os controles se sobrepõem, o controle mais alto na ordem z recebe prioridade.
• Ambiguidade: se mais de um controle cruza a geometria de contato e os controles não se sobrepõem, o controle mais próximo do ponto de toque original recebe prioridade.

Requisitos

Confira também

Funções