C++ Syntax

void

MKI_DialogCustomIconControl(

HWND f_hWindow,

__int32 f_nCtlID,

MKI_CONST_ICON_DATA_REF f_rIconData );

void

MKI_DialogCustomIconControl(

HWND f_hWindow,

__int32 f_nCtlID,

__int32 f_IconID );

Draws a MKI_ICON_COMMAND_SIZE by MKI_ICON_COMMAND_SIZE pixels bitmap inside an icon-sized button control or in an icon-sized owner draw image control.

An standard icon-sized buttons should have a size of 28 dialog units wide, 24 dialog units high. An standard owner draw image control should have a size of 24 dialog units wide, 20 dialog units high. Both types may, however, have different sizes as the icon will automatically be scaled to fit.

For Windows 11 only: If the control is a radio-button control, the "active" radio-button will additionally be drawn with a colored background to highlight the chosen option.

Parameters

f_hWindow

[HWND] Handle of the dialog window that contains the icon button control.

f_nCtlID

[__int32] Identification number of the icon button control.

f_rIconData

[MKI_CONST_ICON_DATA_REF] Description of the icon to be drawn.

f_nIconID

[__int32] Identification number of the application's standard icon, see MKI_ICON_ID_*.