This documentation is archived and is not being maintained.


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.


This member function implements the behavior of the Win32 macro, ListView_GetHotItem, as described in the Platform 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.


// The pointer to my list view control.
extern CListCtrl* pmyListCtrl;

// Set the hot item to the first item only if no other item is 
// highlighted.
if (pmyListCtrl->GetHotItem() == -1)

See Also

CListCtrl Overview | Class Members | Hierarchy Chart | CListCtrl::GetHotCursor