1951 lines
57 KiB
JavaScript
1951 lines
57 KiB
JavaScript
import {
|
|
TauriEvent,
|
|
emit,
|
|
emitTo,
|
|
listen,
|
|
once
|
|
} from "./chunk-R4EXQSPT.js";
|
|
import {
|
|
transformImage
|
|
} from "./chunk-26G4VO4R.js";
|
|
import {
|
|
SERIALIZE_TO_IPC_FN,
|
|
invoke
|
|
} from "./chunk-DSY64NDS.js";
|
|
import "./chunk-DC5AMYBS.js";
|
|
|
|
// node_modules/.pnpm/@tauri-apps+api@2.6.0/node_modules/@tauri-apps/api/dpi.js
|
|
var LogicalSize = class {
|
|
constructor(...args) {
|
|
this.type = "Logical";
|
|
if (args.length === 1) {
|
|
if ("Logical" in args[0]) {
|
|
this.width = args[0].Logical.width;
|
|
this.height = args[0].Logical.height;
|
|
} else {
|
|
this.width = args[0].width;
|
|
this.height = args[0].height;
|
|
}
|
|
} else {
|
|
this.width = args[0];
|
|
this.height = args[1];
|
|
}
|
|
}
|
|
/**
|
|
* Converts the logical size to a physical one.
|
|
* @example
|
|
* ```typescript
|
|
* import { LogicalSize } from '@tauri-apps/api/dpi';
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
*
|
|
* const appWindow = getCurrentWindow();
|
|
* const factor = await appWindow.scaleFactor();
|
|
* const size = new LogicalSize(400, 500);
|
|
* const physical = size.toPhysical(factor);
|
|
* ```
|
|
*
|
|
* @since 2.0.0
|
|
*/
|
|
toPhysical(scaleFactor) {
|
|
return new PhysicalSize(this.width * scaleFactor, this.height * scaleFactor);
|
|
}
|
|
[SERIALIZE_TO_IPC_FN]() {
|
|
return {
|
|
width: this.width,
|
|
height: this.height
|
|
};
|
|
}
|
|
toJSON() {
|
|
return this[SERIALIZE_TO_IPC_FN]();
|
|
}
|
|
};
|
|
var PhysicalSize = class {
|
|
constructor(...args) {
|
|
this.type = "Physical";
|
|
if (args.length === 1) {
|
|
if ("Physical" in args[0]) {
|
|
this.width = args[0].Physical.width;
|
|
this.height = args[0].Physical.height;
|
|
} else {
|
|
this.width = args[0].width;
|
|
this.height = args[0].height;
|
|
}
|
|
} else {
|
|
this.width = args[0];
|
|
this.height = args[1];
|
|
}
|
|
}
|
|
/**
|
|
* Converts the physical size to a logical one.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const appWindow = getCurrentWindow();
|
|
* const factor = await appWindow.scaleFactor();
|
|
* const size = await appWindow.innerSize(); // PhysicalSize
|
|
* const logical = size.toLogical(factor);
|
|
* ```
|
|
*/
|
|
toLogical(scaleFactor) {
|
|
return new LogicalSize(this.width / scaleFactor, this.height / scaleFactor);
|
|
}
|
|
[SERIALIZE_TO_IPC_FN]() {
|
|
return {
|
|
width: this.width,
|
|
height: this.height
|
|
};
|
|
}
|
|
toJSON() {
|
|
return this[SERIALIZE_TO_IPC_FN]();
|
|
}
|
|
};
|
|
var Size = class {
|
|
constructor(size) {
|
|
this.size = size;
|
|
}
|
|
toLogical(scaleFactor) {
|
|
return this.size instanceof LogicalSize ? this.size : this.size.toLogical(scaleFactor);
|
|
}
|
|
toPhysical(scaleFactor) {
|
|
return this.size instanceof PhysicalSize ? this.size : this.size.toPhysical(scaleFactor);
|
|
}
|
|
[SERIALIZE_TO_IPC_FN]() {
|
|
return {
|
|
[`${this.size.type}`]: {
|
|
width: this.size.width,
|
|
height: this.size.height
|
|
}
|
|
};
|
|
}
|
|
toJSON() {
|
|
return this[SERIALIZE_TO_IPC_FN]();
|
|
}
|
|
};
|
|
var LogicalPosition = class {
|
|
constructor(...args) {
|
|
this.type = "Logical";
|
|
if (args.length === 1) {
|
|
if ("Logical" in args[0]) {
|
|
this.x = args[0].Logical.x;
|
|
this.y = args[0].Logical.y;
|
|
} else {
|
|
this.x = args[0].x;
|
|
this.y = args[0].y;
|
|
}
|
|
} else {
|
|
this.x = args[0];
|
|
this.y = args[1];
|
|
}
|
|
}
|
|
/**
|
|
* Converts the logical position to a physical one.
|
|
* @example
|
|
* ```typescript
|
|
* import { LogicalPosition } from '@tauri-apps/api/dpi';
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
*
|
|
* const appWindow = getCurrentWindow();
|
|
* const factor = await appWindow.scaleFactor();
|
|
* const position = new LogicalPosition(400, 500);
|
|
* const physical = position.toPhysical(factor);
|
|
* ```
|
|
*
|
|
* @since 2.0.0
|
|
*/
|
|
toPhysical(scaleFactor) {
|
|
return new PhysicalPosition(this.x * scaleFactor, this.y * scaleFactor);
|
|
}
|
|
[SERIALIZE_TO_IPC_FN]() {
|
|
return {
|
|
x: this.x,
|
|
y: this.y
|
|
};
|
|
}
|
|
toJSON() {
|
|
return this[SERIALIZE_TO_IPC_FN]();
|
|
}
|
|
};
|
|
var PhysicalPosition = class {
|
|
constructor(...args) {
|
|
this.type = "Physical";
|
|
if (args.length === 1) {
|
|
if ("Physical" in args[0]) {
|
|
this.x = args[0].Physical.x;
|
|
this.y = args[0].Physical.y;
|
|
} else {
|
|
this.x = args[0].x;
|
|
this.y = args[0].y;
|
|
}
|
|
} else {
|
|
this.x = args[0];
|
|
this.y = args[1];
|
|
}
|
|
}
|
|
/**
|
|
* Converts the physical position to a logical one.
|
|
* @example
|
|
* ```typescript
|
|
* import { PhysicalPosition } from '@tauri-apps/api/dpi';
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
*
|
|
* const appWindow = getCurrentWindow();
|
|
* const factor = await appWindow.scaleFactor();
|
|
* const position = new PhysicalPosition(400, 500);
|
|
* const physical = position.toLogical(factor);
|
|
* ```
|
|
*
|
|
* @since 2.0.0
|
|
*/
|
|
toLogical(scaleFactor) {
|
|
return new LogicalPosition(this.x / scaleFactor, this.y / scaleFactor);
|
|
}
|
|
[SERIALIZE_TO_IPC_FN]() {
|
|
return {
|
|
x: this.x,
|
|
y: this.y
|
|
};
|
|
}
|
|
toJSON() {
|
|
return this[SERIALIZE_TO_IPC_FN]();
|
|
}
|
|
};
|
|
var Position = class {
|
|
constructor(position) {
|
|
this.position = position;
|
|
}
|
|
toLogical(scaleFactor) {
|
|
return this.position instanceof LogicalPosition ? this.position : this.position.toLogical(scaleFactor);
|
|
}
|
|
toPhysical(scaleFactor) {
|
|
return this.position instanceof PhysicalPosition ? this.position : this.position.toPhysical(scaleFactor);
|
|
}
|
|
[SERIALIZE_TO_IPC_FN]() {
|
|
return {
|
|
[`${this.position.type}`]: {
|
|
x: this.position.x,
|
|
y: this.position.y
|
|
}
|
|
};
|
|
}
|
|
toJSON() {
|
|
return this[SERIALIZE_TO_IPC_FN]();
|
|
}
|
|
};
|
|
|
|
// node_modules/.pnpm/@tauri-apps+api@2.6.0/node_modules/@tauri-apps/api/window.js
|
|
var UserAttentionType;
|
|
(function(UserAttentionType2) {
|
|
UserAttentionType2[UserAttentionType2["Critical"] = 1] = "Critical";
|
|
UserAttentionType2[UserAttentionType2["Informational"] = 2] = "Informational";
|
|
})(UserAttentionType || (UserAttentionType = {}));
|
|
var CloseRequestedEvent = class {
|
|
constructor(event) {
|
|
this._preventDefault = false;
|
|
this.event = event.event;
|
|
this.id = event.id;
|
|
}
|
|
preventDefault() {
|
|
this._preventDefault = true;
|
|
}
|
|
isPreventDefault() {
|
|
return this._preventDefault;
|
|
}
|
|
};
|
|
var ProgressBarStatus;
|
|
(function(ProgressBarStatus2) {
|
|
ProgressBarStatus2["None"] = "none";
|
|
ProgressBarStatus2["Normal"] = "normal";
|
|
ProgressBarStatus2["Indeterminate"] = "indeterminate";
|
|
ProgressBarStatus2["Paused"] = "paused";
|
|
ProgressBarStatus2["Error"] = "error";
|
|
})(ProgressBarStatus || (ProgressBarStatus = {}));
|
|
function getCurrentWindow() {
|
|
return new Window(window.__TAURI_INTERNALS__.metadata.currentWindow.label, {
|
|
// @ts-expect-error `skip` is not defined in the public API but it is handled by the constructor
|
|
skip: true
|
|
});
|
|
}
|
|
async function getAllWindows() {
|
|
return invoke("plugin:window|get_all_windows").then((windows) => windows.map((w) => new Window(w, {
|
|
// @ts-expect-error `skip` is not defined in the public API but it is handled by the constructor
|
|
skip: true
|
|
})));
|
|
}
|
|
var localTauriEvents = ["tauri://created", "tauri://error"];
|
|
var Window = class {
|
|
/**
|
|
* Creates a new Window.
|
|
* @example
|
|
* ```typescript
|
|
* import { Window } from '@tauri-apps/api/window';
|
|
* const appWindow = new Window('my-label');
|
|
* appWindow.once('tauri://created', function () {
|
|
* // window successfully created
|
|
* });
|
|
* appWindow.once('tauri://error', function (e) {
|
|
* // an error happened creating the window
|
|
* });
|
|
* ```
|
|
*
|
|
* @param label The unique window label. Must be alphanumeric: `a-zA-Z-/:_`.
|
|
* @returns The {@link Window} instance to communicate with the window.
|
|
*/
|
|
constructor(label, options = {}) {
|
|
var _a;
|
|
this.label = label;
|
|
this.listeners = /* @__PURE__ */ Object.create(null);
|
|
if (!(options === null || options === void 0 ? void 0 : options.skip)) {
|
|
invoke("plugin:window|create", {
|
|
options: {
|
|
...options,
|
|
parent: typeof options.parent === "string" ? options.parent : (_a = options.parent) === null || _a === void 0 ? void 0 : _a.label,
|
|
label
|
|
}
|
|
}).then(async () => this.emit("tauri://created")).catch(async (e) => this.emit("tauri://error", e));
|
|
}
|
|
}
|
|
/**
|
|
* Gets the Window associated with the given label.
|
|
* @example
|
|
* ```typescript
|
|
* import { Window } from '@tauri-apps/api/window';
|
|
* const mainWindow = Window.getByLabel('main');
|
|
* ```
|
|
*
|
|
* @param label The window label.
|
|
* @returns The Window instance to communicate with the window or null if the window doesn't exist.
|
|
*/
|
|
static async getByLabel(label) {
|
|
var _a;
|
|
return (_a = (await getAllWindows()).find((w) => w.label === label)) !== null && _a !== void 0 ? _a : null;
|
|
}
|
|
/**
|
|
* Get an instance of `Window` for the current window.
|
|
*/
|
|
static getCurrent() {
|
|
return getCurrentWindow();
|
|
}
|
|
/**
|
|
* Gets a list of instances of `Window` for all available windows.
|
|
*/
|
|
static async getAll() {
|
|
return getAllWindows();
|
|
}
|
|
/**
|
|
* Gets the focused window.
|
|
* @example
|
|
* ```typescript
|
|
* import { Window } from '@tauri-apps/api/window';
|
|
* const focusedWindow = Window.getFocusedWindow();
|
|
* ```
|
|
*
|
|
* @returns The Window instance or `undefined` if there is not any focused window.
|
|
*/
|
|
static async getFocusedWindow() {
|
|
for (const w of await getAllWindows()) {
|
|
if (await w.isFocused()) {
|
|
return w;
|
|
}
|
|
}
|
|
return null;
|
|
}
|
|
/**
|
|
* Listen to an emitted event on this window.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const unlisten = await getCurrentWindow().listen<string>('state-changed', (event) => {
|
|
* console.log(`Got error: ${payload}`);
|
|
* });
|
|
*
|
|
* // you need to call unlisten if your handler goes out of scope e.g. the component is unmounted
|
|
* unlisten();
|
|
* ```
|
|
*
|
|
* @param event Event name. Must include only alphanumeric characters, `-`, `/`, `:` and `_`.
|
|
* @param handler Event handler.
|
|
* @returns A promise resolving to a function to unlisten to the event.
|
|
* Note that removing the listener is required if your listener goes out of scope e.g. the component is unmounted.
|
|
*/
|
|
async listen(event, handler) {
|
|
if (this._handleTauriEvent(event, handler)) {
|
|
return () => {
|
|
const listeners = this.listeners[event];
|
|
listeners.splice(listeners.indexOf(handler), 1);
|
|
};
|
|
}
|
|
return listen(event, handler, {
|
|
target: { kind: "Window", label: this.label }
|
|
});
|
|
}
|
|
/**
|
|
* Listen to an emitted event on this window only once.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const unlisten = await getCurrentWindow().once<null>('initialized', (event) => {
|
|
* console.log(`Window initialized!`);
|
|
* });
|
|
*
|
|
* // you need to call unlisten if your handler goes out of scope e.g. the component is unmounted
|
|
* unlisten();
|
|
* ```
|
|
*
|
|
* @param event Event name. Must include only alphanumeric characters, `-`, `/`, `:` and `_`.
|
|
* @param handler Event handler.
|
|
* @returns A promise resolving to a function to unlisten to the event.
|
|
* Note that removing the listener is required if your listener goes out of scope e.g. the component is unmounted.
|
|
*/
|
|
async once(event, handler) {
|
|
if (this._handleTauriEvent(event, handler)) {
|
|
return () => {
|
|
const listeners = this.listeners[event];
|
|
listeners.splice(listeners.indexOf(handler), 1);
|
|
};
|
|
}
|
|
return once(event, handler, {
|
|
target: { kind: "Window", label: this.label }
|
|
});
|
|
}
|
|
/**
|
|
* Emits an event to all {@link EventTarget|targets}.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().emit('window-loaded', { loggedIn: true, token: 'authToken' });
|
|
* ```
|
|
*
|
|
* @param event Event name. Must include only alphanumeric characters, `-`, `/`, `:` and `_`.
|
|
* @param payload Event payload.
|
|
*/
|
|
async emit(event, payload) {
|
|
if (localTauriEvents.includes(event)) {
|
|
for (const handler of this.listeners[event] || []) {
|
|
handler({
|
|
event,
|
|
id: -1,
|
|
payload
|
|
});
|
|
}
|
|
return;
|
|
}
|
|
return emit(event, payload);
|
|
}
|
|
/**
|
|
* Emits an event to all {@link EventTarget|targets} matching the given target.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().emit('main', 'window-loaded', { loggedIn: true, token: 'authToken' });
|
|
* ```
|
|
* @param target Label of the target Window/Webview/WebviewWindow or raw {@link EventTarget} object.
|
|
* @param event Event name. Must include only alphanumeric characters, `-`, `/`, `:` and `_`.
|
|
* @param payload Event payload.
|
|
*/
|
|
async emitTo(target, event, payload) {
|
|
if (localTauriEvents.includes(event)) {
|
|
for (const handler of this.listeners[event] || []) {
|
|
handler({
|
|
event,
|
|
id: -1,
|
|
payload
|
|
});
|
|
}
|
|
return;
|
|
}
|
|
return emitTo(target, event, payload);
|
|
}
|
|
/** @ignore */
|
|
_handleTauriEvent(event, handler) {
|
|
if (localTauriEvents.includes(event)) {
|
|
if (!(event in this.listeners)) {
|
|
this.listeners[event] = [handler];
|
|
} else {
|
|
this.listeners[event].push(handler);
|
|
}
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
// Getters
|
|
/**
|
|
* The scale factor that can be used to map physical pixels to logical pixels.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const factor = await getCurrentWindow().scaleFactor();
|
|
* ```
|
|
*
|
|
* @returns The window's monitor scale factor.
|
|
*/
|
|
async scaleFactor() {
|
|
return invoke("plugin:window|scale_factor", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* The position of the top-left hand corner of the window's client area relative to the top-left hand corner of the desktop.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const position = await getCurrentWindow().innerPosition();
|
|
* ```
|
|
*
|
|
* @returns The window's inner position.
|
|
*/
|
|
async innerPosition() {
|
|
return invoke("plugin:window|inner_position", {
|
|
label: this.label
|
|
}).then((p) => new PhysicalPosition(p));
|
|
}
|
|
/**
|
|
* The position of the top-left hand corner of the window relative to the top-left hand corner of the desktop.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const position = await getCurrentWindow().outerPosition();
|
|
* ```
|
|
*
|
|
* @returns The window's outer position.
|
|
*/
|
|
async outerPosition() {
|
|
return invoke("plugin:window|outer_position", {
|
|
label: this.label
|
|
}).then((p) => new PhysicalPosition(p));
|
|
}
|
|
/**
|
|
* The physical size of the window's client area.
|
|
* The client area is the content of the window, excluding the title bar and borders.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const size = await getCurrentWindow().innerSize();
|
|
* ```
|
|
*
|
|
* @returns The window's inner size.
|
|
*/
|
|
async innerSize() {
|
|
return invoke("plugin:window|inner_size", {
|
|
label: this.label
|
|
}).then((s) => new PhysicalSize(s));
|
|
}
|
|
/**
|
|
* The physical size of the entire window.
|
|
* These dimensions include the title bar and borders. If you don't want that (and you usually don't), use inner_size instead.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const size = await getCurrentWindow().outerSize();
|
|
* ```
|
|
*
|
|
* @returns The window's outer size.
|
|
*/
|
|
async outerSize() {
|
|
return invoke("plugin:window|outer_size", {
|
|
label: this.label
|
|
}).then((s) => new PhysicalSize(s));
|
|
}
|
|
/**
|
|
* Gets the window's current fullscreen state.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const fullscreen = await getCurrentWindow().isFullscreen();
|
|
* ```
|
|
*
|
|
* @returns Whether the window is in fullscreen mode or not.
|
|
*/
|
|
async isFullscreen() {
|
|
return invoke("plugin:window|is_fullscreen", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Gets the window's current minimized state.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const minimized = await getCurrentWindow().isMinimized();
|
|
* ```
|
|
*/
|
|
async isMinimized() {
|
|
return invoke("plugin:window|is_minimized", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Gets the window's current maximized state.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const maximized = await getCurrentWindow().isMaximized();
|
|
* ```
|
|
*
|
|
* @returns Whether the window is maximized or not.
|
|
*/
|
|
async isMaximized() {
|
|
return invoke("plugin:window|is_maximized", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Gets the window's current focus state.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const focused = await getCurrentWindow().isFocused();
|
|
* ```
|
|
*
|
|
* @returns Whether the window is focused or not.
|
|
*/
|
|
async isFocused() {
|
|
return invoke("plugin:window|is_focused", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Gets the window's current decorated state.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const decorated = await getCurrentWindow().isDecorated();
|
|
* ```
|
|
*
|
|
* @returns Whether the window is decorated or not.
|
|
*/
|
|
async isDecorated() {
|
|
return invoke("plugin:window|is_decorated", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Gets the window's current resizable state.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const resizable = await getCurrentWindow().isResizable();
|
|
* ```
|
|
*
|
|
* @returns Whether the window is resizable or not.
|
|
*/
|
|
async isResizable() {
|
|
return invoke("plugin:window|is_resizable", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Gets the window's native maximize button state.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **Linux / iOS / Android:** Unsupported.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const maximizable = await getCurrentWindow().isMaximizable();
|
|
* ```
|
|
*
|
|
* @returns Whether the window's native maximize button is enabled or not.
|
|
*/
|
|
async isMaximizable() {
|
|
return invoke("plugin:window|is_maximizable", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Gets the window's native minimize button state.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **Linux / iOS / Android:** Unsupported.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const minimizable = await getCurrentWindow().isMinimizable();
|
|
* ```
|
|
*
|
|
* @returns Whether the window's native minimize button is enabled or not.
|
|
*/
|
|
async isMinimizable() {
|
|
return invoke("plugin:window|is_minimizable", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Gets the window's native close button state.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **iOS / Android:** Unsupported.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const closable = await getCurrentWindow().isClosable();
|
|
* ```
|
|
*
|
|
* @returns Whether the window's native close button is enabled or not.
|
|
*/
|
|
async isClosable() {
|
|
return invoke("plugin:window|is_closable", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Gets the window's current visible state.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const visible = await getCurrentWindow().isVisible();
|
|
* ```
|
|
*
|
|
* @returns Whether the window is visible or not.
|
|
*/
|
|
async isVisible() {
|
|
return invoke("plugin:window|is_visible", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Gets the window's current title.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const title = await getCurrentWindow().title();
|
|
* ```
|
|
*/
|
|
async title() {
|
|
return invoke("plugin:window|title", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Gets the window's current theme.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **macOS:** Theme was introduced on macOS 10.14. Returns `light` on macOS 10.13 and below.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const theme = await getCurrentWindow().theme();
|
|
* ```
|
|
*
|
|
* @returns The window theme.
|
|
*/
|
|
async theme() {
|
|
return invoke("plugin:window|theme", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Whether the window is configured to be always on top of other windows or not.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* const alwaysOnTop = await getCurrentWindow().isAlwaysOnTop();
|
|
* ```
|
|
*
|
|
* @returns Whether the window is visible or not.
|
|
*/
|
|
async isAlwaysOnTop() {
|
|
return invoke("plugin:window|is_always_on_top", {
|
|
label: this.label
|
|
});
|
|
}
|
|
// Setters
|
|
/**
|
|
* Centers the window.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().center();
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async center() {
|
|
return invoke("plugin:window|center", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Requests user attention to the window, this has no effect if the application
|
|
* is already focused. How requesting for user attention manifests is platform dependent,
|
|
* see `UserAttentionType` for details.
|
|
*
|
|
* Providing `null` will unset the request for user attention. Unsetting the request for
|
|
* user attention might not be done automatically by the WM when the window receives input.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **macOS:** `null` has no effect.
|
|
* - **Linux:** Urgency levels have the same effect.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().requestUserAttention();
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async requestUserAttention(requestType) {
|
|
let requestType_ = null;
|
|
if (requestType) {
|
|
if (requestType === UserAttentionType.Critical) {
|
|
requestType_ = { type: "Critical" };
|
|
} else {
|
|
requestType_ = { type: "Informational" };
|
|
}
|
|
}
|
|
return invoke("plugin:window|request_user_attention", {
|
|
label: this.label,
|
|
value: requestType_
|
|
});
|
|
}
|
|
/**
|
|
* Updates the window resizable flag.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setResizable(false);
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setResizable(resizable) {
|
|
return invoke("plugin:window|set_resizable", {
|
|
label: this.label,
|
|
value: resizable
|
|
});
|
|
}
|
|
/**
|
|
* Enable or disable the window.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setEnabled(false);
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*
|
|
* @since 2.0.0
|
|
*/
|
|
async setEnabled(enabled) {
|
|
return invoke("plugin:window|set_enabled", {
|
|
label: this.label,
|
|
value: enabled
|
|
});
|
|
}
|
|
/**
|
|
* Whether the window is enabled or disabled.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setEnabled(false);
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*
|
|
* @since 2.0.0
|
|
*/
|
|
async isEnabled() {
|
|
return invoke("plugin:window|is_enabled", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Sets whether the window's native maximize button is enabled or not.
|
|
* If resizable is set to false, this setting is ignored.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **macOS:** Disables the "zoom" button in the window titlebar, which is also used to enter fullscreen mode.
|
|
* - **Linux / iOS / Android:** Unsupported.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setMaximizable(false);
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setMaximizable(maximizable) {
|
|
return invoke("plugin:window|set_maximizable", {
|
|
label: this.label,
|
|
value: maximizable
|
|
});
|
|
}
|
|
/**
|
|
* Sets whether the window's native minimize button is enabled or not.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **Linux / iOS / Android:** Unsupported.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setMinimizable(false);
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setMinimizable(minimizable) {
|
|
return invoke("plugin:window|set_minimizable", {
|
|
label: this.label,
|
|
value: minimizable
|
|
});
|
|
}
|
|
/**
|
|
* Sets whether the window's native close button is enabled or not.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **Linux:** GTK+ will do its best to convince the window manager not to show a close button. Depending on the system, this function may not have any effect when called on a window that is already visible
|
|
* - **iOS / Android:** Unsupported.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setClosable(false);
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setClosable(closable) {
|
|
return invoke("plugin:window|set_closable", {
|
|
label: this.label,
|
|
value: closable
|
|
});
|
|
}
|
|
/**
|
|
* Sets the window title.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setTitle('Tauri');
|
|
* ```
|
|
*
|
|
* @param title The new title
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setTitle(title) {
|
|
return invoke("plugin:window|set_title", {
|
|
label: this.label,
|
|
value: title
|
|
});
|
|
}
|
|
/**
|
|
* Maximizes the window.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().maximize();
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async maximize() {
|
|
return invoke("plugin:window|maximize", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Unmaximizes the window.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().unmaximize();
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async unmaximize() {
|
|
return invoke("plugin:window|unmaximize", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Toggles the window maximized state.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().toggleMaximize();
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async toggleMaximize() {
|
|
return invoke("plugin:window|toggle_maximize", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Minimizes the window.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().minimize();
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async minimize() {
|
|
return invoke("plugin:window|minimize", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Unminimizes the window.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().unminimize();
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async unminimize() {
|
|
return invoke("plugin:window|unminimize", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Sets the window visibility to true.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().show();
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async show() {
|
|
return invoke("plugin:window|show", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Sets the window visibility to false.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().hide();
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async hide() {
|
|
return invoke("plugin:window|hide", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Closes the window.
|
|
*
|
|
* Note this emits a closeRequested event so you can intercept it. To force window close, use {@link Window.destroy}.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().close();
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async close() {
|
|
return invoke("plugin:window|close", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Destroys the window. Behaves like {@link Window.close} but forces the window close instead of emitting a closeRequested event.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().destroy();
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async destroy() {
|
|
return invoke("plugin:window|destroy", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Whether the window should have borders and bars.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setDecorations(false);
|
|
* ```
|
|
*
|
|
* @param decorations Whether the window should have borders and bars.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setDecorations(decorations) {
|
|
return invoke("plugin:window|set_decorations", {
|
|
label: this.label,
|
|
value: decorations
|
|
});
|
|
}
|
|
/**
|
|
* Whether or not the window should have shadow.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **Windows:**
|
|
* - `false` has no effect on decorated window, shadows are always ON.
|
|
* - `true` will make undecorated window have a 1px white border,
|
|
* and on Windows 11, it will have a rounded corners.
|
|
* - **Linux:** Unsupported.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setShadow(false);
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setShadow(enable) {
|
|
return invoke("plugin:window|set_shadow", {
|
|
label: this.label,
|
|
value: enable
|
|
});
|
|
}
|
|
/**
|
|
* Set window effects.
|
|
*/
|
|
async setEffects(effects) {
|
|
return invoke("plugin:window|set_effects", {
|
|
label: this.label,
|
|
value: effects
|
|
});
|
|
}
|
|
/**
|
|
* Clear any applied effects if possible.
|
|
*/
|
|
async clearEffects() {
|
|
return invoke("plugin:window|set_effects", {
|
|
label: this.label,
|
|
value: null
|
|
});
|
|
}
|
|
/**
|
|
* Whether the window should always be on top of other windows.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setAlwaysOnTop(true);
|
|
* ```
|
|
*
|
|
* @param alwaysOnTop Whether the window should always be on top of other windows or not.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setAlwaysOnTop(alwaysOnTop) {
|
|
return invoke("plugin:window|set_always_on_top", {
|
|
label: this.label,
|
|
value: alwaysOnTop
|
|
});
|
|
}
|
|
/**
|
|
* Whether the window should always be below other windows.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setAlwaysOnBottom(true);
|
|
* ```
|
|
*
|
|
* @param alwaysOnBottom Whether the window should always be below other windows or not.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setAlwaysOnBottom(alwaysOnBottom) {
|
|
return invoke("plugin:window|set_always_on_bottom", {
|
|
label: this.label,
|
|
value: alwaysOnBottom
|
|
});
|
|
}
|
|
/**
|
|
* Prevents the window contents from being captured by other apps.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setContentProtected(true);
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setContentProtected(protected_) {
|
|
return invoke("plugin:window|set_content_protected", {
|
|
label: this.label,
|
|
value: protected_
|
|
});
|
|
}
|
|
/**
|
|
* Resizes the window with a new inner size.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow, LogicalSize } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setSize(new LogicalSize(600, 500));
|
|
* ```
|
|
*
|
|
* @param size The logical or physical inner size.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setSize(size) {
|
|
return invoke("plugin:window|set_size", {
|
|
label: this.label,
|
|
value: size instanceof Size ? size : new Size(size)
|
|
});
|
|
}
|
|
/**
|
|
* Sets the window minimum inner size. If the `size` argument is not provided, the constraint is unset.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow, PhysicalSize } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setMinSize(new PhysicalSize(600, 500));
|
|
* ```
|
|
*
|
|
* @param size The logical or physical inner size, or `null` to unset the constraint.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setMinSize(size) {
|
|
return invoke("plugin:window|set_min_size", {
|
|
label: this.label,
|
|
value: size instanceof Size ? size : size ? new Size(size) : null
|
|
});
|
|
}
|
|
/**
|
|
* Sets the window maximum inner size. If the `size` argument is undefined, the constraint is unset.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow, LogicalSize } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setMaxSize(new LogicalSize(600, 500));
|
|
* ```
|
|
*
|
|
* @param size The logical or physical inner size, or `null` to unset the constraint.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setMaxSize(size) {
|
|
return invoke("plugin:window|set_max_size", {
|
|
label: this.label,
|
|
value: size instanceof Size ? size : size ? new Size(size) : null
|
|
});
|
|
}
|
|
/**
|
|
* Sets the window inner size constraints.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setSizeConstraints({ minWidth: 300 });
|
|
* ```
|
|
*
|
|
* @param constraints The logical or physical inner size, or `null` to unset the constraint.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setSizeConstraints(constraints) {
|
|
function logical(pixel) {
|
|
return pixel ? { Logical: pixel } : null;
|
|
}
|
|
return invoke("plugin:window|set_size_constraints", {
|
|
label: this.label,
|
|
value: {
|
|
minWidth: logical(constraints === null || constraints === void 0 ? void 0 : constraints.minWidth),
|
|
minHeight: logical(constraints === null || constraints === void 0 ? void 0 : constraints.minHeight),
|
|
maxWidth: logical(constraints === null || constraints === void 0 ? void 0 : constraints.maxWidth),
|
|
maxHeight: logical(constraints === null || constraints === void 0 ? void 0 : constraints.maxHeight)
|
|
}
|
|
});
|
|
}
|
|
/**
|
|
* Sets the window outer position.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow, LogicalPosition } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setPosition(new LogicalPosition(600, 500));
|
|
* ```
|
|
*
|
|
* @param position The new position, in logical or physical pixels.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setPosition(position) {
|
|
return invoke("plugin:window|set_position", {
|
|
label: this.label,
|
|
value: position instanceof Position ? position : new Position(position)
|
|
});
|
|
}
|
|
/**
|
|
* Sets the window fullscreen state.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setFullscreen(true);
|
|
* ```
|
|
*
|
|
* @param fullscreen Whether the window should go to fullscreen or not.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setFullscreen(fullscreen) {
|
|
return invoke("plugin:window|set_fullscreen", {
|
|
label: this.label,
|
|
value: fullscreen
|
|
});
|
|
}
|
|
/**
|
|
* Bring the window to front and focus.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setFocus();
|
|
* ```
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setFocus() {
|
|
return invoke("plugin:window|set_focus", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Sets the window icon.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setIcon('/tauri/awesome.png');
|
|
* ```
|
|
*
|
|
* Note that you may need the `image-ico` or `image-png` Cargo features to use this API.
|
|
* To enable it, change your Cargo.toml file:
|
|
* ```toml
|
|
* [dependencies]
|
|
* tauri = { version = "...", features = ["...", "image-png"] }
|
|
* ```
|
|
*
|
|
* @param icon Icon bytes or path to the icon file.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setIcon(icon) {
|
|
return invoke("plugin:window|set_icon", {
|
|
label: this.label,
|
|
value: transformImage(icon)
|
|
});
|
|
}
|
|
/**
|
|
* Whether the window icon should be hidden from the taskbar or not.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **macOS:** Unsupported.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setSkipTaskbar(true);
|
|
* ```
|
|
*
|
|
* @param skip true to hide window icon, false to show it.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setSkipTaskbar(skip) {
|
|
return invoke("plugin:window|set_skip_taskbar", {
|
|
label: this.label,
|
|
value: skip
|
|
});
|
|
}
|
|
/**
|
|
* Grabs the cursor, preventing it from leaving the window.
|
|
*
|
|
* There's no guarantee that the cursor will be hidden. You should
|
|
* hide it by yourself if you want so.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **Linux:** Unsupported.
|
|
* - **macOS:** This locks the cursor in a fixed location, which looks visually awkward.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setCursorGrab(true);
|
|
* ```
|
|
*
|
|
* @param grab `true` to grab the cursor icon, `false` to release it.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setCursorGrab(grab) {
|
|
return invoke("plugin:window|set_cursor_grab", {
|
|
label: this.label,
|
|
value: grab
|
|
});
|
|
}
|
|
/**
|
|
* Modifies the cursor's visibility.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **Windows:** The cursor is only hidden within the confines of the window.
|
|
* - **macOS:** The cursor is hidden as long as the window has input focus, even if the cursor is
|
|
* outside of the window.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setCursorVisible(false);
|
|
* ```
|
|
*
|
|
* @param visible If `false`, this will hide the cursor. If `true`, this will show the cursor.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setCursorVisible(visible) {
|
|
return invoke("plugin:window|set_cursor_visible", {
|
|
label: this.label,
|
|
value: visible
|
|
});
|
|
}
|
|
/**
|
|
* Modifies the cursor icon of the window.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setCursorIcon('help');
|
|
* ```
|
|
*
|
|
* @param icon The new cursor icon.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setCursorIcon(icon) {
|
|
return invoke("plugin:window|set_cursor_icon", {
|
|
label: this.label,
|
|
value: icon
|
|
});
|
|
}
|
|
/**
|
|
* Sets the window background color.
|
|
*
|
|
* #### Platform-specific:
|
|
*
|
|
* - **Windows:** alpha channel is ignored.
|
|
* - **iOS / Android:** Unsupported.
|
|
*
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*
|
|
* @since 2.1.0
|
|
*/
|
|
async setBackgroundColor(color) {
|
|
return invoke("plugin:window|set_background_color", { color });
|
|
}
|
|
/**
|
|
* Changes the position of the cursor in window coordinates.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow, LogicalPosition } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setCursorPosition(new LogicalPosition(600, 300));
|
|
* ```
|
|
*
|
|
* @param position The new cursor position.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setCursorPosition(position) {
|
|
return invoke("plugin:window|set_cursor_position", {
|
|
label: this.label,
|
|
value: position instanceof Position ? position : new Position(position)
|
|
});
|
|
}
|
|
/**
|
|
* Changes the cursor events behavior.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setIgnoreCursorEvents(true);
|
|
* ```
|
|
*
|
|
* @param ignore `true` to ignore the cursor events; `false` to process them as usual.
|
|
* @returns A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setIgnoreCursorEvents(ignore) {
|
|
return invoke("plugin:window|set_ignore_cursor_events", {
|
|
label: this.label,
|
|
value: ignore
|
|
});
|
|
}
|
|
/**
|
|
* Starts dragging the window.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().startDragging();
|
|
* ```
|
|
*
|
|
* @return A promise indicating the success or failure of the operation.
|
|
*/
|
|
async startDragging() {
|
|
return invoke("plugin:window|start_dragging", {
|
|
label: this.label
|
|
});
|
|
}
|
|
/**
|
|
* Starts resize-dragging the window.
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().startResizeDragging();
|
|
* ```
|
|
*
|
|
* @return A promise indicating the success or failure of the operation.
|
|
*/
|
|
async startResizeDragging(direction) {
|
|
return invoke("plugin:window|start_resize_dragging", {
|
|
label: this.label,
|
|
value: direction
|
|
});
|
|
}
|
|
/**
|
|
* Sets the badge count. It is app wide and not specific to this window.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **Windows**: Unsupported. Use @{linkcode Window.setOverlayIcon} instead.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setBadgeCount(5);
|
|
* ```
|
|
*
|
|
* @param count The badge count. Use `undefined` to remove the badge.
|
|
* @return A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setBadgeCount(count) {
|
|
return invoke("plugin:window|set_badge_count", {
|
|
label: this.label,
|
|
value: count
|
|
});
|
|
}
|
|
/**
|
|
* Sets the badge cont **macOS only**.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setBadgeLabel("Hello");
|
|
* ```
|
|
*
|
|
* @param label The badge label. Use `undefined` to remove the badge.
|
|
* @return A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setBadgeLabel(label) {
|
|
return invoke("plugin:window|set_badge_label", {
|
|
label: this.label,
|
|
value: label
|
|
});
|
|
}
|
|
/**
|
|
* Sets the overlay icon. **Windows only**
|
|
* The overlay icon can be set for every window.
|
|
*
|
|
*
|
|
* Note that you may need the `image-ico` or `image-png` Cargo features to use this API.
|
|
* To enable it, change your Cargo.toml file:
|
|
*
|
|
* ```toml
|
|
* [dependencies]
|
|
* tauri = { version = "...", features = ["...", "image-png"] }
|
|
* ```
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setOverlayIcon("/tauri/awesome.png");
|
|
* ```
|
|
*
|
|
* @param icon Icon bytes or path to the icon file. Use `undefined` to remove the overlay icon.
|
|
* @return A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setOverlayIcon(icon) {
|
|
return invoke("plugin:window|set_overlay_icon", {
|
|
label: this.label,
|
|
value: icon ? transformImage(icon) : void 0
|
|
});
|
|
}
|
|
/**
|
|
* Sets the taskbar progress state.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **Linux / macOS**: Progress bar is app-wide and not specific to this window.
|
|
* - **Linux**: Only supported desktop environments with `libunity` (e.g. GNOME).
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow, ProgressBarStatus } from '@tauri-apps/api/window';
|
|
* await getCurrentWindow().setProgressBar({
|
|
* status: ProgressBarStatus.Normal,
|
|
* progress: 50,
|
|
* });
|
|
* ```
|
|
*
|
|
* @return A promise indicating the success or failure of the operation.
|
|
*/
|
|
async setProgressBar(state) {
|
|
return invoke("plugin:window|set_progress_bar", {
|
|
label: this.label,
|
|
value: state
|
|
});
|
|
}
|
|
/**
|
|
* Sets whether the window should be visible on all workspaces or virtual desktops.
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **Windows / iOS / Android:** Unsupported.
|
|
*
|
|
* @since 2.0.0
|
|
*/
|
|
async setVisibleOnAllWorkspaces(visible) {
|
|
return invoke("plugin:window|set_visible_on_all_workspaces", {
|
|
label: this.label,
|
|
value: visible
|
|
});
|
|
}
|
|
/**
|
|
* Sets the title bar style. **macOS only**.
|
|
*
|
|
* @since 2.0.0
|
|
*/
|
|
async setTitleBarStyle(style) {
|
|
return invoke("plugin:window|set_title_bar_style", {
|
|
label: this.label,
|
|
value: style
|
|
});
|
|
}
|
|
/**
|
|
* Set window theme, pass in `null` or `undefined` to follow system theme
|
|
*
|
|
* #### Platform-specific
|
|
*
|
|
* - **Linux / macOS**: Theme is app-wide and not specific to this window.
|
|
* - **iOS / Android:** Unsupported.
|
|
*
|
|
* @since 2.0.0
|
|
*/
|
|
async setTheme(theme) {
|
|
return invoke("plugin:window|set_theme", {
|
|
label: this.label,
|
|
value: theme
|
|
});
|
|
}
|
|
// Listeners
|
|
/**
|
|
* Listen to window resize.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from "@tauri-apps/api/window";
|
|
* const unlisten = await getCurrentWindow().onResized(({ payload: size }) => {
|
|
* console.log('Window resized', size);
|
|
* });
|
|
*
|
|
* // you need to call unlisten if your handler goes out of scope e.g. the component is unmounted
|
|
* unlisten();
|
|
* ```
|
|
*
|
|
* @returns A promise resolving to a function to unlisten to the event.
|
|
* Note that removing the listener is required if your listener goes out of scope e.g. the component is unmounted.
|
|
*/
|
|
async onResized(handler) {
|
|
return this.listen(TauriEvent.WINDOW_RESIZED, (e) => {
|
|
e.payload = new PhysicalSize(e.payload);
|
|
handler(e);
|
|
});
|
|
}
|
|
/**
|
|
* Listen to window move.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from "@tauri-apps/api/window";
|
|
* const unlisten = await getCurrentWindow().onMoved(({ payload: position }) => {
|
|
* console.log('Window moved', position);
|
|
* });
|
|
*
|
|
* // you need to call unlisten if your handler goes out of scope e.g. the component is unmounted
|
|
* unlisten();
|
|
* ```
|
|
*
|
|
* @returns A promise resolving to a function to unlisten to the event.
|
|
* Note that removing the listener is required if your listener goes out of scope e.g. the component is unmounted.
|
|
*/
|
|
async onMoved(handler) {
|
|
return this.listen(TauriEvent.WINDOW_MOVED, (e) => {
|
|
e.payload = new PhysicalPosition(e.payload);
|
|
handler(e);
|
|
});
|
|
}
|
|
/**
|
|
* Listen to window close requested. Emitted when the user requests to closes the window.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from "@tauri-apps/api/window";
|
|
* import { confirm } from '@tauri-apps/api/dialog';
|
|
* const unlisten = await getCurrentWindow().onCloseRequested(async (event) => {
|
|
* const confirmed = await confirm('Are you sure?');
|
|
* if (!confirmed) {
|
|
* // user did not confirm closing the window; let's prevent it
|
|
* event.preventDefault();
|
|
* }
|
|
* });
|
|
*
|
|
* // you need to call unlisten if your handler goes out of scope e.g. the component is unmounted
|
|
* unlisten();
|
|
* ```
|
|
*
|
|
* @returns A promise resolving to a function to unlisten to the event.
|
|
* Note that removing the listener is required if your listener goes out of scope e.g. the component is unmounted.
|
|
*/
|
|
async onCloseRequested(handler) {
|
|
return this.listen(TauriEvent.WINDOW_CLOSE_REQUESTED, async (event) => {
|
|
const evt = new CloseRequestedEvent(event);
|
|
await handler(evt);
|
|
if (!evt.isPreventDefault()) {
|
|
await this.destroy();
|
|
}
|
|
});
|
|
}
|
|
/**
|
|
* Listen to a file drop event.
|
|
* The listener is triggered when the user hovers the selected files on the webview,
|
|
* drops the files or cancels the operation.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from "@tauri-apps/api/webview";
|
|
* const unlisten = await getCurrentWindow().onDragDropEvent((event) => {
|
|
* if (event.payload.type === 'over') {
|
|
* console.log('User hovering', event.payload.position);
|
|
* } else if (event.payload.type === 'drop') {
|
|
* console.log('User dropped', event.payload.paths);
|
|
* } else {
|
|
* console.log('File drop cancelled');
|
|
* }
|
|
* });
|
|
*
|
|
* // you need to call unlisten if your handler goes out of scope e.g. the component is unmounted
|
|
* unlisten();
|
|
* ```
|
|
*
|
|
* @returns A promise resolving to a function to unlisten to the event.
|
|
* Note that removing the listener is required if your listener goes out of scope e.g. the component is unmounted.
|
|
*/
|
|
async onDragDropEvent(handler) {
|
|
const unlistenDrag = await this.listen(TauriEvent.DRAG_ENTER, (event) => {
|
|
handler({
|
|
...event,
|
|
payload: {
|
|
type: "enter",
|
|
paths: event.payload.paths,
|
|
position: new PhysicalPosition(event.payload.position)
|
|
}
|
|
});
|
|
});
|
|
const unlistenDragOver = await this.listen(TauriEvent.DRAG_OVER, (event) => {
|
|
handler({
|
|
...event,
|
|
payload: {
|
|
type: "over",
|
|
position: new PhysicalPosition(event.payload.position)
|
|
}
|
|
});
|
|
});
|
|
const unlistenDrop = await this.listen(TauriEvent.DRAG_DROP, (event) => {
|
|
handler({
|
|
...event,
|
|
payload: {
|
|
type: "drop",
|
|
paths: event.payload.paths,
|
|
position: new PhysicalPosition(event.payload.position)
|
|
}
|
|
});
|
|
});
|
|
const unlistenCancel = await this.listen(TauriEvent.DRAG_LEAVE, (event) => {
|
|
handler({ ...event, payload: { type: "leave" } });
|
|
});
|
|
return () => {
|
|
unlistenDrag();
|
|
unlistenDrop();
|
|
unlistenDragOver();
|
|
unlistenCancel();
|
|
};
|
|
}
|
|
/**
|
|
* Listen to window focus change.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from "@tauri-apps/api/window";
|
|
* const unlisten = await getCurrentWindow().onFocusChanged(({ payload: focused }) => {
|
|
* console.log('Focus changed, window is focused? ' + focused);
|
|
* });
|
|
*
|
|
* // you need to call unlisten if your handler goes out of scope e.g. the component is unmounted
|
|
* unlisten();
|
|
* ```
|
|
*
|
|
* @returns A promise resolving to a function to unlisten to the event.
|
|
* Note that removing the listener is required if your listener goes out of scope e.g. the component is unmounted.
|
|
*/
|
|
async onFocusChanged(handler) {
|
|
const unlistenFocus = await this.listen(TauriEvent.WINDOW_FOCUS, (event) => {
|
|
handler({ ...event, payload: true });
|
|
});
|
|
const unlistenBlur = await this.listen(TauriEvent.WINDOW_BLUR, (event) => {
|
|
handler({ ...event, payload: false });
|
|
});
|
|
return () => {
|
|
unlistenFocus();
|
|
unlistenBlur();
|
|
};
|
|
}
|
|
/**
|
|
* Listen to window scale change. Emitted when the window's scale factor has changed.
|
|
* The following user actions can cause DPI changes:
|
|
* - Changing the display's resolution.
|
|
* - Changing the display's scale factor (e.g. in Control Panel on Windows).
|
|
* - Moving the window to a display with a different scale factor.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from "@tauri-apps/api/window";
|
|
* const unlisten = await getCurrentWindow().onScaleChanged(({ payload }) => {
|
|
* console.log('Scale changed', payload.scaleFactor, payload.size);
|
|
* });
|
|
*
|
|
* // you need to call unlisten if your handler goes out of scope e.g. the component is unmounted
|
|
* unlisten();
|
|
* ```
|
|
*
|
|
* @returns A promise resolving to a function to unlisten to the event.
|
|
* Note that removing the listener is required if your listener goes out of scope e.g. the component is unmounted.
|
|
*/
|
|
async onScaleChanged(handler) {
|
|
return this.listen(TauriEvent.WINDOW_SCALE_FACTOR_CHANGED, handler);
|
|
}
|
|
/**
|
|
* Listen to the system theme change.
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* import { getCurrentWindow } from "@tauri-apps/api/window";
|
|
* const unlisten = await getCurrentWindow().onThemeChanged(({ payload: theme }) => {
|
|
* console.log('New theme: ' + theme);
|
|
* });
|
|
*
|
|
* // you need to call unlisten if your handler goes out of scope e.g. the component is unmounted
|
|
* unlisten();
|
|
* ```
|
|
*
|
|
* @returns A promise resolving to a function to unlisten to the event.
|
|
* Note that removing the listener is required if your listener goes out of scope e.g. the component is unmounted.
|
|
*/
|
|
async onThemeChanged(handler) {
|
|
return this.listen(TauriEvent.WINDOW_THEME_CHANGED, handler);
|
|
}
|
|
};
|
|
var BackgroundThrottlingPolicy;
|
|
(function(BackgroundThrottlingPolicy2) {
|
|
BackgroundThrottlingPolicy2["Disabled"] = "disabled";
|
|
BackgroundThrottlingPolicy2["Throttle"] = "throttle";
|
|
BackgroundThrottlingPolicy2["Suspend"] = "suspend";
|
|
})(BackgroundThrottlingPolicy || (BackgroundThrottlingPolicy = {}));
|
|
var Effect;
|
|
(function(Effect2) {
|
|
Effect2["AppearanceBased"] = "appearanceBased";
|
|
Effect2["Light"] = "light";
|
|
Effect2["Dark"] = "dark";
|
|
Effect2["MediumLight"] = "mediumLight";
|
|
Effect2["UltraDark"] = "ultraDark";
|
|
Effect2["Titlebar"] = "titlebar";
|
|
Effect2["Selection"] = "selection";
|
|
Effect2["Menu"] = "menu";
|
|
Effect2["Popover"] = "popover";
|
|
Effect2["Sidebar"] = "sidebar";
|
|
Effect2["HeaderView"] = "headerView";
|
|
Effect2["Sheet"] = "sheet";
|
|
Effect2["WindowBackground"] = "windowBackground";
|
|
Effect2["HudWindow"] = "hudWindow";
|
|
Effect2["FullScreenUI"] = "fullScreenUI";
|
|
Effect2["Tooltip"] = "tooltip";
|
|
Effect2["ContentBackground"] = "contentBackground";
|
|
Effect2["UnderWindowBackground"] = "underWindowBackground";
|
|
Effect2["UnderPageBackground"] = "underPageBackground";
|
|
Effect2["Mica"] = "mica";
|
|
Effect2["Blur"] = "blur";
|
|
Effect2["Acrylic"] = "acrylic";
|
|
Effect2["Tabbed"] = "tabbed";
|
|
Effect2["TabbedDark"] = "tabbedDark";
|
|
Effect2["TabbedLight"] = "tabbedLight";
|
|
})(Effect || (Effect = {}));
|
|
var EffectState;
|
|
(function(EffectState2) {
|
|
EffectState2["FollowsWindowActiveState"] = "followsWindowActiveState";
|
|
EffectState2["Active"] = "active";
|
|
EffectState2["Inactive"] = "inactive";
|
|
})(EffectState || (EffectState = {}));
|
|
function mapMonitor(m) {
|
|
return m === null ? null : {
|
|
name: m.name,
|
|
scaleFactor: m.scaleFactor,
|
|
position: new PhysicalPosition(m.position),
|
|
size: new PhysicalSize(m.size),
|
|
workArea: {
|
|
position: new PhysicalPosition(m.workArea.position),
|
|
size: new PhysicalSize(m.workArea.size)
|
|
}
|
|
};
|
|
}
|
|
async function currentMonitor() {
|
|
return invoke("plugin:window|current_monitor").then(mapMonitor);
|
|
}
|
|
async function primaryMonitor() {
|
|
return invoke("plugin:window|primary_monitor").then(mapMonitor);
|
|
}
|
|
async function monitorFromPoint(x, y) {
|
|
return invoke("plugin:window|monitor_from_point", {
|
|
x,
|
|
y
|
|
}).then(mapMonitor);
|
|
}
|
|
async function availableMonitors() {
|
|
return invoke("plugin:window|available_monitors").then((ms) => ms.map(mapMonitor));
|
|
}
|
|
async function cursorPosition() {
|
|
return invoke("plugin:window|cursor_position").then((v) => new PhysicalPosition(v));
|
|
}
|
|
export {
|
|
CloseRequestedEvent,
|
|
Effect,
|
|
EffectState,
|
|
LogicalPosition,
|
|
LogicalSize,
|
|
PhysicalPosition,
|
|
PhysicalSize,
|
|
ProgressBarStatus,
|
|
UserAttentionType,
|
|
Window,
|
|
availableMonitors,
|
|
currentMonitor,
|
|
cursorPosition,
|
|
getAllWindows,
|
|
getCurrentWindow,
|
|
monitorFromPoint,
|
|
primaryMonitor
|
|
};
|
|
//# sourceMappingURL=@tauri-apps_api_window.js.map
|