Ribbon Bar

新的全局变量 globalData.m_sizeRibbonCategoryPadding 和 globalData.m_sizeRibbonPanelPadding 允许指定 Ribbon 选项卡和面板内部填充。您必须在创建 Ribbon 栏之前更改它们。

CBCGPribbonSlider：添加了水平滑块文本标签支持（见截图）。一种新方法 SetTextExt 允许在控件右侧指定标签。

改进的 Ribbon 命令搜索：搜索框现在可以位于 Ribbon 选项卡的右侧（默认）或 Ribbon 标题（在完整模式和紧凑模式下）（见屏幕截图）。请注意，如果搜索框位于标题上，则不会显示 Ribbon 上下文标题（如在 MS Office 2022 中）。 CBCGPribbonCommandSearchOptions 结构具有以下新成员：

• m_Location - 指定搜索框位置。

• m_Icon - 搜索框图标：灯泡或放大镜。

• m_clrHighlighted - 搜索结果菜单中突出显示的文本的背景颜色。

• m_clrHighlightedText - 突出显示文本的前景色。 

由于搜索框现在可以位于框架上，因此您可以为非基于功能区的应用程序启用它（启用框架标题栏的基于工具栏/菜单的应用程序）。对于这种应用程序，框架会扫描所有工具栏和菜单栏以寻找最佳匹配，并在下拉菜单中显示搜索结果。您可以通过覆盖 CBCGPFrameWnd 或 CBCGPMDIFrameWnd 派生类中的新虚拟方法 QueryElements 来自定义此搜索。请查看 BCGPMSOfficeDemo、BCGPVisualStudioGUIDemo 和 FrameCaptionDemo 示例和示例，了解此功能的实际应用。

CBCGPribbonEdit：新的虚拟方法 OnDrawIcon 允许在搜索模式下绘制自定义图标。

Ribbon Designer：添加了以下新属性：

• 组合框中下拉列表的高度。

• 滑块控件的扩展（右侧）文本。

• 命令搜索选项。

工具栏和菜单

改进了某些视觉主题中禁用的组合框的外观。

CBCGPPopupMenu：添加了突出显示（标记）的文本支持。调用新的静态方法 CBCGPPopupMenu::SetHighlightedText 来指定要突出显示的单词列表。

CBCGPToolbarButton：添加了 2 个新的虚拟方法 QueryElements 和 AddToSearchResults；在 CBCGPToolbarButton 派生类中覆盖它们以自定义命令搜索（在框架标题栏中可用）。

对话框和表单

CBCGPMessageBox：改进的窗口布局。宽/高比现在更接近原生 Windows 消息框。

CBCGPDlgPopupMenu：无需菜单按钮或功能区按钮等任何相应控件即可创建弹出对话框；此版本中添加了一个新的构造函数“CBCGPDlgPopupMenu(CRuntimeClass* pRTI, LPCTSTR lpszTemplateName)”。

网格和报告控件

CBCGPGridColorItem：实现了自定义颜色序列化（复制或移动后单元格不再丢失颜色）。

CBCGPGridDateTimeItem：添加了 CBCGPDateTimeCtrl::DTM_CHECKBOX 标志支持。可以使用可选复选框创建网格日期/时间单元格（参见屏幕截图）。虽然数据/时间选择器处于未选中状态，但 CBCGPGridDateTimeItem 显示空值标签。请在 CBCGPGridDateTimeItem 的构造函数中查看一个新的可选参数 (LPCTSTR lpszNoDateLabel)。 CBCGPGridDateTimeItem 类中添加了以下新成员：m_bIsChecked、m_strNoDateLabel。

BCGP_GRID_FILTERBAR_OPTIONS：如果 m_clrMarkBackground 或 m_clrMarkText 为 CLR_DEFAULT，则使用默认（基于视觉主题，由 CBCGPVisualManager::GetMarkedTextColor 返回）颜色来显示搜索结果。

CBCGPGridCtrl::GetVirtualRow 方法现在是虚拟的。

控件

CBCGPListBox：可以在标题中添加一个图标。

CBCGPListBox：AddCaption 和 AddSeparator 方法返回添加行的索引。

CBCGPStatic：实现了 2 个新版本的 SetPicture 方法。首先接收 HBITMAP，然后接收 - CBCGPSVGImage。

杂项

CBCGPChartAxis：调整带的大小现在是 DPI 感知的。

CBCGPGlobalUtils::DrawTextWithHighlightedArea：添加了多行文本支持。

CBCGPPropertyManager：实现了自定义颜色（CBCGPColorProp 类）和复选框（CBCGPDateTimeProp 类）的存储/加载。

CBCGPSVGImage：GetSize 方法有一个新的可选参数“BOOL bCheckBounds”（默认为 FALSE）。如果此参数为 TRUE 且 SVG 没有指定大小，则将返回边界矩形的大小。

CBCGPTabWnd：改进了带下划线的标签动画。

CBCGPTagManager：一种新方法 ParseColorArray 将带有颜色值的字符串转换为 COLORREF 值数组。

CBCGPVisualContainer：新方法 SetScrollOffset 指定视觉容器的滚动偏移量。 

演示和示例

BCGPControls：添加了自定义颜色集的颜色属性（见截图）。

BCGPGridExample：改进了一些自定义网格单元格的复制/粘贴（“单元格类型”视图）。

BCGPMSOfficeDemo：添加了命令搜索演示：在 MS Office 2019 主题中，命令搜索出现在功能区标题上并且可以最小化（如在 MS Office 2022 应用程序中）（见屏幕截图）。

BCGPVisualStudioGUIDemo：添加了命令搜索演示（见截图）。

FrameCaptionDemo：添加命令搜索演示。

SVGViewDemo：CSVGPreview 显示没有预定义大小的文件，MDI 选项卡工具提示包含 .SVG 文件的完整路径。 

修复

• CBCGPRibbonEdit::EnableSearchMode：对于没有编辑框的组合框（CBCGPribbonEdit-derived）不再允许搜索模式。

• 解决了焦点位于只读编辑控件上时键盘加速器的问题。

• CBCGPSVGImage：解决了使用径向和线性渐变绘制元素的一些问题。

• Ribbon 栏：解决了 Ribbon 栏处于自动隐藏模式时键盘导航的一些问题。

• CBCGPGridCtrl：解决了关键字导航和冻结行模式下鼠标滚动的一些问题。

• 本地化：解决了在某些组合框中显示不正确字符的问题，其中内容从本地化资源加载。

• CBCGPTabWnd：解决了选项卡控件无框时（在某些视觉主题中）不正确地重绘控件边缘的问题。

• CBCGPBaseTabWnd：解决了调用 EnableAutoColor 或 SetAutoColors 方法后标签区域高度不正确的问题（在某些视觉主题中）。

• CBCGPEditCtrl：左侧标记不再绘制在紧凑（自动隐藏）水平滚动条区域中。

• CBCGPRibbonBar：解决了功能区和功能区 QAT 自定义的一些问题。

• Visual Designer：解决了圆形仪表最小尺寸的问题。