Skip to content

HELP.md

Latest commit

 

History

History
614 lines (467 loc) · 13.7 KB

HELP.md

File metadata and controls

614 lines (467 loc) · 13.7 KB

VBA 可视化编辑器 - 帮助文档

目录

  1. 软件简介
  2. 界面说明
  3. 积木分类详解
  4. 基础操作
  5. 高级功能
  6. 快捷键
  7. 常见问题

软件简介

VBA 可视化编辑器是一款基于积木块编程的 VBA 代码生成工具。通过拖拽积木块并连接它们，您可以直观地构建程序逻辑，软件会自动生成对应的 VBA 代码。无需记忆复杂的语法，即可快速开发 Excel 自动化脚本。

主要特点

  • 可视化编程：拖拽积木块构建程序，直观易懂
  • 实时代码生成：操作即时反映到代码，所见即所得
  • 丰富的积木库：涵盖 VBA 开发的常用功能
  • 项目管理：支持保存、加载、导入导出项目
  • 代码高亮：生成的代码支持语法高亮显示

界面说明

整体布局

┌─────────────────────────────────────────────────────────────────┐
│                        标题栏                                     │
├──────────────┬────────────────────────────────┬─────────────────┤
│              │                                │                 │
│   积木工具箱  │           画布区域              │    右侧面板     │
│              │                                │                 │
│  - 收藏      │     [积木块]───[积木块]         │  - 属性面板     │
│  - 基础      │        │           │           │  - 代码预览     │
│  - 流程控制  │        └───[积木块]──┘           │  - 历史记录     │
│  - Excel操作 │                                │                 │
│  - 数据处理  │                                │                 │
│  - 交互      │                                │                 │
│  - 文件操作  │                                │                 │
│  - 高级      │                                │                 │
│              │                                │                 │
├──────────────┴────────────────────────────────┴─────────────────┤
│                        状态栏                                     │
└─────────────────────────────────────────────────────────────────┘

各区域功能

1. 积木工具箱（左侧）

积木工具箱包含所有可用的积木块，按功能分类组织：

  • 搜索框：快速查找积木
  • 收藏：您收藏的常用积木
  • 分类列表：点击展开/折叠分类
  • 积木项：显示积木名称、描述和颜色标识

2. 画布区域（中央）

画布是您构建程序的主要工作区：

  • 积木节点：显示积木名称和执行顺序编号
  • 连接线：显示积木之间的执行流程
  • 端口：节点上的连接点，用于连线

3. 右侧面板

右侧面板包含三个标签页：

  • 属性面板：编辑选中积木的属性
  • 代码预览：实时显示生成的 VBA 代码
  • 历史记录：操作历史，支持撤销/重做

4. 工具栏（画布顶部）

提供画布操作功能：

  • 布局：自动排列积木（层次布局/网格布局）
  • 缩放：放大/缩小/适应画布
  • 撤销/重做：操作历史管理
  • 清空：清除画布所有内容
  • 保存/加载：项目管理
  • 导入代码：从 VBA 代码生成积木

积木分类详解

1. 基础积木（紫色）

基础积木用于程序的基本构建。

变量声明

Dim 变量名 As 数据类型

声明一个变量，支持选择数据类型：

  • Variant（变体，默认）
  • Integer（整数）
  • Long（长整数）
  • Double（双精度浮点）
  • String（字符串）
  • Boolean（布尔值）
  • Date（日期）
  • Object（对象）

常量声明

Const 常量名 As 数据类型 = 值

声明一个不可改变的常量值。

赋值语句

变量名 = 值

给变量赋予新的值，支持表达式。

注释

' 注释内容

添加代码注释，不影响程序执行。

Debug.Print

Debug.Print 输出内容

在 VBA 立即窗口输出调试信息。

2. 流程控制积木（橙色）

控制程序的执行流程。

If 条件判断

If 条件 Then
    ' 条件为真时执行
End If

根据条件决定是否执行某段代码。

属性说明：

  • 条件：判断表达式，如 x > 10
  • Else If：可选的额外条件分支
  • Else：所有条件都不满足时执行

For 循环

For i = 起始值 To 结束值 Step 步长
    ' 循环体
Next i

按指定次数重复执行代码块。

属性说明：

  • 循环变量：计数器变量名
  • 起始值：循环开始值
  • 结束值：循环结束值
  • 步长：每次递增的值（默认为1）

For Each 循环

