This documentation is archived and is not being maintained.

CListCtrl::GetHotCursor

Retrieves the cursor used when hot tracking is enabled for a list view control.

HCURSOR GetHotCursor( );

Return Value

The handle to the current hot cursor resource being used by the list view control.

Remarks

This member function implements the behavior of the Win32 macro, ListView_GetHotCursor, as described in the Platform SDK. The hot cursor, only visible when hover selection is enabled, appears when the cursor passes over any list view item. Hover selection is enabled by setting the LVS_EX_TRACKSELECT extended style.

Example

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

// Set the hot cursor to be the system app starting cursor.
HCURSOR hCursor = ::LoadCursor(NULL, IDC_APPSTARTING);
pmyListCtrl->SetHotCursor(hCursor);
ASSERT(pmyListCtrl->GetHotCursor() == hCursor);

See Also

CListCtrl Overview | Class Members | Hierarchy Chart | CListCtrl::SetHotCursor | CListCtrl::GetHotItem

Show: