Compartilhar via


COleControl::OnQueryHitPoint

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

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

Parâmetros

  • dwAspect
    Especifica como o objeto é 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.

  • ptlLoc
    Ponteiro para a estrutura de POINT que especifica o ponto a ser verificado para uma ocorrência. O ponto é especificado em coordenadas VELHOS da área cliente.

  • lCloseHint
    A distância que define o “end” ao ponto verificar a existência uma ocorrência.

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

    • HITRESULT_OUTSIDE   ptlLoc está fora do objeto e não end VELHOS.

    • HITRESULT_TRANSPARENT   o ptlLoc está dentro dos limites do objeto OLE, mas não final da imagem. Por exemplo, um ponto no meio de um círculo transparente pôde ser HITRESULT_TRANSPARENT.

    • HITRESULT_CLOSE   ptlLoc está dentro ou fora do objeto OLE mas end suficiente para o objeto a ser considerado em. Os objetos pequenos, finos, ou detalhados podem usar esse valor. Mesmo se um ponto está fora o retângulo delimitador de um objeto pode ainda ser final (isso é necessário batendo objetos pequenos).

    • HITRESULT_HIT   ptlLoc está dentro da imagem do objeto.

Valor de retorno

Diferente de zero se um resultado de clique é retornada com êxito; se não 0. Um acerto é uma sobreposição com a área de exibição do controlador o OLE.

Comentários

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

Requisitos

Cabeçalho: afxctl.h

Consulte também

Referência

Classe COleControl

Gráfico da hierarquia

COleControl::OnQueryHitRect