CListCtrl::HitTest

Článek
06/10/2015

Zobrazit položku seznamu, která určuje, zda existuje, je na určené pozici.

int HitTest( 
   LVHITTESTINFO* pHitTestInfo  
) const; 
int HitTest( 
   CPoint pt, 
   UINT* pFlags = NULL  
) const;

Parametry

pHitTestInfo
Adresa LVHITTESTINFO struktura obsahující postoj přístupů test a který obdrží informace o výsledcích zkoušky přístupů.
pt
Bod zkoušeného.
pFlags
Ukazatel na celé číslo, které obdrží informace o výsledky zkoušky.Viz vysvětlení příznaky člena LVHITTESTINFO struktury v .

Vrácená hodnota

Index položky na určené pozici pHitTestInfo , pokud existuje, nebo jinak -1.

Poznámky

Můžete použít LVHT_ABOVE , LVHT_BELOW , LVHT_TOLEFT , a LVHT_TORIGHT hodnoty na strukturu příznak určit, zda posouvat obsah ovládacího prvku zobrazení seznamu členů.Dva tyto příznaky lze kombinovat, například pokud je umístění nad a doleva oblasti klienta.

Lze otestovat LVHT_ONITEM hodnotu na strukturu příznak člena zjistit, zda je dané pozici zobrazit položku seznamu.Tato hodnota je operace bitového nebo na LVHT_ONITEMICON , LVHT_ONITEMLABEL , a LVHT_ONITEMSTATEICON hodnoty na strukturu příznak člen.

Příklad

void CListCtrlDlg::OnRClick(NMHDR* pNMHDR, LRESULT* pResult)
{
    LPNMITEMACTIVATE pia = (LPNMITEMACTIVATE)pNMHDR;
    CPoint point(pia->ptAction);

    // Select the item the user clicked on.
    UINT uFlags;
    int nItem = m_myListCtrl.HitTest(point, &uFlags);

    if (uFlags & LVHT_ONITEMLABEL)
    {
        m_myListCtrl.SetItem(nItem, 0, LVIF_STATE, NULL, 0, LVIS_SELECTED, 
            LVIS_SELECTED, 0);
    }

    *pResult = 0;
}