mirror of
https://github.com/wailsapp/wails.git
synced 2025-05-02 14:41:29 +08:00
222 lines
5.8 KiB
Plaintext
222 lines
5.8 KiB
Plaintext
---
|
||
sidebar_position: 4
|
||
---
|
||
|
||
# Window 窗口
|
||
|
||
这些方法可以控制应用程序窗口。
|
||
|
||
### WindowSetTitle 窗口标题
|
||
|
||
设置窗口标题栏中的文本。
|
||
|
||
Go: `WindowSetTitle(ctx context.Context, title string)`<br/> JS: `WindowSetTitle(title: string)`
|
||
|
||
### WindowFullscreen 窗口全屏
|
||
|
||
使窗口全屏。
|
||
|
||
Go: `WindowFullscreen(ctx context.Context)`<br/> JS: `WindowFullscreen()`
|
||
|
||
### WindowUnfullscreen 窗口取消全屏
|
||
|
||
恢复全屏之前的先前窗口尺寸和位置。
|
||
|
||
Go: `WindowUnfullscreen(ctx context.Context)`<br/> JS: `WindowUnfullscreen()`
|
||
|
||
### WindowIsFullscreen 窗口是否全屏
|
||
|
||
如果窗口是全屏的，则返回 true。
|
||
|
||
Go: `WindowIsFullscreen(ctx context.Context) bool`<br/> JS: `WindowIsFullscreen() bool`
|
||
|
||
### WindowCenter 窗口居中
|
||
|
||
使窗口在当前窗口所在的监视器上居中。
|
||
|
||
Go: `WindowCenter(ctx context.Context)`<br/> JS: `WindowCenter()`
|
||
|
||
### WindowExecJS 窗口执行JS代码
|
||
|
||
在窗口中执行任意 JS 代码。
|
||
|
||
此方法在浏览器中异步运行代码并立即返回。 如果脚本导致任何错误，它们将只在浏览器控制台中可用。
|
||
|
||
Go: `WindowExecJS(ctx context.Context, js string)`
|
||
|
||
### WindowReload 窗口重新加载
|
||
|
||
执行“重新加载”（重新加载当前页面）。
|
||
|
||
Go: `WindowReload(ctx context.Context)`<br/> JS: `WindowReload()`
|
||
|
||
### WindowReloadApp 重新加载应用程序前端。
|
||
|
||
重新加载应用程序前端。
|
||
|
||
Go: `WindowReloadApp(ctx context.Context)`<br/> JS: `WindowReloadApp()`
|
||
|
||
### WindowSetSystemDefaultTheme 窗口设置系统默认主题
|
||
|
||
仅限 Windows。
|
||
|
||
Go: `WindowSetSystemDefaultTheme(ctx context.Context)`<br/> JS: `WindowSetSystemDefaultTheme()`
|
||
|
||
将窗口主题设置为系统默认值（暗/亮）。
|
||
|
||
### WindowSetLightTheme 窗口设置浅色主题
|
||
|
||
仅限 Windows。
|
||
|
||
Go: `WindowSetLightTheme(ctx context.Context)`<br/> JS: `WindowSetLightTheme()`
|
||
|
||
将窗口主题设置为浅色。
|
||
|
||
### WindowSetDarkTheme 窗口设置深色主题
|
||
|
||
仅限 Windows。
|
||
|
||
Go: `WindowSetDarkTheme(ctx context.Context)`<br/> JS: `WindowSetDarkTheme()`
|
||
|
||
将窗口主题设置为深色。
|
||
|
||
### WindowShow 显示窗口
|
||
|
||
显示窗口，如果它当前是隐藏的。
|
||
|
||
Go: `WindowShow(ctx context.Context)`<br/> JS: `WindowShow()`
|
||
|
||
### WindowShow 隐藏窗口
|
||
|
||
如果当前可见，则隐藏窗口。
|
||
|
||
Go: `WindowHide(ctx context.Context)`<br/> JS: `WindowHide()`
|
||
|
||
### WindowIsNormal 窗口是否为正常
|
||
|
||
如果窗口未最小化、最大化或全屏，则返回 true。
|
||
|
||
Go: `WindowIsNormal(ctx context.Context) bool`<br/> JS: `WindowIsNormal() bool`
|
||
|
||
### WindowSetSize 设置窗口尺寸
|
||
|
||
设置窗口的宽度和高度。
|
||
|
||
Go: `WindowSetSize(ctx context.Context, width int, height int)`<br/> JS: `WindowSetSize(size: Size)`
|
||
|
||
### WindowGetSize 获取窗口尺寸
|
||
|
||
获取窗口的宽度和高度。
|
||
|
||
Go: `WindowGetSize(ctx context.Context) (width int, height int)`<br/> JS: `WindowGetSize() : Size`
|
||
|
||
### WindowSetMinSize 设置窗口最小尺寸
|
||
|
||
设置窗口最小尺寸。 如果窗口当前小于给定尺寸，将调整窗口大小。
|
||
|
||
设置大小 `0,0` 将禁用此约束。
|
||
|
||
Go: `WindowSetMinSize(ctx context.Context, width int, height int)`<br/> JS: `WindowSetMinSize(size: Size)`
|
||
|
||
### WindowSetMaxSize 设置窗口最大尺寸
|
||
|
||
设置窗口最大尺寸。 如果窗口当前大于给定尺寸，将调整窗口大小。
|
||
|
||
设置大小 `0,0` 将禁用此约束。
|
||
|
||
Go: `WindowSetMaxSize(ctx context.Context, width int, height int)`<br/> JS: `WindowSetMaxSize(size: Size)`
|
||
|
||
### WindowSetAlwaysOnTop 设置窗口置顶
|
||
|
||
设置窗口置顶或取消置顶。
|
||
|
||
Go: `WindowSetAlwaysOnTop(ctx context.Context, b bool)`<br/> JS: `WindowSetAlwaysOnTop(b: Boolen)`
|
||
|
||
### WindowSetPosition 设置窗口位置
|
||
|
||
设置相对于窗口当前所在监视器的窗口位置。
|
||
|
||
Go: `WindowSetPosition(ctx context.Context, x int, y int)`<br/> JS: `WindowSetPosition(position: Position)`
|
||
|
||
### WindowGetPosition 获取窗口位置
|
||
|
||
获取相对于窗口当前所在监视器的窗口位置。
|
||
|
||
Go: `WindowGetPosition(ctx context.Context) (x int, y int)`<br/> JS: `WindowGetPosition() : Position`
|
||
|
||
### WindowMaximise 窗口最大化
|
||
|
||
最大化窗口以填满屏幕。
|
||
|
||
Go: `WindowMaximise(ctx context.Context)`<br/> JS: `WindowMaximise()`
|
||
|
||
### WindowUnmaximise 窗口取消最大化
|
||
|
||
将窗口恢复到最大化之前的尺寸和位置。
|
||
|
||
Go: `WindowUnmaximise(ctx context.Context)`<br/> JS: `WindowUnmaximise()`
|
||
|
||
### WindowIsMaximised 窗口是否最大化
|
||
|
||
如果窗口最大化，则返回 true。
|
||
|
||
Go: `WindowIsMaximised(ctx context.Context) bool`<br/> JS: `WindowIsMaximised() bool`
|
||
|
||
### WindowToggleMaximise 窗口最大化切换
|
||
|
||
在最大化和未最大化之间切换。
|
||
|
||
Go: `WindowToggleMaximise(ctx context.Context)`<br/> JS: `WindowToggleMaximise()`
|
||
|
||
### WindowMinimise 窗口最小化。
|
||
|
||
最小化窗口。
|
||
|
||
Go: `WindowMinimise(ctx context.Context)`<br/> JS: `WindowMinimise()`
|
||
|
||
### WindowUnminimise 窗口取消最小化
|
||
|
||
将窗口恢复到最小化之前的尺寸和位置。
|
||
|
||
Go: `WindowUnminimise(ctx context.Context)`<br/> JS: `WindowUnminimise()`
|
||
|
||
### WindowIsMinimised 窗口是否最小化
|
||
|
||
如果窗口最小化，则返回 true。
|
||
|
||
Go: `WindowIsMinimised(ctx context.Context) bool`<br/> JS: `WindowIsMinimised() bool`
|
||
|
||
### WindowSetBackgroundColour 窗口设置背景色
|
||
|
||
将窗口的背景颜色设置为给定的 RGBA 颜色定义。 这种颜色将显示所有透明像素。
|
||
|
||
R、G、B 和 A 的有效值为 0-255。
|
||
|
||
:::info Windows
|
||
|
||
在 Windows 上，仅支持 0 或 255 的 alpha 值。 任何非 0 的值都将被视为 255。
|
||
|
||
:::
|
||
|
||
Go: `WindowSetBackgroundColour(ctx context.Context, R, G, B, A uint8)`<br/> JS: `WindowSetBackgroundColour(R, G, B, A)`
|
||
|
||
## TypeScript 对象定义
|
||
|
||
### Position（位置）
|
||
|
||
```ts
|
||
interface Position {
|
||
x: number;
|
||
y: number;
|
||
}
|
||
```
|
||
|
||
### Size（尺寸）
|
||
|
||
```ts
|
||
interface Size {
|
||
w: number;
|
||
h: number;
|
||
}
|
||
```
|