CListCtrl::GetItemRect

Retrieves the bounding rectangle for all or part of an item in the current view.

BOOL GetItemRect(
   int nItem,
   LPRECT lpRect,
   UINT nCode 
) const;

Parameters

  • nItem
    The index of the item whose position is to be retrieved.

  • lpRect
    Address of a RECT structure that receives the bounding rectangle.

  • nCode
    Portion of the list view item for which to retrieve the bounding rectangle. It can be one of these values:

    • LVIR_BOUNDS   Returns the bounding rectangle of the entire item, including the icon and label.

    • LVIR_ICON   Returns the bounding rectangle of the icon or small icon.

    • LVIR_LABEL   Returns the bounding rectangle of the item text.

Return Value

Nonzero if successful; otherwise zero.

Example

// OnClick is the handler for the NM_CLICK notification
void CListCtrlDlg::OnClick(NMHDR* pNMHDR, LRESULT* pResult)
{
   UNREFERENCED_PARAMETER(pResult);

   LPNMITEMACTIVATE pia = (LPNMITEMACTIVATE)pNMHDR;

   // Get the current mouse location and convert it to client
   // coordinates.
   CPoint pos( ::GetMessagePos() ); 
   ScreenToClient(&pos);

   // Get indexes of the first and last visible items in 
   // the listview control.
   int index = m_myListCtrl.GetTopIndex();
   int last_visible_index = index + m_myListCtrl.GetCountPerPage();
   if (last_visible_index > m_myListCtrl.GetItemCount())
       last_visible_index = m_myListCtrl.GetItemCount();

   // Loop until number visible items has been reached.
   while (index <= last_visible_index)
   {
       // Get the bounding rectangle of an item. If the mouse
       // location is within the bounding rectangle of the item,
       // you know you have found the item that was being clicked.
       CRect r;
       m_myListCtrl.GetItemRect(index, &r, LVIR_BOUNDS);
       if (r.PtInRect(pia->ptAction))
           {
               UINT flag = LVIS_SELECTED | LVIS_FOCUSED;
               m_myListCtrl.SetItemState(index, flag, flag);
               break;
          }

       // Get the next item in listview control.
       index++;
   }
}

Requirements

Header: afxcmn.h

See Also

Reference

CListCtrl Class

Hierarchy Chart

CListCtrl::GetItemPosition

CListCtrl::SetItemPosition

CListCtrl::GetOrigin

Other Resources

CListCtrl Members