COleControl::OnQueryHitPoint

Artigo
08/25/2010

Chamado pela estrutura em resposta a IViewObjectEx::QueryHitPoint solicitação.

virtual BOOL OnQueryHitPoint(
   DWORD dwAspect,
      LPCRECT pRectBounds,
      POINT ptlLoc,
      LONG lCloseHint,
      DWORD* pHitResult 
);

Parâmetros

dwAspect
Especifica como o objeto é representado.Os valores válido são tirados de enumeração DVASPECT or DVASPECT2.
pRectBounds
Ponteiro para um RECT estrutura especificando o retângulo delimitador da área de cliente do controle OLE.
ptlLoc
Ponteiro para o PONTO estrutura especificando o ponto para localização de uma ocorrência.O ponto é especificado em coordenadas de área de cliente OLE.
lCloseHint
A distância que define "Fechar" para o ponto marcada para uma ocorrência.
pHitResult
Ponteiro para o resultado da consulta visita.Um dos seguintes valores:
- HITRESULT_OUTSIDE ptlLoc está fora do objeto OLE, mas não fechar.
- HITRESULT_TRANSPARENT ptlLoc está dentro dos limites do objeto OLE, mas não fechar à imagem.Por exemplo, um ponto no meio de um círculo transparente poderia ser HITRESULT_TRANSPARENT.
- HITRESULT_CLOSE ptlLoc está dentro ou fora do objeto OLE, porém próxima o bastante ao objeto a ser considerado como dentro. Objetos pequenos, finos ou detalhados podem usar esse valor.Mesmo se um ponto está fora do limite retângulo de um objeto pode ainda ser fechar (isso é necessário para pressionar objetos pequenos).
- HITRESULT_HIT ptlLoc está dentro da imagem do objeto.

Valor de retorno

Diferente de zero se um resultado de visita é retornado com êxito; caso contrário, 0.Uma ocorrência é uma sobreposição com a área de exibição do controle OLE.

Comentários

Consulta se retângulo de exibição de um objeto se sobrepõe a determinado point (atinge o ponto).QueryHitPoint pode ser substituída para testar a ocorrências de objetos não retangulares.