AddTooltipList (class MKI_TOOLTIP_LIST) New in Version 2023.1

C++ Syntax

void

MKI_TOOLTIP_LIST::AddTooltipList(

 HWND f_hDlg,

 MKI_TOOLTIP_ENTRY_PTR f_pListOfEntries1,

 MKI_TOOLTIP_ENTRY_PTR f_pListOfEntries2 = nullptr );

Adds one or two lists of tooltip texts to the current tooltip list.

Afterwards, standard texts for the following default control IDs (as defined in the supplied dialog.h header file) will be added if they exist in the dialog and not in one of the two lists:

IDD_OK (1)

IDD_CANCEL (2)

IDD_CLOSE (21)

IDD_HELP (22)

IDD_PINBOARD1 (36)

IDD_PINBOARD2 (37)

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

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

In the usual case where this tooltip list is the only tooltip data to be used for a dialog window, you can use MKI_TOOLTIP_LIST::SetTooltipList instead of this procedure to reduce code size. See the description of that procedure for details.