乐于分享
好东西不私藏

VBAYYDS功能区编辑器 使用说明书260527

VBAYYDS功能区编辑器 使用说明书260527

VBAYYDS 功能区编辑器 — 使用说明
支持宿主:Microsoft Office 2007+、WPS Office Excel Wrod PPT完全支持
支持容器:Excel .xlam / .xlsm、Word .dotm / .docm、PowerPoint .ppam/ .pptm
文档版本:2026-05-25

文档型功能区 vs 加载项型功能区
自定义功能区写在Office正常文件以及加载项类型文件里,单文件发放到其他会出现「别人电脑上看不到 Tab」「换一台机器按钮没了」等问题。加载项形式的分发的用户机器上需要手动加载一次文档形式直接打开,请先分清两类载体:
概念
通俗理解
典型扩展名
+加载项型(全局)
安装/加载一次,在该 Office 程序里多份文档共用同一套功能区
Excel .xlam、Word .dotm、PPT 官方 .ppam
文档型(随文件)
功能区跟这一份工作簿/文档/演示稿走,拷文件即带走界面
Excel .xlsm、Word .docm、PowerPoint .pptm

快速入门(最常用操作)
以下流程假设你已安装 VBAYYDS 功能区编辑器。全程约2 分钟 可跑通第一个按钮。
2.1 打开容器并开始设计
开始菜单 输入 vbayyds 运行 VBAYYDS功能区编辑器。

文件 → 打开,选择 .xlam / .xlsm(或 Word/PPT 对应格式);或将文件拖入窗口。

没有现成文件时:文件 → 另存为 或 另存为(桌面),类型选 .xlam(Excel 插件)等。
在预览区左上角点击 +,添加第一个 选项卡(Tab)

从左侧控件箱拖一个 组(group) 到该 Tab 下。

当然默认情况下  也都是可以
2.2 快速添加按钮
方式 A:拖拽(推荐)
在控件箱选 button(按钮)
拖到中间节点导航树的目标 group 上,看到蓝色插入线后松开。
也可在预览区直接拖拽调整顺序。
方式 B:右键
在节点树中右键目标组 → 添加子控件 → button
方式 C:复制已有按钮
选中按钮 → Ctrl+C → 选中目标组 → Ctrl+V(编辑器自动处理 id 冲突)。
2.3 设置图标
选中按钮;右侧打开属性面板
点击 「换图标」
在弹出窗口选择来源 然后双击图标即可
标签页
用途
本项目
当前容器已导入的 PNG
默认图标
内置 Office 风格图标库,支持中文 / 拼音 / 英文搜索
自定义图标
从磁盘导入 PNG(自动透明化、安全重命名)

搜索或浏览 → 选中 → 应用;预览区立即刷新。
提示:图标会自动随容器保存,兼容 Office 与 WPS;无需手工解压文件或改资源关系。
WPS里常规自己换图标有灰色背景 这里都会全部自动处理
Office内置图标也可以在office和wps里通用 无需关心细节
2.4 指定宏(绑定 VBA)
两种常见需求:
A. 已有标准模块宏(推荐:「指定宏」)
在 VBE 中已写好无参过程,例如:
Public Sub 导出报表()    ' 业务代码End Sub
在属性面板 扩展回调区 下方找到 「指定宏」,输入宏名 导出报表(与模块中过程名一致)。
Ctrl+S 保存:编辑器会建立按钮与宏之间的绑定,并自动补齐需要的回调代码。

B. 尚无业务代码(生成空回调桩)
在 扩展回调区 找到 onAction,点击 「生成」
Ctrl+S 保存:自动注入带正确参数签名的空 Sub(如 button 为 control As IRibbonControl)。
在Excel里进入 VBE,在 mRibbonCallBack_ 模块中填写过程体。

区别:「指定宏」适合直接调用已有过程;「生成 onAction」适合先生成空过程再填写代码。二者不要混用同一按钮。
2.5 修改显示名称
要改什么
操作
用户看到的文字
属性面板 → 显示名称 → 输入新名称(预览区同步);也可以双击直接修改
内部 ID(影响 VBA 回调名)
工具栏/节点操作栏 → 「重命名」 → 输入友好 ID;不建议在属性面板直接改

重命名 id 时,编辑器会自动同步 tag、回调过程名映射,并在下次保存时更新 VBA 桩(only-add,不覆盖你已写的业务代码)。
重命名id有几种形式 点一下就会变一次 自己根据需要选择 一般定好了后不要随意修改 容易造成回调VBA代码失效
2.6 保存并在 Office 中验证
Ctrl+S(或工具栏「保存」)
段一:写入功能区界面与图标资源。
段二:扫描回调,仅新增缺失的 VBA 桩。
点击 「用 Office 打开」 或 「用 WPS 打开」,查看真实 Ribbon。
在宿主中点击按钮,确认宏执行正常。

主界面一览

