BCGControlBar 的使用方法

 

首先，你必须定义在注册表中存放你自定义数据的位置和你 需要什么样的自定义（鼠标、键盘、上下文菜单），为了做这些工作，在CMyApp::InitInstance 中设置注册表入口并初始化自定义管理器： 
SetRegistryBase (_T("Settings"));

// 初始化自定义管理器：
InitMouseManager();
InitContextMenuManager();
InitKeyboardManager();

如果你已经决定使用鼠标或上下文菜单的自定义功能，你必 须在鼠标自定义管理器中附加一个视图，或初始化上下文菜单。重载CBCGWorkspace::PreLoadState 行为： 
class CMyApp ....
{
...
virtual void PreLoadState();
...
};

void CMyApp::PreLoadState()
{
// 把鼠 标事件连接到特定 的视图 :
GetMouseManager()->AddView (iIdTestView, _T("Test view"), IDR_VIEW);

// 初始化上下文菜单：
GetContextMenuManager()->AddMenu (_T("Test menu"), idMenu); 
}

同时在 mainfrm.h 和 mainfrm.cpp 文件中 把 CMDIFrameWnd 变成 CBCGMDIFrameWnd ，（在 SDI 应用程序的情况下， 把 CFrameWnd 变成 CBCGPFrameWnd） 
把 CMDIChildWnd 变成 CBCGMDIChildWnd 
把 CToolbar 变成 CBCGPToolBar 并且添加一个内嵌菜单栏对象到你的 CMainFrame 类中： 
CBCGPMenuBar m_wndMenuBar; // 新的菜单栏
CBCGPToolBar m_wndToolBar; // 应用程序工具栏

在 CMainFrame::OnCreate() 行为中添加如下的行，以便使能菜单栏功能： 
// 创建菜单栏（替换标准菜单）：
if (!m_wndMenuBar.Create (this))
{
TRACE0("Failed to create menubar\n");
return -1; //创建失败
} 
m_wndMenuBar.SetBarStyle (m_wndMenuBar.GetBarStyle() |
CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_SIZE_DYNAMIC);

为了使能菜单栏停靠，你应当添加如下代码： 
m_wndMenuBar.EnableDocking (CBRS_ALIGN_ANY);
DockControlBar (&m_wndMenuBar);

重要之处： 你可以在应用程序中使用任何数目的CBCGToolBar 工具栏。所有的工具栏图像将被合并到一个位图文件中。 无论如何，仅仅有一个CBCGMenuBar 对象被使用。

为了使能 工具栏/菜单 的自定义，请作出如下改变：

添加 工具栏/菜单 自定义命令（比如，View | Customize...） 
实现 OnViewCustomize 行为。代码看起来如下： 
void CMainFrame::OnViewCustomize() 
{
// 创建一个自定义工具栏对话框：
CBCGToolbarCustomize* pDlgCust = new CBCGToolbarCustomize (this, 
TRUE /* Automatic menus scaning */); 
// 添加预定义工具栏：
pDlgCust->AddToolBar ("Main", IDR_MAINFRAME);
....

// 添加用户自定义命令：
pDlgCust->AddButton ("User", CBCGToolbarButton (ID_USER_TOOL1, 1, "User Tool 1", TRUE));
pDlgCust->AddButton ("User", CBCGToolbarButton (ID_USER_TOOL2, 2, "User Tool 2", TRUE));
pDlgCust->AddButton ("User", CBCGToolbarButton (ID_USER_TOOL3, 3, "User Tool 3", TRUE));
....

pDlgCust->SetUserCategory ("User");

// 使能用户自定义工具栏的 Create/Delete ：
pDlgCust->EnableUserDefinedToolbars ();

pDlgCust->Create ();
}

为了使能 Microsoft?Office 2000 菜单：

定义你自己的基本命令集合（通常在CMainFrame::OnCreate()中）： 
CList lstBasicCoomads;

lstBasicCoomads.AddTail (ID_FILE_NEW);
lstBasicCoomads.AddTail (ID_FILE_OPEN);
lstBasicCoomads.AddTail (ID_FILE_SAVE);

......
lstBasicCoomads.AddTail (ID_APP_ABOUT);

CBCGToolBar::SetBasicCommands (lstBasicCoomads);

这些命令将显示在下拉菜单中： 
为了使能菜单阴影：

CBCGMenuBar::EnableMenuShadows (BOOL bEnable = TRUE)

注意 如果你查看的内容可能动态改变就不要在弹出式菜单中使用菜单 阴影（比如，视图显示动画、HTML页）在这种情况下，菜单阴影 会记忆以前的视图图像。

为了在运行时改变菜单字体：

CBCGMenuBar::SetMenuFont (LPLOGFONT lpLogFont, BOOL bHorz = TRUE);

为了使能“页面”（自定义）按钮，只需要调用：

m_wndToolBar.EnableCustomizeButton (TRUE, id_of_customize_command,
_T("Customize..."));

为了使能图像覆盖下的文字：

m_wndToolBar.EnableTextLabels (BOOL bEnable = TRUE);

为了使能用户自定义工具：

添加一个新的菜单条目：ID_TOOLS_ENTRY。该条目将 自动被实际存在的工具列表取代。 
添加如下的条目到 STRING 资源：

ID_TOOL1 "Activates user-defined tool\nUser Tool" 
ID_TOOL2 "Activates user-defined tool\nUser Tool"
.... 
ID_TOOLx "Activates user-defined tool\nUser Tool"

在应用程序的InitInstance() 中调用：
EnableUserTools (ID_TOOLS_ENTRY, ID_TOOL1, ID_TOOLx);

一个 "Tools" 新页面将加入到自定义对话框中 
为了使能动态可裁剪菜单：

在 STRING 资源表中保留部分条目。这些标识符将被当作控制栏标识符使用。

ID_TEAR_OFF1 "" 
ID_TEAR_OFF2 "" 
....... 
ID_TEAR_OFFx ""

对于每一个可裁剪弹出式菜单，把 "Break" 属性改位 "Bar" (MF_MENUBARBREAK) 
在应用程序的 InitInstance() 中调用：
EnableTearOffMenus (_T("RegBase", ID_TEAR_OFF1, ID_TEAR_OFFx);

为了使能静态可裁剪菜单

在 STRING 资源表中保留一个条目。这个标识符将区别于动态 可裁剪 标识符（如上所述）。

ID_TEAR_OFF_BAR ""

在主框架的 OnShowPopupMenu，为特定的菜单按钮使能可裁剪：
pMenuButton->SetTearOff (D_TEAR_OFF_BAR);