如何为Gio UI设置窗口标题栏图标？

问题描述 #

使用Gio UI创建窗口时，仅能通过app.Title()设置标题，无法直接配置窗口标题栏图标，且发现图标需通过Windows资源清单加载，但使用go winres配置winres.json时找不到对应配置项。

当前创建窗口代码：

w := app.NewWindow(app.Title("My APP Title")) 

go winres的现有配置：

{
  "RT_GROUP_ICON": {
    "APP": {
      "0000": [
        "icon_64.png",
        "icon_48.png",
        "icon_32.png",
        "icon_16.png"
      ]
    },
    "OTHER": {
      "0000": "icon.png"
    },
    "#42": {
      "0409": "icon_EN.ico",
      "040C": "icon_FR.ico"
    }
  }
}

此外，Gio内部在Windows平台加载图标的相关逻辑位于gioui.org@v0.3.1的app/internal/windows/windows.go中：

func LoadImage(hInst syscall.Handle, res uint32, typ uint32, cx, cy int, fuload uint32) (syscall.Handle, error) {
    h, _, err := _LoadImage.Call(uintptr(hInst), uintptr(res), uintptr(typ), uintptr(cx), uintptr(cy), uintptr(fuload))
    if h == 0 {
        return 0, fmt.Errorf("LoadImageW failed: %v", err)
    }
    return syscall.Handle(h), nil
}

解决方案 #

Gio在Windows平台下默认会查找资源ID为1的组图标作为窗口标题栏图标，只需修改winres.json将主图标绑定到该ID即可：

1. 修改winres.json中的RT_GROUP_ICON配置，将原"APP"条目替换为"#1"（#前缀表示资源ID）：

{
  "RT_GROUP_ICON": {
    "#1": {
      "0000": [
        "icon_64.png",
        "icon_48.png",
        "icon_32.png",
        "icon_16.png"
      ]
    },
    "OTHER": {
      "0000": "icon.png"
    },
    "#42": {
      "0409": "icon_EN.ico",
      "040C": "icon_FR.ico"
    }
  }
}

2. 重新生成资源并编译程序：
   • 执行go-winres make生成Windows资源文件
   • 编译你的Gio应用（如需隐藏控制台窗口，可添加编译参数：go build -ldflags="-H windowsgui"）

编译完成后，Gio会自动加载ID为1的图标作为窗口标题栏图标。

内容的提问来源于stack exchange，提问作者Stefano Balzarotti