BCGControlBar Pro for MFC
virtual BOOL CBCGPMDIFrameWnd::OnShowMDITabContextMenu ( CPoint  point,
DWORD  dwAllowedItems,
BOOL  bTabDrop 
)
virtual

Called by the framework when a context menu should be displayed on one of the tabs (for MDI Tabbed Groups only).

Override this method in a CBCGPMDIFrameWnd - derived class.

It allows to display a popup menu when the user clicks on one of the tabs or drags and drops a tab on another tabbed groups.

NOTE. If you do not process OnShowMDITabContextMenu, the context menu won't be displayed. This function is generated by AppWizard when you enable MDI Tabbed Groups feature.

Parameters
pointcontains a point where to display the popup menu in screen coordinates
dwAllowedItemsa combination of flags which indicates what actions are allowed for the current tab:
  • BCGP_MDI_CREATE_VERT_GROUP: can create a new vertical tab group
  • BCGP_MDI_CREATE_HORZ_GROUP: can create a new horizontal tab group
  • BCGP_MDI_CAN_MOVE_PREV: can move a tab to the previous tab group
  • BCGP_MDI_CAN_MOVE_NEXT: can move a tab to the next tab group
  • BCGP_MDI_CAN_BE_DOCKED: relevant for tabbed documents only (switch a tabbed document to docked state).
bTabDropif TRUE, then the menu is displayed as a result of dragging and dropping the tab on another tabbed group. If FALSE, the menu displayed as a context menu on the currently activated tab. NOTE. If you do not process OnShowMDITabContextMenu, the context menu won't be displayed. This function is generated by AppWizard when you enable MDI Tabbed Groups feature.