COleControl::OnQueryHitRect

Artigo
08/25/2010

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

virtual BOOL OnQueryHitRect(
   DWORD dwAspect,
   LPCRECT pRectBounds,
   LPCRECT prcLoc,
   LONG lCloseHint,
   DWORD* pHitResult 
);

Parâmetros

dwAspect
Especifica como o objeto deve ser 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.
prcLoc
Ponteiro para o RECT estrutura especificando o retângulo para localização de um acerto (sobreposição com o retângulo de objeto) em relação ao canto superior esquerdo do objeto.
lCloseHint
Não usado.
pHitResult
Ponteiro para o resultado da consulta visita.Um dos seguintes valores:
- HITRESULT_OUTSIDE sem ponto no retângulo é atingido pelo objeto OLE.
- HITRESULT_HIT pelo menos um ponto no retângulo seria um acerto no objeto.

Valor de retorno

Diferente de zero se um resultado de visita é retornado com êxito; caso contrário, 0.

Comentários

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