BCGControlBar Pro for MFC
DWORD CBCGPMDIFrameWnd::GetMDITabsContextMenuAllowedItems ( )
inline

Returns a combination of flags that determines what context menu items are allowed for a context menu (for MDI Tabbed Groups only)

Returns
A combination of the following flags:
  • 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 groupRemarks

When MDI Tabbed Groups feature is enabled, there is a need to know what operations are allowed on tabs of a particular window. The function analyzes current layout of tabbed windows and returns a combination of flags that can be used to build a context menu, for example.

  • A new vertical tab group can be created when all tabbed windows aligned vertically, or there is only one tabbed window.
  • A new horizontal tab group can be created when all tabbed windows aligned horizontally, or there is only one tabbed window.
  • A tab can be moved to a previous group only if there is more than one tab in a tabbed window.
  • A tab can be moved to a next group only if there is more than one tab in a tabbed window.