Eine Anwendung und ihr Tray

Die Anwendung

go-widgets/application ist die Schicht oberhalb von window: Sie öffnet das Fenster, treibt seine Schleife, hängt ein Tray-Symbol an, sobald der erste Frame steht, reicht das aktuelle Erscheinungsbild des Systems (dunkel oder hell, Akzentfarbe, Systemschrift) an die Anwendung weiter, veröffentlicht den Barrierefreiheitsbaum und ruft onReady auf, sobald der erste Frame auf dem Bildschirm ist.

spec := application.Spec{
	Name:       "News Reader",
	Identifier: "com.example.reader",
	Version:    "1.0.0",
	Tray: func() *tray.Menu {
		return tray.NewMenu().Add(
			tray.Item("Refresh", refresh),
			tray.Item("Quit", quit),
		)
	},
}
cfg := application.Config{Title: "News Reader", Width: 1200, Height: 800}
err := application.Run(spec, cfg, handler, func() { log.Println("on screen") })

handler implementiert Handler – Frame, Resize, Maus-, Scroll- und Tastatur- Ereignisse – und kann jede der optionalen Fähigkeiten implementieren: Erscheinungsbild, Tastenkürzel, Klicks und Tasten mit Modifikatoren, Sekundärklick, Kontextmenüs, Zwischenablage, Barrierefreiheit, native Bedienelemente. Die Schleife umhüllt den Handler nie; sie macht für jede Fähigkeit eine Typzusicherung und beachtet die, die sie findet. Ein Test durchläuft das Paket nach diesen Zusicherungen und schlägt fehl, wenn die Paketdokumentation nicht jede einzelne nennt.

Ein Tray, das nicht angehängt werden kann, ist ein Fehler von Run, kein Schweigen: errors.Is(err, tray.ErrNoBackend) sagt, warum. Eine Anwendung, die ihr Fenster will, egal was mit dem Tray geschieht, lässt Spec.Tray auf nil und betreibt selbst eines.

Run schließt sein Fenster, wenn die Schleife zurückkehrt, sodass das „Open" einer Tray-Anwendung Run erneut aufrufen kann, um ein frisches Fenster zu bekommen. Für einen Host, der kein Fenster ist – eine Desktop-Shell, ein Browser-Tab –, geben Bind und BindScaled eine *toolkit.Surface zurück, die mit demselben Handler verdrahtet ist.

Das Tray

Ein Tray-Symbol ist Betriebssystemintegration, kein gezeichnetes Widget, deshalb steuert go-widgets/tray die eigene API jeder Plattform, weiterhin mit CGO_ENABLED=0:

menu := tray.NewMenu().Add(
	tray.Item("Open", open),
	tray.Checkbox("Notifications", true, setNotify),
	tray.SubMenu("Recent", tray.NewMenu().Add(tray.Item("file.txt", nil))),
	tray.Separator(),
	tray.Item("Quit", func() { t.Quit() }),
)
t := tray.New(iconPNG).SetTooltip("My App").SetMenu(menu)
t.Run() // blocks on the platform's loop until Quit

Ein Programm, das bereits die Schleife eines Fensters betreibt, kann Run seinen Hauptthread nicht überlassen: Attach zeigt dasselbe Symbol an und kehrt zurück, und Quit entfernt es wieder.

Die nativen Back-Ends sind standardmäßig aktiv; es gibt kein Build-Tag, an das man denken müsste. Auf einer Plattform ohne Back-End gibt Run ErrNoBackend zurück – der Unterschied zwischen „hier gibt es kein Tray" und einem Tray, das stillschweigend nichts tut. Ein Test oder ein Headless-Dienst übergibt WithBackend(tray.NewHeadless()).