BCGSuite for MFC
CBCGPToolBox

Detailed Description

The CBCGPToolBox class implements the functionality of the shortcut (outlook) bar with pages containing only buttons with images.

To use toolbox control in your application either derive a class from CBCGPToolBox class or embed a CBCGPToolBox into your main frame object and call CBCGPToolBox::Create from CMainFrame::OnCreate. In resource editor create bitmaps for each page. Each bitmap should contain the number of images according to the number of buttons to be created for each page. Use CBCGPToolBox::AddToolsPage to add new pages. When user clicks a button the toolbox control sends the WM_COMMAND message to its owner.

See also
CBCGPDockingControlBar, CBCGPOutlookBar

Inherits CBCGPDockingControlBar.

Public Member Functions

 AddToolsPageAdds a new page to the toolbox control.
 
 AddToolsPageAdds a new page to the toolbox control.
 
 GetActivePageReturns the zero-based index of the active page.
 
 GetLastClickedToolRetrieves the currently selected tool on the specified page.
 
 GetNotifyCommandIDRetrieves the ID of the command that the toolbox sends when an item is clicked. If this ID is 0, the toolbox's ID is used for the notification.
 
 GetPageGiven the page number returns a pointer to page object.
 
 GetPageCountRetrieves toolbox page count.
 
 GetPageNumberGiven a pointer to a toolbox page object returns its zero-based index.
 
 GetTabWndReturns a pointer to underlined tabbed window of embedded outlook bar.
 
 IsShowDisabledItemsTells whether disabled toolbox items should be displayed.
 
 OnActivatePageCalled by the framework when the user activates a page.
 
 OnClickToolCalled by the framework when the user clicks a tool.
 
 OnShowToolboxMenuCalled by the framework when the toolbox context is about to be displayed.
 
 RemoveToolsPageRemoves a specific toolbox page.
 
 SetActivePageCall this method to activate a specific toolbox page.
 
 SetNotifyCommandIDSpecifies the ID of the command that the toolbox sends when an item is clicked. By default, this ID is the same as the toolbox's ID.
 
 SetShowDisabledItemsSpecifies whether disabled toolbox items should be displayed.