Golang GTK3 图形界面开发：gotk3 使用指南

gotk3 是 Go 语言绑定 GTK3 的工具库，允许开发者使用 Go 语言创建跨平台的图形界面应用程序。下面我将详细介绍 gotk3 的基本使用方法。

安装 gotk3

首先需要安装 gotk3 及其依赖：

# 安装 GTK3 开发库 (Ubuntu/Debian)
sudo apt-get install libgtk-3-dev

# 安装 gotk3
go get github.com/gotk3/gotk3/gtk

基础示例：创建窗口

package main

import (
	"log"
	"github.com/gotk3/gotk3/gtk"
)

func main() {
	// 初始化 GTK
	gtk.Init(nil)

	// 创建主窗口
	win, err := gtk.WindowNew(gtk.WINDOW_TOPLEVEL)
	if err != nil {
		log.Fatal("无法创建窗口:", err)
	}

	// 设置窗口属性
	win.SetTitle("GTK3 Go 示例")
	win.SetDefaultSize(400, 300)
	win.SetPosition(gtk.WIN_POS_CENTER)

	// 连接窗口关闭事件
	win.Connect("destroy", func() {
		gtk.MainQuit()
	})

	// 创建按钮
	btn, err := gtk.ButtonNewWithLabel("点击我")
	if err != nil {
		log.Fatal("无法创建按钮:", err)
	}

	// 连接按钮点击事件
	btn.Connect("clicked", func() {
		dialog := gtk.MessageDialogNew(
			win,
			gtk.DIALOG_MODAL,
			gtk.MESSAGE_INFO,
			gtk.BUTTONS_OK,
			"按钮被点击了!",
		)
		dialog.Run()
		dialog.Destroy()
	})

	// 将按钮添加到窗口
	win.Add(btn)

	// 显示所有控件
	win.ShowAll()

	// 进入 GTK 主循环
	gtk.Main()
}

常用组件示例

1. 布局容器

// 创建垂直布局
box, _ := gtk.BoxNew(gtk.ORIENTATION_VERTICAL, 6)

// 创建水平布局
hbox, _ := gtk.BoxNew(gtk.ORIENTATION_HORIZONTAL, 6)

// 创建网格布局
grid, _ := gtk.GridNew()
grid.SetRowSpacing(6)
grid.SetColumnSpacing(6)

2. 输入控件

// 创建文本框
entry, _ := gtk.EntryNew()
entry.SetPlaceholderText("请输入内容")

// 创建多行文本框
textView, _ := gtk.TextViewNew()
buffer, _ := textView.GetBuffer()
buffer.SetText("多行文本内容")

// 创建复选框
check, _ := gtk.CheckButtonNewWithLabel("选项")
check.SetActive(true) // 设置为选中状态

3. 列表控件

// 创建列表存储
listStore, _ := gtk.ListStoreNew(glib.TYPE_STRING, glib.TYPE_INT)

// 添加数据
iter := listStore.Append()
listStore.Set(iter, []int{0, 1}, []interface{}{"项目1", 100})

// 创建树视图
treeView, _ := gtk.TreeViewNewWithModel(listStore)

// 添加列
renderer, _ := gtk.CellRendererTextNew()
col1, _ := gtk.TreeViewColumnNewWithAttribute("名称", renderer, "text", 0)
col2, _ := gtk.TreeViewColumnNewWithAttribute("值", renderer, "text", 1)
treeView.AppendColumn(col1)
treeView.AppendColumn(col2)

信号处理

gotk3 使用 Connect 方法连接信号：

button.Connect("clicked", func() {
    fmt.Println("按钮被点击")
})

entry.Connect("changed", func() {
    text, _ := entry.GetText()
    fmt.Println("输入内容:", text)
})

window.Connect("key-press-event", func(win *gtk.Window, ev *gdk.Event) {
    keyEvent := &gdk.EventKey{ev}
    if keyEvent.KeyVal() == gdk.KEY_Escape {
        win.Close()
    }
})

完整应用示例

package main

import (
	"fmt"
	"log"
	"github.com/gotk3/gotk3/gtk"
)

func main() {
	gtk.Init(nil)

	// 创建主窗口
	win, err := gtk.WindowNew(gtk.WINDOW_TOPLEVEL)
	if err != nil {
		log.Fatal("无法创建窗口:", err)
	}
	win.SetTitle("GTK3 完整示例")
	win.SetDefaultSize(400, 300)
	win.Connect("destroy", gtk.MainQuit)

	// 创建垂直布局
	vbox, _ := gtk.BoxNew(gtk.ORIENTATION_VERTICAL, 6)
	vbox.SetMarginTop(12)
	vbox.SetMarginBottom(12)
	vbox.SetMarginStart(12)
	vbox.SetMarginEnd(12)

	// 添加标签
	label, _ := gtk.LabelNew("欢迎使用 GTK3 Go 绑定")
	vbox.Add(label)

	// 添加输入框
	entry, _ := gtk.EntryNew()
	entry.SetPlaceholderText("输入内容...")
	vbox.Add(entry)

	// 添加按钮
	btn, _ := gtk.ButtonNewWithLabel("提交")
	btn.Connect("clicked", func() {
		text, _ := entry.GetText()
		label.SetText("你输入了: " + text)
	})
	vbox.Add(btn)

	// 添加复选框
	check, _ := gtk.CheckButtonNewWithLabel("启用高级选项")
	vbox.Add(check)

	// 将布局添加到窗口
	win.Add(vbox)

	// 显示所有控件
	win.ShowAll()

	// 进入主循环
	gtk.Main()
}

注意事项

1. GTK 操作必须在主线程执行
2. 所有 GTK 调用应该在 gtk.Init() 之后
3. 使用 gtk.Main() 启动主循环
4. 内存管理由 GTK 自动处理，通常不需要手动释放资源

gotk3 提供了完整的 GTK3 功能绑定，可以创建复杂的图形界面应用程序。更多高级功能可以参考官方文档和示例代码。