Share

CAcTcUiCatalogView::HitTest

C++

int HitTest(
    const CPoint& pt, 
    UINT* pHitFlags
) const;

Description

Returns the index of the item at the specified point. The point should be in the client coordinates of the catalog view. The results of the test can be one or more of the following hit flags:

ACTCUI_CVHT_NOWHERE Not in the view window's client area
ACTCUI_CVHT_ITEM On the item; may be combined with ACTCUI_CVHT_ITEMIMAGE or ACTCUI_CVHT_ITEMLABEL
ACTCUI_CVHT_ITEMIMAGE On the item's image
ACTCUI_CVHT_ITEMLABEL On the item's text
ACTCUI_CVHT_ITEMTRIGGER On the item's trigger if the item is a tool and the tool is a flyout tool
ACTCUI_CVHT_BACKGROUND On the view background; may be combined with ACTCUI_CVHT_ABOVE, ACTCUI_CVHT_BELOW, ACTCUI_CVHT_LEFT, ACTCUI_CVHT_RIGHT
ACTCUI_CVHT_ABOVE Above the viewing area (the rectangle in which the items are displayed, excluding margins)
ACTCUI_CVHT_BELOW Below the viewing area (the rectangle in which the items are displayed, excluding margins)
ACTCUI_CVHT_LEFT Left of the viewing area (the rectangle in which the items are displayed, excluding margins)
ACTCUI_CVHT_RIGHT Right of the viewing area (the rectangle in which the items are displayed, excluding margins)

Returns -1 if there is no item at the position specified by pt.

Parameters

Parameters Description
pt Input point to be tested
pHitFlags Input pointer to receive the results of the test

Links

CAcTcUiCatalogView Class

Was this information helpful?