Export (0) Print
Expand All
Expand Minimize

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 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.

Example

// 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)
   pmyListCtrl->SetHotItem(0);

See Also

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

Show:
© 2014 Microsoft