Ribbon设计器

立即下载BCGControlBar Professional Edition for MFC

设计器允许您轻松地为实际应用程序创建模型，它采用现有的 MFC 项目作为输入，并生成 Ribbon 元素的 XML 表示形式以及 RC 文件作为输出。当设计器部分的工作完成后，只需编译项目，运行并查看设计的功能区控件的运行情况。

本指南介绍了如何利用设计器工具。

先决条件

• 首先，您必须使用应用程序向导创建基于MFC或BCGControlBar Pro的应用程序，或者选择现有的(基于MFC或bcgpro的)应用程序。
• 应用程序必须是SDI或MDI，因为不能在对话框上创建Ribbon Control。
• 该设计器支持从Visual Studio 6.0到Visual Studio 2015的所有Visual Studio项目。
• 请注意如果您选择纯MFC项目，则需要执行从MFC迁移到BCGControlBar Pro的一些额外步骤。

启动设计器

运行BCGRibbonDesigner.exe应用程序，它为您提供打开现有项目或从最近的项目列表中打开项目的功能，选择所需的项目和环境就可以工作了!

对接窗口简介

• 工具箱——“工具箱”窗口包含Ribbon控件支持的Ribbon对象列表，这些对象可以在设计时放置在Ribbon上。
• Elements——Elements窗口包含在设计时已经放置在功能区上的对象树。
• Action——窗口列出了在当前上下文中要执行的一些可能的操作。
• TODO——“TODO”窗口包含为成功构建和运行项目而应对项目执行的操作列表。
• Properties——Properties窗口显示当前选定元素的属性列表。
• Ribbon bar——Ribbon Control设计界面。
• 状态栏——状态栏设计界面。

添加类别

一个可用的Ribbon控件必须包含至少一个类别，因此当开始设计过程时，您要做的第一件事就是添加一个类别。若要添加新类别，请从“工具箱”中选择“类别”对象，或单击“操作”窗口中的“Add Category”操作，或单击功能区控件的设计图面上调用上下文菜单，此操作将显示“Add Category”对话框。

• 名称——键入类别名称。
• 键——键入类别键提示。
• 图像——在这里，您有机会为Ribbon元素指定大小图像，这些图像将被添加到Category中，图像可以从包含在bmp或png文件中的图像列表中加载。设计器将图像列表分解为单个图像，稍后您将能够为单个Ribbon元素指定图像索引。

添加“类别”后，可以开始添加“面板”。

添加面板

若要添加面板，请从“工具箱”中选择“面板”对象，单击“操作”窗口中的链接，或通过在“类别”的设计图面上单击鼠标右键来调用上下文菜单，这个动作会出现Add Panel对话框。

• 名称——指定新的面板名称。
• 键——指定面板的键提示。
• 图像——允许为面板选择图像，此图像显示面板放置在QAT上。
• 使用启动按钮——如果您希望为面板分配启动按钮，请勾选此框。
• 工具提示——指定启动按钮工具提示。
• 描述——指定工具提示上显示的启动按钮描述。
• 键——指定启动按钮的键提示。
• 图像——选择将在QAT上添加启动按钮时显示的图像。
• ID——为启动按钮选择一个命令ID。

添加元素和设置属性

若要向Panel添加新元素，请在“工具箱”窗口中选择适当的元素，或通过在Panel的设计图面上单击鼠标右键来调用上下文菜单。在“设计器”中选择新添加的元素，并且可以在“属性”窗口中编辑其属性，您可以定义元素的标题、工具提示、工具提示描述、键提示、大小图像(如果合适)、宽度(用于组合框、编辑框、滑块)等等。

元素的图像可以从“Add Category”步骤中指定的图像列表中选择，也可以从单独的bmp, png或ico文件中加载。

注意，ID属性允许您从现有命令列表中选择元素的Command ID，或者指定一个新的Command ID。

选择新图像和编辑图像集合

您可以随时编辑图像集合，与当前类别相关联或在设计时替换元素的图像。

为此，选择一个与“Image”属性相关联的Element和下拉组合框。

现在您可以从列表中选择一个新图像，或者选择<edit…>，这个动作会弹出“Image Collection”对话框：

• 现在点击“添加…”按钮，从文件(bmp, png, ico)或其他图像集中添加图像。
• 单击“删除”，可从“图像集”中删除选中的图像。
• 单击“清除”可从“图像集”中删除所有图像。

 当填好类别和面板后，您可以设置QAT的初始状态，例如选择元素，在应用程序启动时将出现在QAT上。

设置QAT

单击设计器图面上的QAT箭头：

• 现在您可以在properties窗口中编辑QAT属性。
• Position属性指定QAT在应用程序启动时的位置——在Ribbon控件的下方或上方。
• 点击项目属性，弹出“Edit QAT Items”对话框：

您可以查看现有命令列表并将它们添加到Quick Access Toolbar列表，此列表中每个命令显示的复选框指示该命令是否在 QAT 上可见，或者可通过 QAT 的下拉按钮使用。

请注意，该命令不会显示在 Designer 中的 QAT 上。

当您完成设计过程，或者只是想查看设计的功能区的实际效果时，保存项目并执行几个步骤来设置应用程序功能区控件。

修改应用程序

设计器创建功能区控件布局的 XML 表示形式，生成带有图像集合的 png 文件，创建包含对生成文件的引用的 *.rc2，并将设计时创建的命令 ID 的定义添加到 resources.h 文件。此外，保存项目时，您可以选择将对 rc2 文件的引用添加到应用程序的 *.rc 文件中。

所有 Designer 的输出都位于 res\BCGSoft_ribbon 文件夹中。

如果您正在使用基于 BCGControlBar Pro 的项目，请执行以下步骤将您的应用程序与新设计的 Ribbon 控件连接：

在 CMainFrame 类中声明 Ribbon Control 对象：

CBCGPRibbonBar m_wndRibbonBar;

在CMainFrame::OnCreate中创建并初始化Ribbon控件：

if (!m_wndRibbonBar.Create(this))
{
return -1;
}
if (!m_wndRibbonBar.LoadFromXML(_T("IDR_BCGP_RIBBON_XML")))
{
return -1;
}