v1.3.395

[twgh]

一、新增函数

// app
Init // 写出 xcgui.dll 到 windows 临时目录中 'xcgui+版本号+_编译时的目标架构+_CRC32' 文件夹里
InitOrExit // 写出 dll 出错会弹窗提示错误原因并退出程序

// widget
NewGifPlayer

// common
ExtractGifFrames
GetProcessName
GetProcessNameWithoutExt
BoolToString
StringToBool
BoolToInt

// xc
IsUiThread
CallUTAny // 调用界面线程, 可传任意类型参数
Auto // 自动判断是否在UI线程以决定是否调用界面线程来执行回调函数
AutoInt
AutoAny
DpiConvRound // 将 int32 类型的整数根据窗口 dpi 进行换算, 计算结果会四舍五入
XShapeGroupBox_GetText
XFrameWnd_GetDock
XPane_GetTabBar
XPane_GetSplitBar
XPane_GetButton
XPane_ShowButton
XTemp_Get
XBtn_ClearAnimation
XDraw_GetD2dBitmap

// wapi
CoInitializeEx
CoCreateInstance
AdjustWindowRect
SetWindowText
GetClientRect
SHCreateMemStream
GetAsyncKeyState
GetCurrentThreadId
SetCursor
GetWindowRect
CoTaskMemFree
GetModuleFileName
CreateRoundRectRgn
SetWindowRgn
IsOK // 检查 error 是否为 S_OK
IsOkOrPanic

// wnd
SetWindowRound

// wutil
IsKeyPressed // 判断按键是否按下
IsComboKey // 判断组合键是否按下

二、新增 WebView 组件, 可创建到炫彩窗口或元素

当前库中使用的 Webview2 运行时版本号是 140.0.3485.44.

高版本运行时是兼容低版本的，低版本运行时不用高版本的方法也没有问题。

下载或更新运行时，安装时要使用管理员权限运行。

		// 创建 webview 环境
        edg, err := edge.New(edge.Option{
                UserDataFolder: os.TempDir(),// 自己的软件应该在固定位置创建一个自己的目录, 而不是用临时目录
        })
        if err != nil {
                wapi.MessageBoxW(0, "创建 webview 环境失败: "+err.Error(), "错误", wapi.MB_OK|wapi.MB_IconError)
                os.Exit(1)
        }
        // 创建 webview 到窗口
        wv, err := edg.NewWebView(w.Handle, edge.WebViewOption{
			edge.WithFillParent(true),
        })
		// 导航到指定网页
		wv.Navigate("https://www.baidu.com")

更多例子可查看 xcgui-example 仓库。

WebView 问题合集

三、新增 AddEvent 的方式添加事件

此类方法事件回调函数可随意使用匿名函数, 且不用担心 Go 2000 个回调函数上限的限制

四、其他

1. 内置了 dll, 只需在 app.New 前使用 app.Init 或 app.InitOrExit 就无需再考虑 dll 如何携带了
2. 支持的最低 go 版本升级为 1.18
3. 界面库初始化时内部直接调用了 runtime.LockOSThread(), 无需手动调用了
4. 增加元素系统按键按下/弹起事件 Event_SYSKEYDOWN
5. 公开 wapi 包的 dll 模块, 方便自行调用未封装的 windows api
6. Event_MENU_SELECT1 的参数 nID 改为 int32 类型
7. 修改 XMsg_CreateEx 的前两个参数类型

---

This discussion was created from the release v1.3.395.