Condividi tramite


COleControl::OnQueryHitPoint

Chiamato dal framework in risposta alla richiesta IViewObjectEx::QueryHitPoint di un contenitore.

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

Parametri

  • dwAspect
    Specifica come oggetto viene rappresentato.I valori validi sono eseguite dall'enumerazione DVASPECT o DVASPECT2.

  • pRectBounds
    Puntatore a una struttura RECT che specifica il rettangolo di delimitazione dell'area client del controllo OLE.

  • ptlLoc
    Puntatore a una struttura di punti che specifica il punto per una riga eseguita.Il punto specificato in coordinate dell'area client OLE.

  • lCloseHint
    La distanza che definisce la fine" al punto è verificata la riga eseguita.

  • pHitResult
    Puntatore al risultato della query di riga eseguita.Uno dei valori seguenti:

    • HITRESULT_OUTSIDE   ptlLoc è esterno all'oggetto OLE e non la fine.

    • HITRESULT_TRANSPARENT   il ptlLoc non rientra nei limiti dell'oggetto OLE, ma non la fine dell'immagine.Ad esempio, un punto in corso un cerchio trasparente può essere HITRESULT_TRANSPARENT.

    • HITRESULT_CLOSE   ptlLoc è all'interno o all'oggetto OLE ma la fine dell'oggetto da considerare in.I piccoli, oggetti e difficili o complessi possono utilizzare questo valore.Anche se un punto è compreso all'esterno del rettangolo di delimitazione di un oggetto può ancora essere tramite questo è necessario per raggiungere piccoli oggetti).

    • HITRESULT_HIT   ptlLoc l'interno dell'immagine dell'oggetto.

Valore restituito

Diverso da zero se il risultato di riga eseguita correttamente, viene restituito in caso contrario 0.Un'occorrenza è una sovrapposizione con l'area di visualizzazione del controllo OLE.

Note

Eseguire una query se il rettangolo visualizzato di un oggetto si sovrappone al punto specificato (richieste soddisfatte il punto).QueryHitPoint può essere sottoposto a override per verificare le richieste soddisfatte per gli oggetti non rettangolari.

Requisiti

Header: afxctl.h

Vedere anche

Riferimenti

Classe di COleControl

Grafico della gerarchia

COleControl::OnQueryHitRect