GoQt 项目教程

1. 项目目录结构及介绍

GoQt 是一个使用 Go 语言和 Qt 框架进行 GUI 开发的工具包。以下是 GoQt 项目的目录结构及其介绍：

goqt/
├── examples/
│   ├── calculator/
│   ├── hello/
│   └── ...
├── lib/
│   ├── qtdrv/
│   └── ...
├── qt/
│   ├── core/
│   ├── gui/
│   ├── widgets/
│   └── ...
├── README.md
├── LICENSE
└── main.go

目录结构说明

• examples/: 包含多个示例项目，展示了如何使用 GoQt 进行 GUI 开发。每个子目录对应一个示例项目。
• lib/: 包含 GoQt 的核心库文件，其中 qtdrv/ 目录包含了与 Qt 驱动相关的代码。
• qt/: 包含与 Qt 框架相关的 Go 语言绑定代码，分为 core/, gui/, widgets/ 等子目录，分别对应 Qt 的核心模块、GUI 模块和控件模块。
• README.md: 项目的介绍文件，包含项目的基本信息、安装方法和使用说明。
• LICENSE: 项目的开源许可证文件。
• main.go: 项目的启动文件，包含了项目的入口函数。

2. 项目启动文件介绍

main.go 是 GoQt 项目的启动文件，包含了项目的入口函数。以下是 main.go 文件的简要介绍：

package main

import (
    "github.com/visualfc/goqt/ui"
)

func main() {
    ui.Run(func() {
        // 在这里编写你的 GUI 代码
        // 例如：创建窗口、添加控件等
    })
}

启动文件说明

• package main: 定义了包名为 main，表示这是一个可执行程序的入口文件。
• import: 导入了 github.com/visualfc/goqt/ui 包，这是 GoQt 的核心包，提供了与 Qt 框架交互的接口。
• func main(): 项目的入口函数，程序从这里开始执行。
• ui.Run(func() {}): 调用 ui.Run 函数启动 Qt 应用程序，并在传入的匿名函数中编写 GUI 代码。

3. 项目的配置文件介绍

GoQt 项目本身没有传统的配置文件（如 .ini, .yaml 等），但可以通过环境变量或命令行参数来配置项目的行为。以下是一些常见的配置方式：

环境变量配置

• QT_PLUGIN_PATH: 设置 Qt 插件的路径，例如：

  export QT_PLUGIN_PATH=/path/to/qt/plugins
  

• QT_QPA_PLATFORM: 设置 Qt 的平台插件，例如：

  export QT_QPA_PLATFORM=xcb
  

命令行参数配置

• -style: 设置应用程序的样式，例如：

  go run main.go -style=fusion
  

• -platform: 设置应用程序的平台，例如：

  go run main.go -platform=xcb
  

示例

以下是一个使用环境变量和命令行参数配置的示例：

export QT_PLUGIN_PATH=/path/to/qt/plugins
go run main.go -style=fusion -platform=xcb

通过这些配置方式，可以灵活地调整 GoQt 应用程序的行为和外观。