SHMENUBARINFO

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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
  Size of 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_DISABLEDSOFTKEYICONS	Applies to Windows Mobile 6.5.3 Enables the display of custom icons (specifically for describing the default or pressed tile state) within the touchable tiles in the menu bar. The bitmap icons are loaded from the strip bitmap that corresponds to the resource bitmap ID provided in the SHMENUBARINFO.nBmpId field. Note   This flag is supported only for Windows Mobile Professional.
  SHCMBF_EMPTYBAR	Creates an empty menu bar.
  SHCMBF_HIDDEN	Creates the menu bar initially hidden.
  SHCMBF_HMENU	Specifies an hmenu value for a resource rather than for toolbar information.
  SHCMBF_HIDESIPBUTTON	Creates the menu bar with no Input Panel button. Note   This flag is supported only for Windows Mobile.
  SHCMBF_SOFTKEYICONS	Applies to Windows Mobile 6.5.3 Enables the display of custom icons (specifically for describing the disabled tile state) within the touchable tiles in the menu bar. This flag is only valid if SHCMBF_SOFTKEYICONS is also set. The bitmap icons are loaded from the strip bitmap that corresponds to the resource bitmap ID provided in the SHMENUBARINFO.nBmpId field plus one (i.e., if nBmpId is 200, then the disable resource bitmap ID used to load the bitmap would be interpreted as 201). Note   This flag is supported only for Windows Mobile Professional.
  SHCMBF_THEMEBITMAPS	Applies to Windows Mobile 6.5.3 Enables the display of theme-specific icons within the touchable tiles (buttons) in the menu bar. Note   This flag is supported only for Windows Mobile Professional.

• 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, it directly represents an hmenu already loaded in memory.

• 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 input panel (SIP).

Requirements