Professional User Interface Suite, Copyright FOSS Software Inc. Help Published with Permission.

Also available in Prof-UIS Freeware

class CExtPopupMenuWnd :
public CExtPopupBaseWnd,
public CExtCustomizeSite::ICustomizeDropTarget,
public CExtCustomizeSite::ICustomizeDropSource

Remarks

The CExtPopupMenuWnd class implements a pop-up menu to which can be applied a variety of animation effects.

Header

ExtPopupMenuWnd.h

Articles

How to use pop-up menus in your application.

Constants

Animation effects (the e_animation_type_t enumeration)

Value Meaning
__AT_NONE No animation.
__AT_RANDOM Random animation .
__AT_ROLL Menu sliding from the right top corner.
__AT_SLIDE Menu sliding from the top.
__AT_FADE Menu gradually emerging out of shadow.
__AT_ROLL_AND_STRETCH Is the same as __AT_ROLL but scaling is used.
__AT_SLIDE_AND_STRETCH Is the same as __AT_SLIDE, but scaling is used.
__AT_NOISE Menu forming up out of pixels.
__AT_BOXES Menu forming up out of little squares.
__AT_CIRCLES Menu forming up out of little circles.
__AT_HOLES Operation opposite to that of __AT_CIRCLES.

Expand menu flags

Flags for dropdown menu positioning:

Value Meaning
TPMX_LEFTALIGN Left.
TPMX_CENTERALIGN Center.
TPMX_RIGHTALIGN Right.
TPMX_TOPALIGN Top.
TPMX_VCENTERALIGN Vertically center.
TPMX_BOTTOMALIGN Bottom.

Flags for combining the menu region with the window area in which the mouse is clicked that causes appearing the menu (for dropdowns menu only)

Value Meaning
TPMX_COMBINE_NONE Do not combine.
TPMX_COMBINE_ANY_SUITABLE Always combine.
TPMX_COMBINE_DEFAULT Combine if the corresponding style has been chosen.
TPMX_SELECT_ANY Highlight the first item in the menu.
TPMX_DO_MESSAGE_LOOP Do not quit the TrackPopupMenu function until closing the menu window.
TPMX_NO_HIDE_RARELY Display all the items without dividing them into frequently used and rarely used.
TPMX_NO_WM_COMMAND Do not send the WM_COMMAND message.
TPMX_NO_CMD_UI Ignore requests to update the menu by CMD UI.
TPMX_NO_SHADOWS No shadows.
TPMX_FORCE_NO_ANIMATION No animation when the menu appears on the screen.
TPMX_PALETTE Popup menu uses a palette layout.
TPMX_PALETTE_TB_BKGND Popup menu with the palette layout has a background like in the floating toolbar.
TPMX_TEAROFF Popup menu has a tear-off caption.
TPMX_NO_SITE Popup menu is not controlled by the global menu site. This flag allows you to display more than one pop-up menu simultaneously).
TPMX_RIBBON_MODE Popup menu is designed to be used with the ribbon page or ribbon bar.
TPMX_RIBBON_FILE_MENU Popup menu is designed to be used with the ribbon bar and indicates it is the File menu.
TPMX_RIBBON_OPTIONS_BUTTON Popup menu is designed to be used with the ribbon bar and indicates that the File menu has the Options button.
TPMX_RIBBON_EXIT_BUTTON Popup menu is designed to be used with the ribbon bar and indicates that the File menu has the Exit button.
TPMX_NO_FADE_OUT_ANIMATION Popup menu is designed to be used with the ribbon bar or ribbon page and disables the fade-out animation.
TPMX_NO_DYNAMIC_SHADOWS Disables the effect when you can see dynamic underlying contents through menu shadows.
TPMX_RIBBON_RESIZING Popup menu is designed to be used with the ribbon bar or ribbon page and indicates that the popup menu can be resized both horizontally and vertically.
TPMX_RIBBON_RESIZING_VERTICAL_ONLY Popup menu is designed to be used with the ribbon bar or ribbon page and indicates that the popup menu can be resized only vertically. Should be used together with TPMX_RIBBON_RESIZING.
TPMX_HIDE_KEYBOARD_ACCELERATORS Popup menu should not display keyboard accelerator texts near menu item captions. This flag is designed for context menu which often should display menu item texts without accelerator key information.

See Also

Class Members | Hierarchy Chart