Defined in: webview-window.ts:17
运行时创建的原生窗口(多窗口)。
new WebviewWindow(
label,options?):WebviewWindow
Defined in: webview-window.ts:20
string
WebviewWindowOptions = {}
readonlylabel:string
Defined in: window.ts:157
activityName():
Promise<string|null>
Defined in: window.ts:365
上游仅 Android:当前 activity 名(桌面端为 null)。
Promise<string | null>
center():
Promise<void>
Defined in: window.ts:685
Promise<void>
clearEffects():
Promise<void>
Defined in: window.ts:300
移除已应用的活力效果。
Promise<void>
close():
Promise<void>
Defined in: window.ts:537
Promise<void>
create():
Promise<void>
Defined in: webview-window.ts:26
以本实例的 label + 选项创建原生窗口。
Promise<void>
cursorPosition():
Promise<{x:number;y:number; }>
Defined in: window.ts:388
屏幕坐标系中的光标位置(无需 label;上游对齐)。
Promise<{ x: number; y: number; }>
destroy():
Promise<void>
Defined in: window.ts:421
强制关闭窗口,绕过 preventClose。
Promise<void>
getState():
Promise<{alwaysOnTop:boolean;fullscreen:boolean;maximized:boolean;minimized:boolean;resizable:boolean;visible:boolean; } |null>
Defined in: window.ts:713
读取窗口的布尔状态位(maximized/fullscreen 等)。
Promise<{ alwaysOnTop: boolean; fullscreen: boolean; maximized: boolean; minimized: boolean; resizable: boolean; visible: boolean; } | null>
getTheme():
Promise<string|null>
Defined in: window.ts:210
窗口跟随的 OS 配色("light" | "dark")。
Promise<string | null>
getTitle():
Promise<string>
Defined in: window.ts:183
当前原生窗口标题。
Promise<string>
hide():
Promise<void>
Defined in: window.ts:229
Promise<void>
innerPosition():
Promise<{x:number;y:number; }>
Defined in: window.ts:765
窗口内容区位置(内容左上角)。以外框原点近似——精确内容原点需要测量标题栏高度。
Promise<{ x: number; y: number; }>
innerSize():
Promise<{height:number;width:number; }>
Defined in: window.ts:200
窗口内容区尺寸(点)——不含标题栏。
Promise<{ height: number; width: number; }>
isAlwaysOnTop():
Promise<boolean>
Defined in: window.ts:725
窗口是否置顶于其他窗口。
Promise<boolean>
isClosable():
Promise<boolean>
Defined in: window.ts:642
原生关闭按钮是否启用。
Promise<boolean>
isDecorated():
Promise<boolean>
Defined in: window.ts:647
窗口是否有原生装饰(标题栏/边框)。
Promise<boolean>
isEnabled():
Promise<boolean>
Defined in: window.ts:193
窗口是否启用(macOS:始终 true——无对应 NSWindow 状态)。
Promise<boolean>
isFocused():
Promise<boolean>
Defined in: window.ts:652
窗口当前是否持有焦点(key window)。
Promise<boolean>
isFullscreen():
Promise<boolean>
Defined in: window.ts:580
Promise<boolean>
isMaximizable():
Promise<boolean>
Defined in: window.ts:627
原生最大化/缩放按钮是否启用。
Promise<boolean>
isMaximized():
Promise<boolean>
Defined in: window.ts:565
Promise<boolean>
isMinimizable():
Promise<boolean>
Defined in: window.ts:612
原生最小化按钮是否启用。
Promise<boolean>
isMinimized():
Promise<boolean>
Defined in: window.ts:569
Promise<boolean>
isResizable():
Promise<boolean>
Defined in: window.ts:735
窗口是否可调整尺寸。
Promise<boolean>
isVisible():
Promise<boolean>
Defined in: window.ts:730
窗口是否可见。
Promise<boolean>
maximize():
Promise<void>
Defined in: window.ts:556
直接设置原生最大化状态(非切换,Tauri v2 拆分)。
Promise<void>
minimize():
Promise<void>
Defined in: window.ts:543
Promise<void>
onBlurred(
handler):Promise<UnlistenFn>
Defined in: window.ts:926
() => void
Promise<UnlistenFn>
onCloseRequested(
handler):Promise<() =>void>
Defined in: window.ts:947
请求关闭时触发。处理函数动态决定:调用 event.preventDefault() 保持窗口打开,否则处理函数完成后窗口被销毁(Tauri v2 语义)。
(event) => unknown
Promise<() => void>
onDragDropEvent(
handler): () =>void
Defined in: window.ts:310
归一化的拖放通知(Tauri DragDropEvent):enter 携带 paths + position,over 仅 position,drop 携带 paths + position,leave 在拖拽离开窗口未放下时触发。位置为相对窗口左上角的物理像素。
(payload) => void
() => void
onFocusChanged(
handler):Promise<() =>void>
Defined in: window.ts:931
焦点 + 失焦合并(Tauri v2 语法糖)。
(focused) => void
Promise<() => void>
onFocused(
handler):Promise<UnlistenFn>
Defined in: window.ts:922
() => void
Promise<UnlistenFn>
onMoved(
handler):Promise<UnlistenFn>
Defined in: window.ts:891
(payload) => void
Promise<UnlistenFn>
onResized(
handler):Promise<UnlistenFn>
Defined in: window.ts:887
(payload) => void
Promise<UnlistenFn>
onScaleChanged(
handler):Promise<UnlistenFn>
Defined in: window.ts:966
缩放因子变化时触发(在 Retina 显示器间移动)。
(payload) => void
Promise<UnlistenFn>
onThemeChanged(
handler):Promise<UnlistenFn>
Defined in: window.ts:973
系统主题变化时触发(载荷:"dark" | "light")。
(theme) => void
Promise<UnlistenFn>
outerPosition():
Promise<{x:number;y:number; }>
Defined in: window.ts:751
窗口外框位置(左上角原点)。
Promise<{ x: number; y: number; }>
outerSize():
Promise<{height:number;width:number; }>
Defined in: window.ts:740
窗口外框尺寸(宽 × 高,含装饰)。
Promise<{ height: number; width: number; }>
preventClose(
prevent):Promise<void>
Defined in: window.ts:416
阻止窗口关闭;改为发出 ztron://close-requested 事件,由前端确认(随后调用 destroy())。
boolean
Promise<void>
requestUserAttention(
type?):Promise<void>
Defined in: window.ts:676
弹跳 dock 图标直至激活。null 取消请求。(macOS 将 Critical/Informational 映射为弹跳样式。)
UserAttentionType | null
Promise<void>
scaleFactor():
Promise<number|null>
Defined in: window.ts:234
窗口的缩放因子(Retina/HiDPI 上为 2)。
Promise<number | null>
sceneIdentifier():
Promise<string|null>
Defined in: window.ts:375
上游仅 iOS:当前 scene 标识符(桌面端为 null)。
Promise<string | null>
setActivityName(
name):Promise<void>
Defined in: window.ts:370
上游仅 Android:桌面端接受为已记录的空操作。
string
Promise<void>
setAlwaysOnBottom(
alwaysOnBottom):Promise<void>
Defined in: window.ts:594
把窗口置于所有其他窗口之下(v2 新增)。
boolean
Promise<void>
setAlwaysOnTop(
alwaysOnTop):Promise<void>
Defined in: window.ts:586
boolean
Promise<void>
setBackgroundColor(
color):Promise<void>
Defined in: window.ts:857
设置窗口背景色:"#rrggbb"、"#rrggbbaa" 或 "transparent"。对无边框/透明窗口生效。
string
Promise<void>
setBadgeCount(
count):Promise<void>
Defined in: window.ts:835
设置 dock 角标计数。null/undefined 移除角标。macOS dock / Windows 任务栏;其他平台不支持。
number | null
Promise<void>
setBadgeLabel(
badgeLabel):Promise<void>
Defined in: window.ts:846
设置 dock 角标为任意文本(仅 macOS)。null/undefined/"" 移除角标。
string | null
Promise<void>
setBounds(
x,y,width?,height?):Promise<void>
Defined in: window.ts:437
一次调用设置窗口位置与尺寸(接受 dpi 类型)。
number
number
Promise<void>
setClosable(
closable):Promise<void>
Defined in: window.ts:634
切换原生关闭按钮。
boolean
Promise<void>
setContentProtected(
protect):Promise<void>
Defined in: window.ts:665
防止窗口内容被其他应用捕获。
boolean
Promise<void>
setCursor(
cursor):Promise<void>
Defined in: window.ts:345
设置窗口光标(CSS 风格名:"default"、"pointer"、"text"、"crosshair"、"move"、"not-allowed"、各类 resize 光标等)。
string
Promise<void>
setCursorGrab(
grab):Promise<void>
Defined in: window.ts:262
把光标锁定在当前位置(Tauri setCursorGrab)。macOS 上光标视觉上停在原地;传 false 释放。
boolean
Promise<void>
setCursorIcon(
icon):Promise<void>
Defined in: window.ts:350
setCursor 的别名(Tauri v2 名称)。
string
Promise<void>
setCursorPosition(
x,y?):Promise<void>
Defined in: window.ts:395
把光标移动到窗口坐标(接受 dpi 类型)。
number
Promise<void>
setCursorVisible(
visible):Promise<void>
Defined in: window.ts:357
隐藏/显示系统光标(应用级隐藏计数——调用需配对)。
boolean
Promise<void>
setDecorations(
decorations):Promise<void>
Defined in: window.ts:783
切换原生窗口装饰(标题栏/边框)。
boolean
Promise<void>
setEffects(
effects):Promise<void>
Defined in: window.ts:292
设置活力材质(macOS)。Windows 独有效果在该平台被忽略。
Promise<void>
setEnabled(
enabled):Promise<void>
Defined in: window.ts:463
启用/禁用原生窗口。
boolean
Promise<void>
setFileDropEnabled(
enabled):Promise<void>
Defined in: window.ts:251
启用/禁用原生文件拖放处理器。启用时(默认)文件拖放产生 onDragDropEvent 事件;禁用后页面可改用 HTML5 拖放 API。
boolean
Promise<void>
setFocus():
Promise<void>
Defined in: window.ts:689
Promise<void>
setFocusable(
focusable):Promise<void>
Defined in: window.ts:896
切换窗口能否取得键盘焦点。
boolean
Promise<void>
setFullscreen(
fullscreen):Promise<void>
Defined in: window.ts:573
boolean
Promise<void>
setIcon(
icon):Promise<void>
Defined in: window.ts:273
以注册的 host 图像(Image)设置窗口/dock 图标。传 null 清除。
Image | null
Promise<void>
setIgnoreCursorEvents(
ignore):Promise<void>
Defined in: window.ts:239
切换窗口是否忽略鼠标/光标事件。
boolean
Promise<void>
setMaximizable(
maximizable):Promise<void>
Defined in: window.ts:619
切换原生最大化/缩放按钮。
boolean
Promise<void>
setMaxSize(
size):Promise<void>
Defined in: window.ts:510
设置窗口最大内容尺寸。null 取消约束(接受 dpi 类型)。
SizeLike | null | undefined
Promise<void>
setMinimizable(
minimizable):Promise<void>
Defined in: window.ts:604
切换原生最小化按钮(macOS/Windows;基于按钮掩码)。
boolean
Promise<void>
setMinSize(
size):Promise<void>
Defined in: window.ts:497
设置窗口最小内容尺寸。null 取消约束(接受 dpi 类型,如 new LogicalSize(300, 200))。
SizeLike | null | undefined
Promise<void>
setOpacity(
opacity):Promise<void>
Defined in: window.ts:705
设置窗口不透明度,0.0(全透明)到 1.0(不透明)。
number
Promise<void>
setOverlayIcon(
icon):Promise<void>
Defined in: window.ts:284
设置标题栏配件小图标(macOS 版的 Windows overlay/状态徽标)。传 null 清除。
Image | null
Promise<void>
setPosition(
x,y?):Promise<void>
Defined in: window.ts:484
移动窗口。接受纯数字、LogicalPosition/PhysicalPosition 或普通 { x, y } 对象。
number
Promise<void>
setProgressBar(
progress):Promise<void>
Defined in: window.ts:809
设置 dock/任务栏进度(0.0–1.0),null 清除;macOS 上作用于应用级 dock tile,Windows 任务栏按窗口。接受裸确定值/null(v1 形状)或上游 ProgressBarState 对象:Indeterminate 切换旋转条,None 清除。
number | ProgressBarStateInput | null
Promise<void>
setResizable(
resizable):Promise<void>
Defined in: window.ts:697
boolean
Promise<void>
setSceneIdentifier(
id):Promise<void>
Defined in: window.ts:380
上游仅 iOS:桌面端接受为已记录的空操作。
string
Promise<void>
setShadow(
shadow):Promise<void>
Defined in: window.ts:458
切换原生窗口阴影。
boolean
Promise<void>
setSimpleFullscreen(
fullscreen):Promise<void>
Defined in: window.ts:915
无边框「简单」全屏:内容铺满屏幕而不经过原生全屏空间切换(退出时恢复边框与装饰)。
boolean
Promise<void>
setSize(
width,height?):Promise<void>
Defined in: window.ts:471
设置窗口尺寸。接受纯数字、LogicalSize/PhysicalSize 或普通 { width, height } 对象。
number
Promise<void>
setSizeConstraints(
constraints):Promise<void>
Defined in: window.ts:520
一次调用设置最小/最大内容尺寸约束。
WindowSizeConstraints | null | undefined
Promise<void>
setSkipTaskbar(
skipTaskbar):Promise<void>
Defined in: window.ts:657
从任务栏/dock 隐藏窗口图标(macOS:整个应用)。
boolean
Promise<void>
setTheme(
theme):Promise<void>
Defined in: window.ts:220
应用级主题覆盖("dark"/"light";null 跟随系统)。
"dark" | "light" | null
Promise<void>
setTitle(
title):Promise<void>
Defined in: window.ts:178
string
Promise<void>
setTitleBarStyle(
style):Promise<void>
Defined in: window.ts:869
设置标题栏样式(仅 macOS):"visible"(默认)、"transparent"(隐藏边框装饰)或 "overlay"(内容延伸至红绿灯之下——即 Tauri 的 transparent + 全尺寸内容视图)。
Promise<void>
setTrafficLightPosition(
x,y):Promise<void>
Defined in: window.ts:981
移动红绿灯按钮(关闭/最小化/缩放)——用于 titleBarStyle: "overlay" 的无边框 macOS 窗口。
number
number
Promise<void>
Window.setTrafficLightPosition
setTransparent(
transparent):Promise<void>
Defined in: window.ts:775
切换透明窗口背景。
boolean
Promise<void>
setVisible(
visible):Promise<void>
Defined in: window.ts:693
boolean
Promise<void>
setVisibleOnAllWorkspaces(
visible):Promise<void>
Defined in: window.ts:904
在所有工作区/虚拟桌面显示窗口(macOS)。
boolean
Promise<void>
Window.setVisibleOnAllWorkspaces
setZoom(
zoom):Promise<void>
Defined in: window.ts:408
缩放 Web 内容(CSS zoom 系数,如 1.5)。
number
Promise<void>
show():
Promise<void>
Defined in: window.ts:225
setVisible(true) / setVisible(false) 的别名(Tauri v2 对齐)。
Promise<void>
startDragging():
Promise<void>
Defined in: window.ts:794
开始原生窗口拖拽——在无边框窗口的 data-tauri-drag-region 元素上响应 mousedown 调用。
Promise<void>
startResizeDragging(
direction?):Promise<void>
Defined in: window.ts:429
开始原生调整尺寸拖拽(direction:"north"/"south"/"east"/"west" 或组合如 "southeast")。macOS 未实现。
string = "southeast"
Promise<void>
theme():
Promise<string|null>
Defined in: window.ts:215
OS 配色,getTheme 的别名(Tauri v2 对齐)。
Promise<string | null>
title():
Promise<string>
Defined in: window.ts:188
设置窗口标题(setTitle 的别名,Tauri v2 对齐)。
Promise<string>
toggleMaximize():
Promise<void>
Defined in: window.ts:551
Promise<void>
unmaximize():
Promise<void>
Defined in: window.ts:561
还原最大化的窗口(未最大化时为空操作)。
Promise<void>
unminimize():
Promise<void>
Defined in: window.ts:547
Promise<void>
staticgetByLabel(label):Promise<Window|null>
Defined in: window.ts:164
按 label 查找存活窗口(不存在时为 null)。
string
Promise<Window | null>
staticgetCurrent():Window
Defined in: window.ts:169
当前窗口(label 来自引导元数据)。
Defined in: webview-window.ts:8
optionalheight?:number
Defined in: webview-window.ts:11
optionalhtml?:string
Defined in: webview-window.ts:13
optionaltitle?:string
Defined in: webview-window.ts:9
optionalurl?:string
Defined in: webview-window.ts:12
optionalwidth?:number
Defined in: webview-window.ts:10
getCurrentWebviewWindow():
Window
Defined in: webview-window.ts:35
发起本次调用的窗口(Window 的单窗口别名)。