windows

package
v2.11.0 Latest Latest
Warning

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

Go to latest
Published: Nov 8, 2025 License: MIT Imports: 0 Imported by: 118

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