Compartilhar via


COleControl::OnQueryHitRect

Chamado pela estrutura em resposta à solicitação de IViewObjectEx::QueryHitRect de um recipiente.

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álidos são tirados de enumeração DVASPECT ou DVASPECT2.

  • pRectBounds
    Ponteiro a estrutura de RECT que especifica o retângulo delimitador da área cliente do controlador o OLE.

  • prcLoc
    Ponteiro para a estrutura de RECT que especifica o retângulo a ser verificado para uma ocorrência (sobreposição com o retângulo do objeto), em relação ao canto superior esquerdo do objeto.

  • lCloseHint
    Não usado.

  • pHitResult
    Ponteiro para o resultado de consulta de clique.Um dos seguintes valores:

    • HITRESULT_OUTSIDE qualquer ponto no retângulo é atingido pelo objeto OLE.

    • HITRESULT_HIT pelo menos um ponto dentro do retângulo seria uma ocorrência no objeto.

Valor de retorno

Diferente de zero se um resultado de clique é retornada com êxito; se não 0.

Comentários

Consulta se o retângulo de exibição de um objeto sobrepostos qualquer ponto no retângulo determinado (ocorrências o retângulo).QueryHitRect pode ser substituído para testar ocorrências para objetos não retangulares.

Requisitos

Cabeçalho: afxctl.h

Consulte também

Referência

Classe de COleControl

Gráfico de hierarquia

COleControl::OnQueryHitPoint