区域
说明
顶部工具栏
打开、保存、另存为、Office/WPS 预览、撤销/重做
功能区预览
仿真 Ribbon;点击选中;可拖拽排序
底部页签
主页面(功能区)/ 右键设置 / XML 页面 / VBA 代码
控件箱
拖拽控件类型到节点导航
节点导航
控件树;搜索支持中文、拼音;可上移、下移、删除
属性面板
基本属性、外观行为、扩展回调、指定宏
状态栏
当前路径、保存与操作提示
控件类型与使用频率(由高到低)
4.1 极高频
button — 普通按钮
用途:点击执行宏,最常用。
常用属性:显示名称、图标大小、图标、onAction / 指定宏、简要提示。
注意:图标大小通常只对组内直接按钮有效。

group — 组
用途:Tab 下的分组框(带标题)。
常用属性:显示名称、ID。
注意:真正放按钮的是 group,不是 tab。
tab — 选项卡
用途:顶层页签。
常用属性:显示名称;进阶用户可设置插入位置。
4.2 高频
menu — 下拉菜单
用途:一个主按钮 + 下拉多项(如「插入 ▼」下列多个子操作)。
子控件buttonmenuSeparator 等放在 menu 内。
注意:菜单子项的图标大小规则与顶层不同;大图标通常设置在菜单本身。

splitButton — 分裂按钮
用途:主区域点击执行默认操作,小箭头展开菜单。
结构:编辑器会自动维护主按钮和下拉菜单的组合关系。

toggleButton — 切换按钮
用途:开/关状态(如「设计模式」)。
回调:切换类按钮的 onAction 会带按下状态参数。
separator / menuSeparator — 分隔线
用途:组内或菜单内视觉分组。
4.3 中频
checkBox — 复选框
用途:勾选状态;onAction 同样会带按下状态参数。
dropDown / comboBox — 下拉框 / 组合框
用途:从列表选择或输入;通常需要配置变化回调,并在 VBA 中维护条目列表。
gallery — 图库
用途:图标网格选择(样式、颜色库等);配置项较多,适合进阶用户。
Wps里不兼容 不能使用
editBox — 编辑框
用途:Ribbon 上直接输入文本,回车触发 onChange
由于在wps里编辑框显示效果极差 不建议使用 有输入场景减都用comboBox代替
4.4 低频(按需)
控件
说明
dynamicMenu
菜单项由 VBA 运行时生成,适合进阶动态菜单
labelControl
仅展示文字,无点击
box / buttonGroup
布局容器,精细排布多个按钮
dialogBoxLauncher
组右下角小箭头,打开任务窗格/对话框;每组最多一个,宜放组末尾
item
动态菜单内部条目类型
常用属性说明(由高到低)
5.1 显示与交互
属性项
说明
常用程度
显示名称
按钮、菜单或分组在功能区上显示的文字
★★★★★
图标
点击「换图标」选择项目图标或图标库
★★★★★
图标大小
大 / 小;常用于控制按钮在组内的显示尺寸
★★★★☆
简要提示
鼠标悬停时显示的标题提示
★★★★☆
详细提示
鼠标悬停时显示的补充说明
★★★☆☆
快捷键提示
按 Alt 后显示的快捷键字母
★★★☆☆
显示标签 / 显示图标
控制是否显示文字、是否显示图标
★★★☆☆
可见 / 启用
控制控件是否显示、是否可以点击
★★★☆☆

