Help Center

Appendfunction

Appends a new item to the end of the specified menu bar, drop-down menu, submenu, or shortcut menu.

Windowsfunctiondoc-orphan
No implementation located. This member is documented, but the source scan found no matching declaration. It is likely declared in a header this scan does not resolve, or provided by a macro.

Syntax

FUNCTION Append (BYVAL hMenu AS HMENU, BYVAL uFlags AS UINT, BYVAL uIDNewItem AS UINT_PTR, BYVAL pwszNewItem AS WSTRING PTR) AS BOOLEAN

Parameters

NameDescription
hMenuHandle of the parent menu to which the item should be added.
uFlagsControls the appearance and behavior of the new menu item. This parameter can be a combination of the following values (see below).
uIDNewItemThe identifier of the new menu item or, if the uFlags parameter is set to MF_POPUP, a handle to the drop-down menu or submenu.
pwszNewItemThe content of the new menu item. The interpretation of pwszNewItem depends on whether the uFlags parameter includes the following values (see below).

Description

Appends a new item to the end of the specified menu bar, drop-down menu, submenu, or shortcut menu. You can use this function to specify the content, appearance, and behavior of the menu item.

Example

CMenu.Append hMenu, MF_POPUP OR MF_ENABLED, CAST(UINT_PTR, hPopUpMenu), "&File" CMenu.Append hPopUpMenu, MF_ENABLED, IDM_NEW, "&New" & CHR(9) & "Ctrl+N" CMenu.Append hPopUpMenu, MF_SEPARATOR, 0, ""

Reference

  • Documented in Windows/WIndows Controls/CMenu Class.md
  • Topic: About Menus