CBCGPPopupMenu

Detailed Description

The CBCGPPopupMenu class provides the functionality of Windows popup menus and extends it by supporting animations, tear-off, full customization, tool tips, rarely used commands, scrolling and loading/saving its state.

Usually, CBCGPPopupMenu objects are created and handled by BCGControlBar Library framework. If you need to display a popup menu, just construct a CBCGPPopupMenu object on the heap and call the CBCGPPopupMenu::Create member function.

See also

CBCGPPopupMenuBar

Inheritance diagram for CBCGPPopupMenu:

Public Types
enum	ANIMATION_TYPE

Public Member Functions
	CBCGPPopupMenu	Constructs a CBCGPPopupMenu object.
	CheckArea	Determines which popup menu item is at a specified position.
	Create	Creates a popup menu and attaches it to a CBCGPPopupMenu object.
	EnableMenuLogo	Allows to display the popup menu's logo.
	EnableResize	Enables the menu vertical and horizontal resizing.
	EnableVertResize	Enables the menu vertical resizing.
	GetHMenu	Returns a handle to a Windows menu.
	GetMenuBar	Returns a pointer to a menu bar object.
	GetMenuItem	Provides access to a popup menu item.
	GetMenuItemCount	Determines the number of items in a pop-up menu.
	GetMessageWnd	Returns a pointer to window that receives the popup menu commands.
	GetParentButton	Returns a pointer to a parent toolbar menu button.
	GetParentPopupMenu	Returns a pointer to a parent popup menu object.
	GetParentToolBar	Returns a pointer to a parent toolbar object.
	GetSelItem	Returns a pointer to the currently selected item (menu button).
	HideRarelyUsedCommands	Returns nonzero if the popup menu is able to hide the rarely used commands.
	InsertItem	Inserts a new menu item at the specified position, moving other items down the menu.
	InsertSeparator	Inserts separator at the specified position.
	IsCustomizePane	Indicates whether the popup menu is working as a QuickCustomizePane.
	IsIdle	Determines whether a popup menu is currently in idle mode.
	IsQuickCustomize	Determines whether a CBCGPToolbarMenuButton is in QuickCustomize mode.
	IsResizeble	Tells whether the popup menu is resizeble.
	IsRightAlign	Tells whether the menu is aligned right or left.
	IsShown	Tells whether a popup menu is visible or not.
	RemoveAllItems	Removes all the items from a popup menu.
	RemoveItem	Removes an item from a popup menu.
	SetDefaultItem	Specifies the command ID of a menu item to set as default.
	SetMaxWidth	Sets the maximum width, in pixels, for a popup menu bar.
	SetRightAlign	Sets the menu alignment.
	ShowAllCommands	Forces the popup menu to display all its items.
	UpdateShadow	Updates the menu shadow.

Static Public Member Functions
	AlwaysShowEmptyToolsEntry	Enables or disables ability to show empty entries for user-defined tools.
	EnableMenuSound	Enables or disables menu sound.
	GetActiveMenu	Returns a current active popup menu.
	GetAnimationSpeed	Returns a popup menu animation time-out value, in milliseconds.
	GetAnimationType	Returns the current type of popup menu animation.
	GetForceMenuFocus	Tells whether the applications is in the mode when the input focus is returned to the menu bar.
	IsSendMenuSelectMsg	Tells whether the framework sends WM_MENUSELECT message to parent frame.
	IsTopmost	Tells whether all popup menus should be created with WS_EX_TOPMOST style.
	SetAnimationSpeed	Sets a popup menu's animation speed.
	SetAnimationType	Sets the new animation type.
	SetForceMenuFocus	Forces a mode when the input focus is returned to the menu bar when a popup menu is displayed.
	SetForceShadow	Forces menu shadows to appear when menus are dropped outside the main frame window.
	SetSendMenuSelectMsg	Sets a flag that tells the framework whether to send the WM_MENUSELECT message to parent frame.
	SetTopmost	Specifies whether all popup menus should be created with WS_EX_TOPMOST style.
	UpdateAllShadows	Updates shadows for all opened popup menus.