Help us shape the future of Go! Take the 2026 Go Developer Survey

windows

package
v2.17.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 18, 2026 License: MIT Imports: 0 Imported by: 147

Documentation

Index

Constants

View Source
const (
	// Default is 0, which means no changes to the default Windows DLL search behavior
	DLLSearchDefault uint32 = 0
	// LoadLibrary flags for determining from where to search for a DLL
	DLLSearchDontResolveDllReferences uint32 = 0x1    // windows.DONT_RESOLVE_DLL_REFERENCES
	DLLSearchAsDataFile               uint32 = 0x2    // windows.LOAD_LIBRARY_AS_DATAFILE
	DLLSearchWithAlteredPath          uint32 = 0x8    // windows.LOAD_WITH_ALTERED_SEARCH_PATH
	DLLSearchIgnoreCodeAuthzLevel     uint32 = 0x10   // windows.LOAD_IGNORE_CODE_AUTHZ_LEVEL
	DLLSearchAsImageResource          uint32 = 0x20   // windows.LOAD_LIBRARY_AS_IMAGE_RESOURCE
	DLLSearchAsDataFileExclusive      uint32 = 0x40   // windows.LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE
	DLLSearchRequireSignedTarget      uint32 = 0x80   // windows.LOAD_LIBRARY_REQUIRE_SIGNED_TARGET
	DLLSearchDllLoadDir               uint32 = 0x100  // windows.LOAD_LIBRARY_SEARCH_DLL_LOAD_DIR
	DLLSearchApplicationDir           uint32 = 0x200  // windows.LOAD_LIBRARY_SEARCH_APPLICATION_DIR
	DLLSearchUserDirs                 uint32 = 0x400  // windows.LOAD_LIBRARY_SEARCH_USER_DIRS
	DLLSearchSystem32                 uint32 = 0x800  // windows.LOAD_LIBRARY_SEARCH_SYSTEM32
	DLLSearchDefaultDirs              uint32 = 0x1000 // windows.LOAD_LIBRARY_SEARCH_DEFAULT_DIRS
	DLLSearchSafeCurrentDirs          uint32 = 0x2000 // windows.LOAD_LIBRARY_SAFE_CURRENT_DIRS
	DLLSearchSystem32NoForwarder      uint32 = 0x4000 // windows.LOAD_LIBRARY_SEARCH_SYSTEM32_NO_FORWARDER
	DLLSearchOsIntegrityContinuity    uint32 = 0x8000 // windows.LOAD_LIBRARY_OS_INTEGRITY_CONTINUITY
)

Variables

This section is empty.

Functions

func RGB

func RGB(r, g, b uint8) int32

Types

type BackdropType

type BackdropType int32
const (
	Auto    BackdropType = 0
	None    BackdropType = 1
	Mica    BackdropType = 2
	Acrylic BackdropType = 3
	Tabbed  BackdropType = 4
)

type Messages

type Messages struct {
	InstallationRequired string
	UpdateRequired       string
	MissingRequirements  string
	Webview2NotInstalled string
	Error                string
	FailedToInstall      string
	DownloadPage         string
	PressOKToInstall     string
	ContactAdmin         string
	InvalidFixedWebview2 string
	WebView2ProcessCrash string
}

func DefaultMessages

func DefaultMessages() *Messages

type Options

type Options struct {
	ContentProtection    bool
	WebviewIsTransparent bool
	WindowIsTranslucent  bool
	DisableWindowIcon    bool

	IsZoomControlEnabled bool
	ZoomFactor           float64

	DisablePinchZoom bool

	// Disable all window decorations in Frameless mode, which means no "Aero Shadow" and no "Rounded Corner" will be shown.
	// "Rounded Corners" are only available on Windows 11.
	DisableFramelessWindowDecorations bool

	// Path where the WebView2 stores the user data. If empty %APPDATA%\[BinaryName.exe] will be used.
	// If the path is not valid, a messagebox will be displayed with the error and the app will exit with error code.
	WebviewUserDataPath string

	// Path to the directory with WebView2 executables. If empty WebView2 installed in the system will be used.
	WebviewBrowserPath string

	// Dark/Light or System Default Theme
	Theme Theme

	// Custom settings for dark/light mode
	CustomTheme *ThemeSettings

	// Select the type of translucent backdrop. Requires Windows 11 22621 or later.
	BackdropType BackdropType

	// User messages that can be customised
	Messages *Messages

	// ResizeDebounceMS is the amount of time to debounce redraws of webview2
	// when resizing the window
	ResizeDebounceMS uint16

	// OnSuspend is called when Windows enters low power mode
	OnSuspend func()

	// OnResume is called when Windows resumes from low power mode
	OnResume func()

	// WebviewGpuIsDisabled is used to enable / disable GPU acceleration for the webview
	WebviewGpuIsDisabled bool

	// WebviewDisableRendererCodeIntegrity disables the `RendererCodeIntegrity` of WebView2. Some Security Endpoint
	// Protection Software inject themself into the WebView2 with unsigned or wrongly signed dlls, which is not allowed
	// and will stop the WebView2 processes. Those security software need an update to fix this issue or one can disable
	// the integrity check with this flag.
	//
	// The event viewer log contains `Code Integrity Errors` like mentioned here: https://github.com/MicrosoftEdge/WebView2Feedback/issues/2051
	//
	// !! Please keep in mind when disabling this feature, this also allows malicious software to inject into the WebView2 !!
	WebviewDisableRendererCodeIntegrity bool

	// Configure whether swipe gestures should be enabled
	EnableSwipeGestures bool

	// Class name for the window. If empty, 'wailsWindow' will be used.
	WindowClassName string

	// DLLSearchPaths controls which directories are searched when loading DLLs
	// Set to 0 for default behavior, or combine multiple flags with bitwise OR
	// Example: DLLSearchApplicationDir | DLLSearchSystem32
	DLLSearchPaths uint32
}

Options are options specific to Windows

type Theme

type Theme int
const (
	// SystemDefault will use whatever the system theme is. The application will follow system theme changes.
	SystemDefault Theme = 0
	// Dark Mode
	Dark Theme = 1
	// Light Mode
	Light Theme = 2
)

type ThemeSettings

type ThemeSettings struct {
	DarkModeTitleBar           int32
	DarkModeTitleBarInactive   int32
	DarkModeTitleText          int32
	DarkModeTitleTextInactive  int32
	DarkModeBorder             int32
	DarkModeBorderInactive     int32
	LightModeTitleBar          int32
	LightModeTitleBarInactive  int32
	LightModeTitleText         int32
	LightModeTitleTextInactive int32
	LightModeBorder            int32
	LightModeBorderInactive    int32
}

ThemeSettings contains optional colours to use. They may be set using the hex values: 0x00BBGGRR

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL