VBA-toolbox 开源项目教程

1. 项目的目录结构及介绍

VBA-toolbox 项目的目录结构如下：

VBA-toolbox/
├── LICENSE
├── README.md
├── src/
│   ├── modules/
│   │   ├── Module1.bas
│   │   ├── Module2.bas
│   │   └── ...
│   ├── classes/
│   │   ├── Class1.cls
│   │   ├── Class2.cls
│   │   └── ...
│   ├── forms/
│   │   ├── Form1.frm
│   │   ├── Form2.frm
│   │   └── ...
│   ├── thisworkbook.cls
│   └── workbook.cls
└── tests/
    ├── test_module1.bas
    ├── test_module2.bas
    └── ...

目录结构介绍

• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• src/: 源代码目录。
  • modules/: 包含项目的所有模块文件。
  • classes/: 包含项目的所有类文件。
  • forms/: 包含项目的所有表单文件。
  • thisworkbook.cls: 工作簿类文件。
  • workbook.cls: 工作簿类文件。
• tests/: 包含项目的测试文件。

2. 项目的启动文件介绍

项目的启动文件是 src/thisworkbook.cls。这个文件包含了项目的主要入口点和初始化代码。当打开工作簿时，这个文件中的代码会被自动执行。

启动文件内容示例

Option Explicit

Private Sub Workbook_Open()
    ' 初始化代码
    InitializeModules
    InitializeClasses
    InitializeForms
End Sub

Private Sub InitializeModules()
    ' 模块初始化代码
End Sub

Private Sub InitializeClasses()
    ' 类初始化代码
End Sub

Private Sub InitializeForms()
    ' 表单初始化代码
End Sub

3. 项目的配置文件介绍

项目的配置文件是 src/workbook.cls。这个文件包含了项目的配置信息和常量定义。

配置文件内容示例

Option Explicit

' 常量定义
Public Const MAX_ROWS As Integer = 1000
Public Const MAX_COLUMNS As Integer = 20

' 配置信息
Public Config As Object

Private Sub InitializeConfig()
    Set Config = CreateObject("Scripting.Dictionary")
    Config.Add "DatabasePath", "C:\path\to\database.accdb"
    Config.Add "LogFilePath", "C:\path\to\logfile.txt"
End Sub

通过这些配置信息，项目可以灵活地调整其行为和设置，而无需修改核心代码。