C++ Syntax

void

MKI_TOOLTIP_LIST::SetTooltipList(

HWND f_hDlg,

MKI_TOOLTIP_ENTRY_PTR f_pListOfEntries1,

MKI_TOOLTIP_ENTRY_PTR f_pListOfEntries2 = nullptr );

Associates one or two lists of tooltip texts with the controls of a dialog window.

Parameters

f_hDlg

[HWND] Handle of the dialog window that contains the controls to be associated with the given tooltips.

f_pListOfEntries1

[MKI_TOOLTIP_ENTRY_PTR] Address of a list of tooltip texts to be associated with specified control of the dialog window. May be nullptr. The list may contain entries for controls that do not exist in the given dialog window, those will be skipped. Terminate the list with an entry containing a negative control ID and the text MKI_END_TEXTW.

f_pListOfEntries2

Comment

This procedure is a kind of macro that executes steps similar to the following code segment:

MKI_TOOLTIP_LIST::Exit();

MKI_TOOLTIP_LIST::Init();

MKI_TOOLTIP_LIST::AddTooltipList( f_hDlg, f_pListOfEntries1, f_pListOfEntries2 );

MKI_TOOLTIP_LIST::Activate();

This causes the tooltip list to be (re-)initialized, filled with the given new list(s), and then activated.

If possible, you should use this command instead of calling the separate procedures to reduce code size.