### BCGControlBar 的使用方法
#### 安装与配置
**BCGControlBar** 是一个功能强大的用户界面控件库，专为 **Microsoft Visual C++** 设计，提供了丰富的自定义工具栏、菜单和对话框等界面组件，极大地提高了应用程序的可用性和美观度。
在开始使用 **BCGControlBar** 之前，首先需要完成库的安装和环境配置工作。以下步骤将详细介绍如何安装 **BCGControlBar** 并将其集成到您的项目中：
1. **下载并解压 BCGControlBar 库**
- 下载 **BCGControlBar.zip** 文件。
- 解压缩该文件到指定目录（例如 `c:\bcg`）。
2. **配置环境变量**
- 将 `c:\bcg\bin` 添加到系统 `PATH` 变量中。
- 在 Visual C++ 开发环境中打开 “工具” -> “选项”，定位到 “目录” 设置页面，并将 `c:\bcg\bcgcontrolbar` 添加到 “包含文件” 目录列表中。
- 同样地，将 `c:\bcg\bin` 和 `c:\bcg\lib` 添加到 “可执行文件” 目录列表中。
3. **配置项目**
- 在项目的预编译头文件（如 `stdafx.h`）中添加以下代码：
```cpp
#include "BCGCBProInc.h"
```
- 修改应用程序类，继承自 `CBCGPWorkspace` 类：
```cpp
class CMyApp : public CWinApp, public CBCGPWorkspace {
// ...
};
```
4. **初始化工作空间**
- 在应用程序类的 `InitInstance` 方法中调用以下函数来初始化鼠标管理器、上下文菜单管理器和键盘管理器：
```cpp
void InitMouseManager();
void InitContextMenuManager();
void InitKeyboardManager();
```
5. **加载状态**
- 实现 `PreLoadState` 方法以加载工作空间的状态：
```cpp
virtual void PreLoadState();
```
6. **设置主窗口**
- 修改主窗口类以使用特定的 **BCGControlBar** 类型：
```cpp
CMDIFrameWndEx : public CBCGMDIFrameWnd
CMDIChildWndEx : public CBCGMDIChildWnd
CToolBar : public CBCGToolBar
```
- 在 `CMainFrame::OnCreate` 方法中创建菜单栏和工具栏：
```cpp
if (!m_wndMenuBar.Create(this)) {
TRACE0("Failed to create menubar\n");
return -1; // 失败
}
m_wndMenuBar.SetBarStyle(m_wndMenuBar.GetBarStyle() | CBRS_TOOLTIPS | CBRS_...);
```
#### DLL 与静态库版本
**BCGControlBar** 提供了多种版本的动态链接库（DLL）和静态库，包括调试版本和发布版本。这些版本分别适用于不同的编译配置，可以根据项目的具体需求选择合适的版本进行编译和部署：
- **BCGCB***D.dll, **BCGCB***D.lib —— 调试版本的 DLL 和对应的导入库
- **BCGCB***.dll, **BCGCB***.lib —— 发布版本的 DLL 和对应的导入库
- **BCGCB***UD.dll, **BCGCB***UD.lib —— 调试版本的 Unicode 版本 DLL 和对应的导入库
- **BCGCB***U.dll, **BCGCB***U.lib —— 发布版本的 Unicode 版本 DLL 和对应的导入库
- **BCGCB***StaticD.lib, **BCGCB***StaticDS.lib —— 调试版本的静态库，支持 MFC 共享 DLL
- **BCGCB***Static.lib, **BCGCB***StaticS.lib —— 发布版本的静态库，支持 MFC 共享 DLL
- **BCGCB***StaticUD.lib, **BCGCB***StaticUDS.lib —— 调试版本的 Unicode 静态库，支持 MFC 共享 DLL
- **BCGCB***U.lib, **BCGCB***US.lib —— 发布版本的 Unicode 静态库，支持 MFC 共享 DLL
这些库文件通常位于 **\Bin** 目录下，需要将它们复制到系统的 **system32** 目录或其他适当的系统路径中以便于程序运行时能够正确加载。
#### 示例代码
为了帮助理解如何在实际项目中使用 **BCGControlBar**，下面提供了一段示例代码：
```cpp
// 在预编译头文件中包含必要的头文件
#include "BCGCBProInc.h"
// 应用程序类继承自 CBCGPWorkspace
class CMyApp : public CWinApp, public CBCGPWorkspace {
public:
virtual void PreLoadState() override;
};
// 初始化工作空间
void CMyApp::PreLoadState() {
// 注册视图 ID
GetMouseManager()->AddView(iIdTestView, _T("Testview"), IDR_VIEW);
// 添加菜单项
GetContextMenuManager()->AddMenu(_T("Testmenu"), idMenu);
}
// 主窗口类
class CMainFrame : public CMDIFrameWndEx {
public:
virtual int OnCreate(LPCREATESTRUCT lpCreateStruct) override;
protected:
CBCGPMenuBar m_wndMenuBar;
CBCGPToolBar m_wndToolBar;
};
int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct) {
// 创建菜单栏
if (!m_wndMenuBar.Create(this)) {
TRACE0("Failed to create menubar\n");
return -1; // 失败
}
// 设置菜单栏样式
m_wndMenuBar.SetBarStyle(m_wndMenuBar.GetBarStyle() | CBRS_TOOLTIPS | CBRS_...);
return 0;
}
```
通过以上步骤，您可以成功地安装并配置 **BCGControlBar** 库，并在其基础上开发出具有丰富用户界面的应用程序。希望这些信息对您有所帮助！
