MKI_DrawEntity (Display) Changed in Version 2023.2

C++ Syntax

void

MKI_DrawEntity(

 HWND f_hWindow,

 MKI_CONST_ENTITY_PTR f_pEntity,

 __int32 f_nBackground,

 const LPCWSTR f_pszText );

Displays an entity within the given window. The complete client area of the window will be used.

Parameters

f_hWindow

[HWND] Handle of the window or control into whose client area the block shall be drawn.

f_pEntity

[MKI_CONST_ENTITY_PTR] Address of the entity to be drawn. Must not be nullptr.

f_nBackground New in Version 2023.2

[__int32] Background color mode. Possible values are:

MKI_BACKGROUNDCOLOR_NONE

The control's background will not be filled at all before displaying the entity.

MKI_BACKGROUNDCOLOR_DEFAULT

The control's background will be filled in the system default color before displaying the entity.

MKI_BACKGROUNDCOLOR_WHITE

The control's background will be filled in white before displaying the entity.

MKI_BACKGROUNDCOLOR_GRAY

The control's background will be filled in 50% gray before displaying the entity.

MKI_BACKGROUNDCOLOR_BLACK

The control's background will be filled in black before displaying the entity.

f_pszText New in Version 2023.2

[const LPCWSTR] Address of a text to be displayed in the upper left corner of the window or control. If nullptr, no text will be displayed.

Comment

This procedure is usually used to display an entity inside a static control or button inside a dialog window.

If there is nothing to display at all, use MKI_DrawClear to clear the window.