For Each 元素 In 集合
    ' 循环体
Next 元素

遍历集合中的每个元素。

Do While 循环

Do While 条件
    ' 循环体
Loop

当条件为真时持续执行循环。

Do Until 循环

Do Until 条件
    ' 循环体
Loop

持续执行循环直到条件为真。

Select Case

Select Case 表达式
    Case 值1
        ' 处理代码
    Case 值2
        ' 处理代码
    Case Else
        ' 默认处理
End Select

多分支选择结构。

Exit 语句

Exit For / Exit Do / Exit Sub / Exit Function

提前退出循环或过程。

3. Excel 操作积木（绿色）

操作 Excel 工作簿、工作表和单元格。

单元格读取

值 = Range("A1").Value
值 = Cells(1, 1).Value

读取单元格的值。

属性说明：

  • 引用方式：Range 或 Cells
  • 单元格地址：如 "A1" 或行列号

单元格写入

Range("A1").Value = 值

向单元格写入值。

区域选择

Range("A1:B10").Select

选择指定的单元格区域。

区域复制/粘贴

Range("A1").Copy Destination:=Range("B1")

复制单元格区域到目标位置。

工作表操作

Worksheets("Sheet1").Activate
Worksheets.Add
Worksheets("Sheet1").Delete

激活、添加、删除工作表。

工作簿操作

Workbooks.Open "文件路径"
ActiveWorkbook.Save
ActiveWorkbook.Close

打开、保存、关闭工作簿。

公式设置

Range("A1").Formula = "=SUM(B1:B10)"

设置单元格公式。

格式设置

Range("A1").Font.Bold = True
Range("A1").Interior.Color = RGB(255, 0, 0)

设置单元格字体、颜色等格式。

4. 数据处理积木（蓝色）

处理字符串、数字、日期等数据。

字符串连接

结果 = 字符串1 & 字符串2

连接两个或多个字符串。

字符串长度

长度 = Len(字符串)

获取字符串的字符数。

字符串截取

Left(字符串, 长度)   ' 从左边截取
Right(字符串, 长度)  ' 从右边截取
Mid(字符串, 开始位置, 长度)  ' 从中间截取

字符串查找

位置 = InStr(字符串, 查找内容)

查找子字符串在字符串中的位置。

字符串替换

新字符串 = Replace(原字符串, 查找内容, 替换内容)

大小写转换

UCase(字符串)  ' 转大写
LCase(字符串)  ' 转小写

数学运算

Abs(数值)      ' 绝对值
Sqr(数值)      ' 平方根
Round(数值, 小数位)  ' 四舍五入
Int(数值)      ' 取整

日期时间

Now()          ' 当前日期时间
Date()         ' 当前日期
Time()         ' 当前时间
DateAdd(间隔, 数量, 日期)  ' 日期加减
DateDiff(间隔, 日期1, 日期2)  ' 日期差

5. 交互积木（粉色）

与用户进行交互。

消息框 MsgBox

MsgBox "提示信息", vbInformation, "标题"

显示消息对话框。

按钮类型：

  • vbOKOnly - 仅确定按钮
  • vbOKCancel - 确定和取消
  • vbYesNo - 是和否
  • vbYesNoCancel - 是、否和取消

图标类型：

  • vbInformation - 信息图标
  • vbExclamation - 警告图标
  • vbCritical - 错误图标
  • vbQuestion - 问号图标

输入框 InputBox

输入值 = InputBox("提示信息", "标题", "默认值")

显示输入对话框，获取用户输入。

状态栏

Application.StatusBar = "状态信息"
Application.StatusBar = False  ' 恢复默认

设置或清除 Excel 状态栏信息。

6. 文件操作积木（紫色）

处理文件的读写和对话框。

文件对话框

文件路径 = Application.GetOpenFilename("Excel文件,*.xlsx")
文件路径 = Application.GetSaveAsFilename()

打开文件选择/保存对话框。

文件读写

' 读取文件
Open 文件路径 For Input As #1
Line Input #1, 行内容
Close #1

' 写入文件
Open 文件路径 For Output As #1
Print #1, 写入内容
Close #1

文件操作

FileCopy 源文件, 目标文件  ' 复制文件
Kill 文件路径              ' 删除文件
Name 旧名称 As 新名称      ' 重命名文件

检查文件/文件夹

Dir(文件路径)  ' 检查文件是否存在
MkDir 文件夹路径  ' 创建文件夹

