ARTICLE · 1399673
XML搭建EXCEL顶部工具栏保姆级教程第七期:让 Excel 按钮文字跟着下拉选项变化
前言 如果你只是想要快速搭建一个即点即用的EXCEL顶部工具栏,完全可以用杰瑞Ribbon设计器这个免费小工具,不需要理解复杂的XML语法,如下列文章所说: 01 杰瑞Ribbon设计器发布(致敬开发者)
02 杰瑞Ribbon设计器引入 JSA 宏代码
03 杰瑞Ribbon设计器适配 统信等国产系统

设计功能区的底层是XML语法,杰瑞Ribbon设计器是帮大家省去了麻烦。
本系列课程是把XML的语法拆开讲,并且每节课配上一个非常简单的上手实操案例,带着大家一步步入门XML,当然这并不意味着你需要再重走编写XML语法的老路,而是为了更加深刻地理解Ribbon选项卡的工作原理!
上一节课我们讲到这:第6课 让 Excel 功能区按钮读取下拉选项
01 杰瑞Ribbon设计器发布(致敬开发者)
02 杰瑞Ribbon设计器引入 JSA 宏代码
03 杰瑞Ribbon设计器适配 统信等国产系统

设计功能区的底层是XML语法,杰瑞Ribbon设计器是帮大家省去了麻烦。
本系列课程是把XML的语法拆开讲,并且每节课配上一个非常简单的上手实操案例,带着大家一步步入门XML,当然这并不意味着你需要再重走编写XML语法的老路,而是为了更加深刻地理解Ribbon选项卡的工作原理!
一、这节课要实现什么效果
在下拉框里选「灰色表头」,旁边的按钮马上变成「应用灰色表头」。再选「蓝色表头」,按钮就显示「应用蓝色表头」。这样,点击之前就能知道按钮会做什么。
本课用桌面版 Excel 和 Ribbon XML Editor v8.0,在第 6 课的 报表工具练习.xlsm 上继续操作。

二、动手修改 VBA 和 XML
下面开始实操。先准备 VBA,再修改 XML,最后重新打开工作簿,让功能区加载时能找到全部回调。
第一步,准备完整的 VBA 代码
在 Excel 打开 报表工具练习.xlsm,按Alt+F11。在左侧找到这个工作簿的 VBA 项目,打开第 6 课使用的标准模块。如果模块里全是课程代码,可以整段替换成下面的 VBA:
Option ExplicitPrivate selectedStyleId As StringPrivate reportRibbon As Office.IRibbonUIPublic Sub ReportRibbonOnLoad(ByVal ribbon As Office.IRibbonUI) Set reportRibbon = ribbonEnd SubPublic Sub SelectHeaderStyle(ByVal control As Office.IRibbonControl, _ ByVal selectedId As String, _ ByVal selectedIndex As Integer) selectedStyleId = selectedId If Not reportRibbon Is Nothing Then reportRibbon.InvalidateControl "btnApplyHeaderStyle" End IfEnd SubPublic Sub GetApplyHeaderStyleLabel(ByVal control As Office.IRibbonControl, _ ByRef returnedVal As Variant) Select Case selectedStyleId Case "styleBlue" returnedVal = "应用蓝色表头" Case "styleGray" returnedVal = "应用灰色表头" Case Else returnedVal = "应用" End SelectEnd SubPublic Sub ApplyHeaderStyle(ByVal control As Office.IRibbonControl) Select Case selectedStyleId Case "styleBlue" ApplyHeaderStyleToSelection RGB(189, 215, 238) Case "styleGray" ApplyHeaderStyleToSelection RGB(217, 217, 217) Case Else MsgBox "请先选择一种表头样式。", vbInformation End SelectEnd SubPrivate Sub ApplyHeaderStyleToSelection(ByVal fillColor As Long) Dim selectedCells As Excel.Range If Not TypeOf Application.Selection Is Excel.Range Then MsgBox "请先选择要设置格式的单元格。", vbInformation Exit Sub End If Set selectedCells = Application.Selection selectedCells.Font.Bold = True selectedCells.Interior.Color = fillColorEnd Sub
在上面的代码中,要看懂 ReportRibbonOnLoad 这个过程,里面的 ribbon 是 Excel 传入的对象参数,reportRibbon 是我们声明的变量。
Set 把对象引用保存下来。过程结束后,模块变量仍持有这个引用,后面才能调用 reportRibbon.InvalidateControl。每次改选时,会使用已经保存的引用。
第二步,修改 customUI14.xml
用 Ribbon XML Editor v8.0 打开练习簿,选底部右侧 customUI14.xml。用下面完整 XML 替换。
<?xml version="1.0" encoding="UTF-8"?><customUIxmlns="http://schemas.microsoft.com/office/2009/07/customui"onLoad="ReportRibbonOnLoad"><ribbon><tabs><tabid="tabReportTools"label="报表工具"insertAfterMso="TabHome"><groupid="grpFormatting"label="格式"><dropDownid="ddlHeaderStyle"label="表头样式"onAction="SelectHeaderStyle"><itemid="styleBlue"label="蓝色表头"/><itemid="styleGray"label="灰色表头"/></dropDown><buttonid="btnApplyHeaderStyle"getLabel="GetApplyHeaderStyleLabel"imageMso="FormatPainter"screentip="将所选样式应用到当前单元格选区"onAction="ApplyHeaderStyle"/><controlidMso="WrapText"/></group><groupid="grpCheck"label="检查"><boxid="boxCheckButtons"boxStyle="vertical"><buttonid="btnFindBlanks"label="查找空白"imageMso="FindDialogExcel"size="normal"screentip="检查选区中的空白单元格"/><buttonid="btnCheckSpelling"label="拼写检查"imageMso="Spelling"size="normal"screentip="检查工作表中的拼写"/></box></group></tab></tabs></ribbon></customUI>第三步,保存并重新加载功能区
按 F7 校验 → Ctrl+S 保存,关闭编辑器中的练习簿,再用 Excel 打开同一个文件。加载时 Excel 会按 onLoad 指定的名字调用 ReportRibbonOnLoad。需要显示按钮时,再调用文字回调,切换下拉框的时候,流程如下:

