SHMENUBARINFO (Compact 2013)

3/28/2014

This structure sets members for the SHCreateMenuBar function.

Syntax

typedef struct tagSHMENUBARINFO {
  DWORD cbSize;
  HWND hwndParent;
  DWORD dwFlags;
  UINT nToolBarId;
  HINSTANCE hInstRes;
  int nBmpId;
  int cBmpImages;
  HWND hwndMB;
  COLORREF clrBk;
} SHMENUBARINFO, *PSHMENUBARINFO;

Members

• cbSize
  The size of the SHMENUBARINFO structure.

• hwndParent
  Handle to the window to control the command bar window.

• dwFlags
  Specifies the properties of the menu bar. The following table shows the possible values for this member.

  Flag	Description
  SHCMBF_COLORBK	Sets the background color value for the menu bar.
  SHCMBF_EMPTYBAR	Creates an empty menu bar.
  SHCMBF_HIDDEN	Creates the menu bar initially hidden.
  SHCMBF_HMENU	Specifies an HMENU menu handle for a resource rather than for toolbar information.
  SHCMBF_NOACTION	The shell action central menu item is not added to the central menu.

• nToolBarId
  If SHCMBF_HMENU is not set, nToolBarId is a toolbar identifier used to load the resource from the instance specified by hInstRes.

  If SHCMBF_HMENU is set, nToolBarId is a menu identifier used to load the resource from the instance specified by hInstRes. Additionally, if this identifier is used for soft key creation and the HIWORD is zero, a copy of the hmenu already loaded in memory is made, and nToolBarId directly represents the copy.

• hInstRes
  Instance handle that controls the resources.

• nBmpId
  Bitmap identifier used to load the bitmap resource for buttons with images from the instance specified by hInstRes. This bitmap should have the same format as bitmaps used in ImageList functions. This member should be set to NULL if the creation of soft keys is intentional.

• cBmpImages
  Number of images in the bitmap referred to by nBmpId. This member should be set to NULL if the creation of soft keys is intentional.

• hwndMB
  Window handle to the menu bar.

• clrBk
  Defines the background color of the menu bar, excluding the software-based input panel (SIP).

Requirements

See Also

Reference

Shell Structures
SHCreateMenuBar