How to open the application by left-clicking the application icon in the tray;

[victory-zz]

Description

The right-click setting menu item has been implemented, and the corresponding functions can be realized; I encountered a problem. No matter how to implement it, it seems that the function of opening the application by left-clicking the icon cannot be realized. The left-click menu item is displayed, which does not conform to the normal operation of the tray application.

To Reproduce

func Tray() *tray {
_tray.once.Do(func() {
waitUntilReady := make(chan struct{}) // wait until menus built completely
systray.Register(func() {
// load icons
assetHelper := utils.NewEmbedFS(icons, "configs/helper/webapp/images")
var ico []byte
appLog := types.GetAppcontext().GetCtxValueAsString(types.App_app_logo)
if appLog == "" || appLog == "null" {
ico, _ = assetHelper.GetFileBytes("icon_initial.ico")
} else {
ico, _ = assetHelper.GetFileBytes("icon.ico")
}

		/* setup tray icon and menus */

		// tray icon
		systray.SetTitle(app.App().GetAppName())
		systray.SetTemplateIcon(ico, ico)
		_tray.updateIconTooltip()

		// open window menu
		_tray.openWindow = menus.NewSingleItem(
			MenuIdOpenWindow, "打开应用",
		).SetTextUpdater(func(id string) (updateText string) {
			return "打开应用"
		})

		systray.AddSeparator()

		// copyright menu
		_tray.copyright = menus.NewSingleItem(
			MenuIdCopyright, app.App().GetCopyright(),
		).Disable()

		systray.AddSeparator()

		// writeOff menu
		_tray.writeOff = menus.NewSingleItem(
			MenuIdWriteOff, "注销",
		).SetTextUpdater(func(id string) (updateText string) {
			return "注销"
		})

		systray.AddSeparator()

		// quit menu
		_tray.quit = menus.NewSingleItem(
			MenuIdQuit, "退出",
		).SetTextUpdater(func(id string) (updateText string) {
			return "退出"
		})

		_tray.watch()

		log.Info("tray 运行中")
		close(waitUntilReady)
	}, nil)
	<-waitUntilReady
})
return _tray

}

Expected behaviour

I hope to realize the function of opening the application by left-clicking the application icon in the tray

Screenshots

No response

Attempted Fixes

No response

System Details

wails doctorDEB | Using go webview2loader
Wails CLI v2.5.1
SUCCESS Done .
# System
0S
Version
Windows Server 2019 Datacenter
1809(Build:17763)
ID
Go Version
Platform
go1.19.7
windows
Architectureamd64
# Wails
Version  v2.5.1
# Dependencies
Dependency
Webview2
Nodejs
npm
*upX
*nsis
Package Name
StatusVersion
N/A
N/A
N/A
N/A
N/A
Installed138.0.3351.121
Installed14.20.0
6.14.17Installed
Available
Available
*-0ptional Dependency
# Diagnosis
Your system is ready for Wails development!
0ptional package(s)installation details:
upx : Available at https://upx.github.io/
-nsis : More info at https://wails.io/docs/guides/windows-installer/

Additional context

No response

[dosubot[bot]]

Hi @victory-zz! I'm Dosu and I’m helping the wails team.

Wails v2.5.1 on Windows does not support distinguishing left-click events on the tray icon—left-click always shows the menu, and there is no built-in way to override this behavior or trigger opening the application window directly on left-click. This is a limitation of how tray events are handled in the framework and the underlying systray integration.

If you need this functionality, Wails v3 introduces an OnClick handler for the tray icon, which allows you to open or toggle the application window on left-click. You can see an example of this in Wails v3 where systray.OnClick is used to show or hide the main window on left-click [example].

For Wails v2.5.1, there are no documented workarounds or hooks to achieve this behavior. If left-click-to-open is essential, consider migrating to Wails v3 or exploring a custom tray implementation outside of the current Wails tray API.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[leaanthony]

We don't have a systray for v2 only v3. Moving this to a discussion.