CListCtrl::GetHotItem

Retrieves the list view item currently under the cursor.

int GetHotItem( );

Return Value

The index of the current hot item of the list view control.

Remarks

This member function implements the behavior of the Win32 macro, ListView_GetHotItem, as described in the Windows SDK. The hot item is defined as the currently selected item when hot tracking (and hover selection) is enabled.

If hot tracking is enabled, when a user pauses over a list view item, the item label is automatically highlighted without the use of a mouse button.

Example

// Set the hot item to the first item only if no other item is 
// highlighted.
if (m_myListCtrl.GetHotItem() == -1)
   m_myListCtrl.SetHotItem(0);

Requirements

Header: afxcmn.h

See Also

Concepts

CListCtrl Class

CListCtrl Members

Hierarchy Chart

CListCtrl::GetHotCursor