This documentation is archived and is not being maintained.

CListCtrl::GetToolTips

Retrieves the tooltip control that the list view control uses to display tooltips.

CToolTipCtrl* GetToolTips( ) const;

Return Value

A pointer to a CToolTipCtrl object to be used by the list control. If the Create member function uses the style LVS_NOTOOLTIPS, no tooltips are used, and NULL is returned.

Remarks

This member function implements the behavior of the Win32 message LVM_GETTOOLTIPS, as described in the Platform SDK. The MFC implementation of GetToolTips returns a CToolTipCtrl object, which is used by the list control, rather than a handle to a tooltip control.

Example

// The pointer to my list control.
extern CListCtrl* pmyListCtrl;
// A pointer to a tooltips control.
extern CToolTipCtrl* pmyToolTip;

// If the list control does not have a tooltips control,
// then use pmyToolTip as the tootips for the list control.
if (pmyListCtrl->GetToolTips() == NULL)
{
   pmyListCtrl->SetToolTips(pmyToolTip);
}

See Also

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

Show: