CBCGPOutlookBarPane

Detailed Description

The CBCGPOutlookBarPane class extends the functionality of CBCGPToolBar in the way that allows it to be inserted into outlook bar as a page.

CBCGPOutlookBarPane objects preserve the customization features of toolbars.

CBCGPOutlookBarPane has the following features:

• Add and remove buttons
• Set background image
• Set background color
• The buttons may be scrolled up and down

To use CBCGPOutlookBarPane in application you need the following:

• Create an instance of the CBCGPOutlookBarPane object
• Call Create().
• Setup the pane adding the buttons (call AddButton() method)
• Enable docking if you intend to make the pane detachable and dock it at another side of the main frame window.
• Add the pane to the outlook bar.

Example (error handling is skipped):

Copy

class CMainFrame : public CBCGPMDIFrameWnd

{

.....

CBCGPOutlookBar m_wndOutlookBar;

CBCGPOutlookBarPane m_wndOutlookPane;

......

};

// create the outlook bar:

m_wndOutlookBar.Create(_T("Shortcuts"), this, CRect(0, 0, 100, 100), ID_VIEW_OUTLOOKBAR, WS_CHILD | WS_VISIBLE | CBRS_LEFT);

// obtain the pointer to underlined outlook window

CBCGPOutlookWnd* pOutlookBar = (CBCGPOutlookWnd*) m_wndOutlookBar.GetUnderlinedWindow();

// create the outlook pane

m_wndOutlookPane.Create(&m_wndOutlookBar, dwDefaultToolbarStyle, ID_OUTLOOK_PANE_GENERAL, CBRS_BCGP_RESIZE);

// set main frame window as the owner to receive the commands from the pane

m_wndOutlookPane.SetOwner (this);

m_wndOutlookPane.EnableTextLabels();

// add buttons

m_wndOutlookPane.AddButton(theApp.LoadIcon (IDR_MAINFRAME), _T("About"), ID_APP_ABOUT);

m_wndOutlookPane.AddButton (theApp.LoadIcon (IDR_BCGCBDTYPE), _T("Open"), ID_FILE_OPEN);

// finally add the pane to the outlook bar

pOutlookBar->AddTab (&m_wndOutlookPane, "General", (UINT) -1, TRUE);