你改选样式后,VBA 先保存选择,再通知 Excel 重新获取按钮文字。Excel 取到新文字后更新界面。这一过程中,单元格格式会等到你点击「应用」才改变。
之前我们直接用 label="应用" 把文字直接写进了 XML。现在我们希望文字由程序根据选择来决定,因此这节课我们换成下面的写法:
getLabel="GetApplyHeaderStyleLabel"getLabel 是 RibbonX 规定的属性名。引号里的 GetApplyHeaderStyleLabel 是我们自己起的 VBA 过程名。Excel 需要这个按钮的文字时,会按这个名字找到过程,把过程输出的文字显示在按钮上。
这里的“回调”,就是 Excel 在特定时机调用你写好的 VBA 过程。把四个调用时机放到一起看,会更容易理解。
| XML 中的设置 | Excel 什么时候调用 | 本课的过程负责什么 |
|---|---|---|
onLoad | IRibbonUI 对象,供后面请求刷新。 | |
onAction | ||
getLabel | ||
onAction |
这里我们需要理解一个概念:为什么改了变量,还要调用 InvalidateControl?
Excel 会缓存属性回调的返回值。例如,取到一次「应用蓝色表头」后,可以继续使用这段文字。VBA 变量改成灰色后,需要调用 InvalidateControl 把目标按钮的属性缓存标记为失效。Excel 随后在更新界面时重新调用 getLabel,获取新文字。这个方法的参数是要刷新的控件 ID。
因此,改选后的顺序是先保存 selectedStyleId,再请求刷新。这样 Excel 下一次获取文字时,读到的就是最新选择。
三、验收文字和实际操作是否一致
在空白工作表给 A1:B1 输入「项目」「金额」,选中这两个单元格,打开 报表工具 → 格式,按下表验收。
| 操作 | 按钮应显示 | 单元格应发生什么 |
|---|---|---|

![]() | ![]() |
只要按照上面的步骤进行操作,你也能得到一个像我一样即点即用的工具栏

















































