5.2 回调(动态行为)
属性项
说明
常用程度
onAction
点击按钮或确认操作时触发;面板中显示为英文回调名
★★★★★
指定宏
绑定已有无参 Public Sub;普通用户最常用
★★★★★
onChange
编辑框、下拉框内容变化时触发;面板中显示为英文回调名
★★★☆☆
启用 / 可见(动态控制)
进阶用:根据 VBA 运行结果控制是否可用、是否显示
★★★☆☆
图标 / 显示名称(动态控制)
进阶用:运行时改变图标或文字
★★☆☆☆
5.3 互斥规则(进阶 99%用户可无视
同一个属性不要同时设置固定值和动态控制。例如:
已设置「图标」时,不要再启用动态图标回调;需要动态图标时先清空图标。
已设置「显示名称」时,不要再启用动态名称回调。

5.4 布局与扩展
属性项
说明
常用程度
ID
控件唯一标识;建议通过「重命名」修改
★★★★☆
tag
自定义标记,供 VBA 读取;面板中显示为英文
★★☆☆☆
插入位置
进阶用:把自定义控件放在内置功能区控件前后
★★☆☆☆
进阶操作
操作
方法
撤销 / 重做
Ctrl+Z / Ctrl+Y(仅当前编辑会话内有效)
调整顺序
预览区拖拽、节点树 ↑↓、树内拖拽
复制分支
节点树 Ctrl+C / Ctrl+V
查看高级界面源码
底部 XML 页面(进阶用户使用)
查看 VBA 回调
底部 VBA 代码 页(只读预览,实际编辑仍在 VBE)

右键菜单设计(新手请无视)
底部页签切换到 「右键设置」
选择宿主内置位置(如 Excel 单元格右键 ContextMenuCell)。
添加 button / menu 等(类型子集比主功能区少)。
可将主功能区控件镜像拖入右键区(id 自动重分配,回调名可共用)。
右键菜单受 Office/WPS 支持情况影响,跨宿主导入时可能被自动调整。

布局包导出与导入
本功能一般不要使用 仅作为我个人开发测试
用于只迁移界面和图标,不迁移业务 VBA:
文件 → 导出布局:生成布局包 .zip。
文件 → 导入布局:先备份当前容器,再写入布局包内容并保存。
跨宿主(如 Excel → Word)导入时,编辑器会提示并处理不兼容项。

AI 自然语言设计功能区
这一章只讲使用方式:先打开编辑器和目标容器,再用自然语言说明你想要的功能区效果。你不需要关心内部命令、文件结构或底层实现。
9.1 使用前准备
准备项
怎么做
打开编辑器
打开 VBAYYDS 功能区编辑器,并载入目标 .xlsm / .xlam / .docm / .pptm
选中位置
在预览区或节点导航中选中要新增控件的组、菜单或按钮
说明需求
说清楚位置、控件类型、显示名称、图标风格、绑定宏
检查结果
看预览区和属性面板,不满意就继续用自然语言要求调整
保存验证
点击保存,再用 Office / WPS 打开验证真实功能区效果
9.2 推荐描述格式
推荐句式:在【位置】新增或修改【控件类型】,显示名称为【名称】,图标偏【风格】,绑定宏【宏名】。

9.3 常用自然语言示例
你的目标
可以这样说
批量新增按钮
在当前组新增 5 个按钮:导入、分析、导出、打印、设置,并绑定同名宏
修改已有按钮
把“导出”按钮图标换成保存图标,显示名称改成“导出报表”
制作下拉菜单
做一个“文件处理”下拉菜单,里面放保存、另存、关闭三个子按钮
调整顺序
把“打印”按钮移动到“导出”按钮后面,并保持大图标显示
右键菜单
在 Excel 单元格右键菜单里加一个“快速格式化”按钮,绑定宏 快速格式化
9.4 检查与微调
AI 完成后,重点检查预览区的控件顺序、属性面板里的显示名称、图标、图标大小、指定宏,以及 VBA 代码页是否有需要补充的业务代码。需要修改时,继续直接描述目标即可。

9.5 注意事项
注意项
建议
一次说清楚
尽量一次说明位置、名称、图标、宏名,减少反复修改
分批处理
大量按钮可按组分批描述,先完成一组再做下一组
涉及宏
已有业务宏时说清宏名;没有宏时可让编辑器先生成空回调,再补业务代码
重要文件
大改前先保存或另存一份,方便随时回退
常见问题
现象
处理
保存后 Office 看不到 Tab
完全退出 Office 再开;检查是否打开了另一个副本的容器
按钮点击报错 #449
切换按钮/复选框的宏参数与普通按钮不同;重新保存让编辑器校正回调
图标不显示
确认已通过「换图标」选择并保存;不要在 VBA 里另外加载 Ribbon 图标
WPS 无右键菜单
开启 WPS 兼容模式后重新保存
内置示例无法保存
示例只读 → 另存为到自己的工作目录再编辑
AI 建了一堆重复按钮
让 AI 先读取当前界面状态,再提交修改;不要连续重复同一个需求
附录 A:快捷键
快捷键
功能
Ctrl+S
保存(写入界面 + 注入 VBA 回调)
Ctrl+Z / Ctrl+Y
撤销 / 重做
Delete
删除选中节点
Ctrl+C / Ctrl+V
复制 / 粘贴节点
价格与福利政策
VBAYYDS 功能区编辑器作为生产力核武器,单体售价为400 
VBAYYDS语音编程助手 VIP600元 
已购买用户 可免费使用VBAYYDS 功能区编辑器
🎉特别福利:如果您已经是VBAYYDS 语音编程助手的 VIP 用户,即可享受免费升级获取该编辑器的特权!获取条件非常简单:您只需提交一篇关于 VBA 与本产品学习使用心得的分享文章,即可免费开通授权!如同下文

矿山老企业信息化转型 VBA自动化办公实例展示

2026-05-21

VBAYYDS 功能区编辑器 —— 降低开发门槛 100 倍。让每一个人,都能轻松成为 Office 功能区界面设计大师!
工具名称:VBAYYDS语音助手 +VBAYYDS功能区编辑器
适合人群:常用Excel且希望自动化操作但不想深学VBA的职场人
体验方式:下载地址vbayyds.com
✨ 让Excel听懂你的需求,或许只需要一次尝试。
✨ 你的时间,值得用在更值得的事情上。