C++ Syntax

class MKI_POPUP_ENTRY

{

public:

LPWSTR m_pszText;

__int32 m_nCommand;

bool m_fGrayed,

m_fChecked;

__int16 m_nShortcut;

__int32 m_nSubCount;

MKI_POPUP_ENTRY* m_pSubList;

};

This structure contains a single popup menu entry. Each entry may have its own submenu.

Element Description

Text Changed in Version 2019.1

[LPWSTR] Address of the menu entry's text. This text must not be longer than 127 characters. If Text is nullptr, the menu entry will be a separator. In this case, any submenu data will be ignored. A separator can neither be grayed nor checked.

Command

[__int32] The number of the command represented by the menu entry. This number will be returned if the user selects this menu entry. Will be ignored if this is a submenu entry.

Grayed

[bool] If true, the menu entry will be grayed and disabled. A grayed entry cannot be checked.

Checked

[bool] If true, the menu entry will be checked. A grayed entry cannot be checked.

Shortcut

[__int16] Contains the shortcut index of the menu entry. If Shortcut is 0 or positive, the menu entry will be prefixed by the according key shortcut (1, 2, 3, 4, etc.). If Shortcut is negative, no prefix will be added, the menu entry text may contain its own shortcut (as defined by a '&' character followed by another character).

To align menu entries with and without automatic index, use the '\a' character in the entries without automatic index. This will result in the same alignment. To right-align parts of the menu entries, use the '\t' character. Both characters can be used in one entry only if '\a' is used before '\t'.

SubList

[MKI_POPUP_ENTRY*] Address of a submenu entry list. If not nullptr, this list defines the submenu entries to be linked to this menu entry.

SubCount

[__int32] Number of submenu entries defined in SubList. For usability reasons, this number should not exceed 20. For larger number, use multiple nested submenus.