gform 项目技术文档

1. 安装指南

首先，确保您已经安装了Go语言环境，并配置了相应的构建环境。如果尚未安装Go，请参考以下链接进行安装：

确保您有一个工作的Go安装和构建环境，具体安装细节请访问以下页面：
http://golang.org/doc/install

安装完成后，使用以下命令获取和安装gform项目：

go get github.com/AllenDang/gform
go install github.com/AllenDang/gform

2. 项目使用说明

gform是一个易于使用的Windows GUI工具包，为Go语言提供两种创建用户界面的方法：

方法一：纯代码方式

通过以下步骤创建一个简单的UI界面：

gform.Init()

mainWindow := gform.NewForm(nil)
mainWindow.SetPos(300, 100)
mainWindow.SetSize(500, 300)
mainWindow.SetCaption("Controls Demo")

btn := gform.NewPushButton(mainWindow)
btn.SetPos(10, 10)
btn.OnLBUp().Bind(btn_onclick)

mainWindow.Show()
gform.RunMainLoop()

方法二：使用资源文件创建对话框

gform.Init()

dialog := gform.NewDialogFromResId(nil, 101) // 101是资源ID。
dialog.Center()
dialog.Show()

edt = gform.AttachEdit(dialog, 1000)
edt.SetCaption("Hello")

btn := gform.AttachPushButton(dialog, 2)
btn.OnLBDown().Attach(onclick)

gform.RunMainLoop()

3. 项目API使用文档

gform提供了两种处理事件的方法：

便捷事件处理器

这种类型的事件处理器遵循相同的命名约定，如OnSomething。

btn.OnLBUp().Bind(btn_onclick) // LB表示左键。
btn.OnMBUp // MB表示中键
btn.OnKillFocus
btn.OnDropFiles

如果为一个事件绑定两个方法，后绑定的事件处理器将覆盖先前的绑定。

原生Windows消息处理器

在GUI中处理各种Windows消息是一个常见的需求，gform为此提供了Bind方法，可以直接绑定一个事件处理器到一个原生Windows消息。

btn.Bind(w32.WM_CLIPBOARDUPDATE, btn_onClipboardUpdate)

func btn_onClipboardUpdate(arg *EventArg) {
    sender := arg.Sender()
    if data, ok := arg.Data().(*gform.RawMsg); ok {
        println(data.Hwnd, data.Msg, data.WParam, data.LParam)
    }
}

type RawMsg struct {
    Hwnd   w32.HWND
    Msg    uint
    WParam uintptr
    LParam uintptr
}

4. 项目安装方式

请参考安装指南部分，使用go get和go install命令进行安装。

---

感谢您使用gform项目，如果您有任何贡献（如设计、代码、文档、错误报告等），我们都非常欢迎。