7. 高级积木（红色）

高级功能和结构定义。

Sub 过程定义

Sub 过程名(参数)
    ' 过程代码
End Sub

定义一个 VBA 子过程。

Function 函数定义

Function 函数名(参数) As 返回类型
    ' 函数代码
    函数名 = 返回值
End Function

定义一个自定义函数。

错误处理

On Error GoTo 错误标签
' 正常代码
Exit Sub
错误标签:
    ' 错误处理代码

数组操作

Dim arr(1 To 10) As Integer  ' 声明数组
ReDim arr(1 To 20)           ' 重新定义数组大小
UBound(arr)                  ' 获取数组上限
LBound(arr)                  ' 获取数组下限

字典对象

Set dict = CreateObject("Scripting.Dictionary")
dict.Add "键", "值"
dict.Exists("键")
dict.Item("键")

基础操作

添加积木

  1. 在左侧工具箱中找到需要的积木
  2. 将积木拖拽到画布区域
  3. 松开鼠标完成添加

连接积木

  1. 将鼠标移动到积木节点上
  2. 节点周围会显示连接端口（小圆点）
  3. 从一个端口拖动到另一个端口
  4. 松开鼠标完成连接

端口说明：

  • 顶部端口：输入（程序流入）
  • 底部端口：输出（程序流出）
  • 左侧端口：数据输入
  • 右侧端口：数据输出

编辑积木属性

  1. 单击选中积木节点
  2. 在右侧属性面板中修改属性值
  3. 代码会实时更新

删除积木

  • 选中积木后按 Delete 键
  • 或右键菜单选择删除

删除连线

  • 选中连线后按 Delete 键
  • 或悬停在连线上点击删除按钮

修改连线

  1. 将鼠标悬停在连线上
  2. 连线两端会显示可拖动的箭头
  3. 拖动箭头到新的端口即可重新连接

移动积木

直接拖动积木节点到新位置。

收藏积木

点击积木右侧的星星图标，将其添加到收藏夹。

高级功能

自动布局

点击工具栏的「布局」按钮，选择：

  • 层次布局：按执行顺序从上到下排列
  • 网格布局：按网格蛇形排列

项目管理

保存项目

点击「保存」按钮，将项目保存为 .json 文件。

加载项目

点击「加载」按钮，打开之前保存的项目文件。

导入代码

点击「导入代码」按钮，将 VBA 代码转换为积木块。

撤销/重做

  • 点击工具栏的撤销/重做按钮
  • 或使用快捷键 Ctrl+Z / Ctrl+Y
  • 历史记录面板显示所有操作历史

代码映射

点击代码预览中的代码行，画布上对应的积木会高亮显示。

快捷键

快捷键 功能
Ctrl+Z 撤销
Ctrl+Y 重做
Ctrl+S 保存项目
Ctrl+C 复制选中积木
Ctrl+V 粘贴积木
Delete 删除选中项
Ctrl+A 全选
Ctrl+滚轮 缩放画布
鼠标拖拽空白 平移画布

常见问题

Q: 如何创建一个完整的 VBA 程序？

  1. 从「高级」分类拖入 Sub 过程定义 积木
  2. 在过程内部添加其他积木
  3. 在代码预览中查看完整代码
  4. 复制代码到 VBA 编辑器中使用

Q: 积木连接后代码顺序不对？

程序按照连接顺序执行。请确保：

  • 连线从上到下连接
  • 使用自动布局功能整理

Q: 如何使用循环？

  1. 拖入 For 循环 或 Do While 循环 积木
  2. 设置循环条件和变量
  3. 在循环积木内部添加要重复执行的积木

Q: 如何添加条件判断？

  1. 拖入 If 条件判断 积木
  2. 设置判断条件
  3. 在 If 内部添加条件满足时执行的积木
  4. 可选添加 Else 分支

Q: 生成的代码如何使用？

  1. 在代码预览面板查看生成的代码
  2. 点击复制按钮复制代码
  3. 打开 Excel，按 Alt+F11 打开 VBA 编辑器
  4. 粘贴代码到模块中

Q: 如何保存我的工作？

点击工具栏的「保存」按钮，项目会保存为 JSON 文件，下次可以通过「加载」按钮恢复。

Q: 支持哪些 Excel 版本？

生成的 VBA 代码兼容 Excel 2007 及以上版本。

技术支持

如有问题或建议，请访问项目主页提交 Issue。

最后更新：2026年3月