Share via

Função EvaluateProximityToRect (winuser.h)

  • Artigo

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

   
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho winuser.h
Biblioteca User32.lib
DLL User32.dll

Confira também

Funções