窗口

窗口提供管理窗口的一些基础能力，包括对当前窗口的创建、销毁、各属性设置，以及对各窗口间的管理调度。

该模块提供以下窗口相关的常用功能：

Window：当前窗口实例，窗口管理器管理的基本单元。
WindowStage：窗口管理器。管理各个基本窗口单元。

说明：

本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import window from '@ohos.window';

WindowType⁷⁺

窗口类型枚举。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	值	说明
TYPE_APP	0	表示应用子窗口。此接口仅可在FA模型下使用。
TYPE_SYSTEM_ALERT	1	表示系统告警窗口。此接口仅可在Stage模型下使用。

AvoidAreaType⁷⁺

窗口内容需要规避区域的类型枚举。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	值	说明
TYPE_SYSTEM	0	表示系统默认区域。
TYPE_CUTOUT	1	表示刘海屏区域。

WindowMode⁷⁺

窗口模式枚举。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	值	说明
UNDEFINED	1	表示APP未定义窗口模式。
FULLSCREEN	2	表示APP全屏模式。
PRIMARY	3	表示APP分屏多窗口主要模式。
SECONDARY	4	表示APP分屏多窗口次要模式。
FLOATING	5	表示APP自由悬浮形式窗口模式。

WindowLayoutMode⁹⁺

窗口布局模式枚举。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	值	说明
WINDOW_LAYOUT_MODE_CASCADE	0	表示使用层叠布局模式。
WINDOW_LAYOUT_MODE_TILE	1	表示使用平铺布局模式。

SystemBarProperties

状态栏、导航栏的属性。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	参数类型	可读	可写	说明
statusBarColor	string	是	是	状态栏背景颜色，为十六进制RGB或ARGB颜色，不区分大小写，例如`#00FF00`或`#FF00FF00`。
isStatusBarLightIcon⁷⁺	boolean	否	是	状态栏图标是否为高亮状态。
statusBarContentColor⁸⁺	string	否	是	状态栏文字颜色。
navigationBarColor	string	是	是	导航栏背景颜色，为十六进制RGB或ARGB颜色，不区分大小写，例如`#00FF00`或`#FF00FF00`。
isNavigationBarLightIcon⁷⁺	boolean	否	否	导航栏图标是否为高亮状态。
navigationBarContentColor⁸⁺	string	否	是	导航栏文字颜色。

SystemBarRegionTint⁸⁺

单个导航栏或状态栏回调信息。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	参数类型	可读	可写	说明
type	WindowType	是	是	当前属性改变的系统栏类型，仅支持类型为导航栏、状态栏的系统栏。
isEnable	boolean	是	是	当前系统栏是否显示。
region	Rect	是	是	当前系统栏的位置及大小。
backgroundColor	string	是	是	系统栏背景颜色，为十六进制RGB或ARGB颜色，不区分大小写，例如`#00FF00`或`#FF00FF00`。
contentColor	string	是	是	系统栏文字颜色。

SystemBarTintState⁸⁺

当前系统栏回调信息集合。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	参数类型	可读	可写	说明
displayId	number	是	否	当前物理屏幕id。
regionTint	Array<SystemBarRegionTint>	是	是	当前已改变的所有系统栏信息。

Rect⁷⁺

窗口矩形区域。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	参数类型	可读	可写	说明
left	number	是	是	矩形区域的左边界。
top	number	是	是	矩形区域的上边界。
width	number	是	是	矩形区域的宽度。
height	number	是	是	矩形区域的高度。

AvoidArea⁷⁺

窗口内容规避区域。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	参数类型	可读	可写	说明
leftRect	Rect	是	是	屏幕左侧的矩形区。
topRect	Rect	是	是	屏幕顶部的矩形区。
rightRect	Rect	是	是	屏幕右侧的矩形区。
bottomRect	Rect	是	是	屏幕底部的矩形区。

Size⁷⁺

窗口大小。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	参数类型	可读	可写	说明
width	number	是	是	窗口宽度。
height	number	是	是	窗口高度。

WindowProperties

窗口属性。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	参数类型	可读	可写	说明
windowRect⁷⁺	Rect	是	是	窗口尺寸。
type⁷⁺	WindowType	是	是	窗口类型。
isFullScreen	boolean	是	是	是否全屏，默认为false。
isLayoutFullScreen⁷⁺	boolean	是	是	窗口是否为沉浸式，默认为false。
focusable⁷⁺	boolean	是	否	窗口是否可聚焦，默认为true。
touchable⁷⁺	boolean	是	否	窗口是否可触摸，默认为true。
brightness	number	是	是	屏幕亮度，取值范围为0~1，1表示最大亮度值。
dimBehindValue^(deprecated)	number	是	是	靠后窗口的暗度值，取值范围为0~1，1表示最暗。 - 说明：从API version 9开始废弃。 - 从 API version 7开始支持
isKeepScreenOn	boolean	是	是	屏幕是否常亮，默认为false。
isPrivacyMode⁷⁺	boolean	是	是	隐私模式，默认为false。
isRoundCorner⁷⁺	boolean	是	是	窗口是否为圆角。默认为false。
isTransparent⁷⁺	boolean	是	是	窗口是否透明。默认为false。

ColorSpace⁸⁺

色域模式。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	默认值	说明
DEFAULT	0	默认色域模式。
WIDE_GAMUT	1	广色域模式。

window.create⁷⁺

create(id: string, type: WindowType, callback: AsyncCallback<Window>): void

创建子窗口，使用callback异步回调。

此接口仅可在FA模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
id	string	是	窗口id。
type	WindowType	是	窗口类型。
callback	AsyncCallback<Window>	是	回调函数。返回当前创建的子窗口对象。

示例：

var windowClass = null;
 let promise = window.create("first", window.WindowType.TYPE_APP);
 promise.then((data)=> {
 	windowClass = data;
    console.info('SubWindow created. Data: ' + JSON.stringify(data));
 }).catch((err)=>{
    console.error('Failed to create the subWindow. Cause: ' + JSON.stringify(err));
 });

window.create⁷⁺

create(id: string, type: WindowType): Promise<Window>

创建子窗口，使用Promise异步回调。

此接口仅可在FA模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
id	string	是	窗口id。
type	WindowType	是	窗口类型。

返回值：

类型	说明
Promise<Window>	Promise对象。返回当前创建的子窗口对象。

示例：

var windowClass = null;
let promise = window.create("first", window.WindowType.TYPE_APP);
promise.then((data)=> {
    windowClass = data;
    console.info('SubWindow created. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to create the subWindow. Cause: ' + JSON.stringify(err));
});

window.create⁸⁺

create(ctx: Context, id: string, type: WindowType, callback: AsyncCallback<Window>): void

创建子窗口，使用callback异步回调，其中Context详见Context。

从API version 9开始，当Context为ServiceExtensionContext时，创建系统窗口，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
ctx	Context	是	当前应用上下文信息。 API version 8的Context定义见Context。 API version 9的Context定义见Context。
id	string	是	窗口id。
type	WindowType	是	窗口类型。
callback	AsyncCallback<Window>	是	回调函数。返回当前创建的子窗口对象。

示例：

var windowClass = null;
 window.create(this.context, "alertWindow", window.WindowType.TYPE_SYSTEM_ALERT, (err, data) => {
    if (err.code) {
        console.error('Failed to create the Window. Cause: ' + JSON.stringify(err));
        return;
    }
    windowClass = data;
    console.info('Window created. Data: ' + JSON.stringify(data));
    windowClass.resetSize(500, 1000);
});

window.create⁸⁺

create(ctx: Context, id: string, type: WindowType): Promise<Window>

创建子窗口，使用Promise异步回调，其中Context详见Context。

从API version 9开始，当Context为ServiceExtensionContext时，创建系统窗口，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
ctx	Context	是	当前应用上下文信息。 API version 8的Context定义见Context。 API version 9的Context定义见Context。
id	string	是	窗口id。
type	WindowType	是	窗口类型。

返回值：

类型	说明
Promise<Window>	Promise对象。返回当前创建的子窗口对象。

示例：

var windowClass = null;
let promise = window.create(this.context, "alertWindow", window.WindowType.TYPE_SYSTEM_ALERT);
promise.then((data)=> {
 	windowClass = data;
    console.info('Window created. Data:' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to create the Window. Cause:' + JSON.stringify(err));
});

window.find⁷⁺

find(id: string, callback: AsyncCallback<Window>): void

查找id所对应的窗口，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
id	string	是	窗口id。
callback	AsyncCallback<Window>	是	回调函数。返回当前查找到的窗口对象。

示例：

var windowClass = null;
 window.find("alertWindow", (err, data) => {
   if (err.code) {
       console.error('Failed to find the Window. Cause: ' + JSON.stringify(err));
       return;
   }
   windowClass = data;
   console.info('window found. Data: ' + JSON.stringify(data));
});

window.find⁷⁺

find(id: string): Promise<Window>

查找id所对应的窗口，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
id	string	是	窗口id。

返回值：

类型	说明
Promise<Window>	Promise对象。返回当前查找的窗口对象。

示例：

var windowClass = null;
let promise = window.find("alertWindow");
promise.then((data)=> {
 	windowClass = data;
    console.info('window found. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to find the Window. Cause: ' + JSON.stringify(err));
});

window.getTopWindow

getTopWindow(callback: AsyncCallback<Window>): void

获取当前应用内最后显示的窗口，使用callback异步回调。

此接口仅可在FA模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
callback	AsyncCallback<Window>	是	回调函数。返回当前应用内最后显示的窗口对象。

示例：

var windowClass = null;
window.getTopWindow((err, data) => {
    if (err.code) {
        console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(err));
        return;
    }
    windowClass = data;
    console.info('Succeeded in obtaining the top window. Data: ' + JSON.stringify(data));
});

window.getTopWindow

getTopWindow(): Promise<Window>

获取当前应用内最后显示的窗口，使用Promise异步回调。

此接口仅可在FA模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型	说明
Promise<Window>	Promise对象。返回当前应用内最后显示的窗口对象。

示例：

var windowClass = null;
let promise = window.getTopWindow();
promise.then((data)=> {
 	windowClass = data;
    console.info('Succeeded in obtaining the top window. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(err));
})

window.getTopWindow⁸⁺

getTopWindow(ctx: Context, callback: AsyncCallback<Window>): void

获取当前应用内最后显示的窗口，使用callback异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
ctx	Context	是	当前应用上下文信息。 API version 8的Context定义见Context。 API version 9的Context定义见Context。
callback	AsyncCallback<Window>	是	回调函数。返回当前应用内最后显示的窗口对象。

示例：

var windowClass = null;
window.getTopWindow(this.context, (err, data) => {
    if (err.code) {
        console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(err));
        return;
    }
    windowClass = data;
    console.info('Succeeded in obtaining the top window. Data: ' + JSON.stringify(data));
});

window.getTopWindow⁸⁺

getTopWindow(ctx: Context): Promise<Window>

获取当前应用内最后显示的窗口，使用Promise异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
ctx	Context	是	当前应用上下文信息。 API version 8的Context定义见Context。 API version 9的Context定义见Context。

返回值：

类型	说明
Promise<Window>	Promise对象。返回当前应用内最后显示的窗口对象。

示例：

var windowClass = null;
let promise = window.getTopWindow(this.context);
promise.then((data)=> {
 	windowClass = data;
    console.info('Succeeded in obtaining the top window. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(err));
})

window.minimizeAll⁹⁺

minimizeAll(id: number, callback: AsyncCallback<void>): void

最小化某显示设备下的所有窗口。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
id	number	是	显示设备Display的ID号
callback	AsyncCallback<void>	是	回调信息。

示例：

import display from '@ohos.display'
import window from '@ohos.window'

var displayClass = null;
display.getDefaultDisplay((err, data) => {
    if(err.code) {
        return;
    }
    displayClass = data;
    window.minimizeAll(displayClass.id, (err, data) => {
        if(err.code) {
            console.error('Failed to minimize all window. Cause: ' + JSON.stringify(err));
            return;
        }
        console.info('Succeeded in minimizing all window.');
    });
});

window.minimizeAll⁹⁺

minimizeAll(id: number): Promise<void>

最小化某显示设备下的所有窗口。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
id	number	是	显示设备Display的ID号

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

import display from '@ohos.display'
import window from '@ohos.window'

var displayClass = null;
display.getDefaultDisplay((err, data) => {
    if(err.code) {
        return;
    }
    displayClass = data;
    let promise = window.minimizeAll(displayClass.id);
    promise.then((data)=> {
        console.info('Succeeded in minimizing all window.');
    }).catch((err)=>{
        console.error('Failed to minimize all window. Cause: ' + JSON.stringify(err));
    })
});

window.toggleShownStateForAllAppWindows⁹⁺

toggleShownStateForAllAppWindows(callback: AsyncCallback<void>): void

多窗口快速切换时隐藏或者恢复应用窗口。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	回调信息。

示例：

window.toggleShownStateForAllAppWindows((err, data) => {
    if (err.code) {
        console.error('Failed to toggle shown state for all app windows. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in toggling shown state for all app windows.');
})

window.toggleShownStateForAllAppWindows⁹⁺

toggleShownStateForAllAppWindows(): Promise<void>

多窗口快速切换时隐藏或者恢复应用窗口。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

let promise = window.toggleShownStateForAllAppWindows();
promise.then((data)=> {
    console.info('Succeeded in toggling shown state for all app windows. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to toggle shown state for all app windows. Cause: ' + JSON.stringify(err));
})

window.setWindowLayoutMode⁹⁺

setWindowLayoutMode(mode: WindowLayoutMode, callback: AsyncCallback<void>): void

设置窗口布局模式。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
mode	WindowLayoutMode	是	设置的窗口布局模式
callback	AsyncCallback<void>	是	回调信息。

示例：

window.setWindowLayoutMode(window.WindowLayoutMode.WINDOW_LAYOUT_MODE_CASCADE, (data) => {
    console.info('Succeeded in setting window layout mode. Data: ' + JSON.stringify(data));
});

window.setWindowLayoutMode⁹⁺

setWindowLayoutMode(mode: WindowLayoutMode): Promise<void>

设置窗口布局模式。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
mode	WindowLayoutMode	是	设置的窗口布局模式

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

let promise = window.setWindowLayoutMode(window.WindowLayoutMode.WINDOW_LAYOUT_MODE_CASCADE);
promise.then((data)=> {
    console.info('Succeeded in setting window layout mode. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set window layout mode. Cause: ' + JSON.stringify(err));
})

on('systemBarTintChange')⁸⁺

on(type: 'systemBarTintChange', callback: Callback<SystemBarTintState>): void

开启状态栏、导航栏属性变化的监听。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	string	是	监听事件，固定为'systemBarTintChange'，即导航栏、状态栏属性变化事件。
callback	Callback<SystemBarTintState>	是	回调函数。返回当前的状态栏、导航栏信息集合。

示例：

window.on('systemBarTintChange', (data) => {
    console.info('Succeeded in enabling the listener for systemBarTint changes. Data: ' + JSON.stringify(data));
});

off('systemBarTintChange')⁸⁺

off(type: 'systemBarTintChange', callback?: Callback<SystemBarTintState >): void

关闭状态栏、导航栏属性变化的监听。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	string	是	监听事件，固定为'systemBarTintChange'，即导航栏、状态栏属性变化事件。
callback	Callback<SystemBarTintState>	否	回调函数。返回当前的状态栏、导航栏信息集合。

示例：

window.off('systemBarTintChange');

Window

当前窗口实例，窗口管理器管理的基本单元。

下列API示例中都需先使用getTopWindow()、create()、find()中的任一方法获取到Window实例，再通过此实例调用对应方法。

hide⁷⁺

hide (callback: AsyncCallback<void>): void

隐藏当前窗口，使用callback异步回调。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	回调函数。

示例：

windowClass.hide((err, data) => {
    if (err.code) {
        console.error('Failed to hide the window. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('window hidden. data: ' + JSON.stringify(data));
})

hide⁷⁺

hide(): Promise<void>

隐藏当前窗口，使用Promise异步回调。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

let promise = windowClass.hide();
promise.then((data)=> {
    console.info('window hidden. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to hide the window. Cause: ' + JSON.stringify(err));
})

show⁷⁺

show(callback: AsyncCallback<void>): void

显示当前窗口，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	回调函数。

示例：

windowClass.show((err, data) => {
    if (err.code) {
        console.error('Failed to show the window. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in showing the window. Data: ' + JSON.stringify(data));
})

show⁷⁺

show(): Promise<void>

显示当前窗口，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

let promise = windowClass.show();
promise.then((data)=> {
    console.info('Succeeded in showing the window. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to show the window. Cause: ' + JSON.stringify(err));
})

destroy⁷⁺

destroy(callback: AsyncCallback<void>): void

销毁当前窗口，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	回调函数。

示例：

windowClass.destroy((err, data) => {
    if (err.code) {
        console.error('Failed to destroy the window. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in destroying the window. Data: ' + JSON.stringify(data));
})

destroy⁷⁺

destroy(): Promise<void>

销毁当前窗口，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

let promise = windowClass.destroy();
promise.then((data)=> {
    console.info('Succeeded in destroying the window. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to destroy the window. Cause: ' + JSON.stringify(err));
})

moveTo⁷⁺

moveTo(x: number, y: number, callback: AsyncCallback<void>): void

移动窗口位置，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
x	number	是	窗口在x轴方向移动的值，值为正表示右移，单位为px。
y	number	是	窗口在y轴方向移动的值，值为正表示下移，单位为px。
callback	AsyncCallback<void>	是	回调函数。

示例：

windowClass.moveTo(300, 300, (err, data)=>{
    if (err.code) {
        console.error('Failed to move the window. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Window moved. Data: ' + JSON.stringify(data));

});

moveTo⁷⁺

moveTo(x: number, y: number): Promise<void>

移动窗口位置，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
x	number	是	窗口在x轴方向移动的值，值为正表示右移，单位为px。
y	number	是	窗口在y轴方向移动的值，值为正表示下移，单位为px。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

let promise = windowClass.moveTo(300, 300);
promise.then((data)=> {
    console.info('Window moved. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to move the window. Cause: ' + JSON.stringify(err));
})

resetSize⁷⁺

resetSize(width: number, height: number, callback: AsyncCallback<void>): void

改变当前窗口大小，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
width	number	是	目标窗口的宽度，单位为px。
height	number	是	目标窗口的高度，单位为px。
callback	AsyncCallback<void>	是	回调函数。

示例：

windowClass.resetSize(500, 1000, (err, data) => {
    if (err.code) {
        console.error('Failed to change the window size. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Window size changed. Data: ' + JSON.stringify(data));
});

resetSize⁷⁺

resetSize(width: number, height: number): Promise<void>

改变当前窗口大小，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
width	number	是	目标窗口的宽度，单位为px。
height	number	是	目标窗口的高度，单位为px。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

let promise = windowClass.resetSize(500, 1000);
promise.then((data)=> {
    console.info('Window size changed. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to change the window size. Cause: ' + JSON.stringify(err));
});

setWindowType⁷⁺

setWindowType(type: WindowType, callback: AsyncCallback<void>): void

设置窗口类型，使用callback异步回调。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	WindowType	是	窗口类型。
callback	AsyncCallback<void>	是	回调函数。

示例：

var type = window.WindowType.TYPE_APP;
windowClass.setWindowType(type, (err, data) => {
  if (err.code) {
      console.error('Failed to set the window type. Cause: ' + JSON.stringify(err));
      return;
  }
  console.info('Succeeded in setting the window type. Data: ' + JSON.stringify(data));
});

setWindowType⁷⁺

setWindowType(type: WindowType): Promise<void>

设置窗口类型，使用Promise异步回调。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	WindowType	是	窗口类型。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

var type = window.WindowType.TYPE_APP;
let promise = windowClass.setWindowType(type);
promise.then((data)=> {
    console.info('Succeeded in setting the window type. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set the window type. Cause: ' + JSON.stringify(err));
});

getProperties

getProperties(callback: AsyncCallback<WindowProperties>): void

获取当前窗口的属性，使用callback异步回调，返回WindowProperties。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
callback	AsyncCallback<WindowProperties>	是	回调函数。返回当前窗口属性。

示例：

windowClass.getProperties((err, data) => {
    if (err.code) {
        console.error('Failed to obtain the window properties. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in obtaining the window properties. Data: ' + JSON.stringify(data));
});

getProperties

getProperties(): Promise<WindowProperties>

获取当前窗口的属性，使用Promise异步回调，返回WindowProperties。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型	说明
Promise<WindowProperties>	Promise对象。返回当前窗口属性。

示例：

let promise = windowClass.getProperties();
promise.then((data)=> {
    console.info('Succeeded in obtaining the window properties. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to obtain the window properties. Cause: ' + JSON.stringify(err));
});

getAvoidArea⁷⁺

getAvoidArea(type: AvoidAreaType, callback: AsyncCallback<AvoidArea>): void

获取窗口内容规避的区域，如系统的系统栏区域、凹凸区域。使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	AvoidAreaType	是	表示规避区类型。type为TYPE_SYSTEM，表示系统默认区域。type为TYPE_CUTOUT，表示刘海屏区域。
callback	AsyncCallback<AvoidArea>	是	回调函数。返回窗口内容规避区域。

示例：

var type = window.AvoidAreaType.TYPE_SYSTEM;
windowClass.getAvoidArea(type, (err, data) => {
    if (err.code) {
        console.error('Failed to obtain the area. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in obtaining the area. Data:' + JSON.stringify(data));
});

getAvoidArea⁷⁺

getAvoidArea(type: AvoidAreaType): Promise<AvoidArea>

获取窗口内容规避的区域，如系统的系统栏区域、凹凸区域。使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	AvoidAreaType	是	表示规避区类型。type为TYPE_SYSTEM，表示系统默认区域。type为TYPE_CUTOUT，表示刘海屏区域。

返回值：

类型	说明
Promise<AvoidArea>	Promise对象。返回窗口内容规避区域。

示例：

let promise = windowClass.getAvoidArea();
promise.then((data)=> {
    console.info('Succeeded in obtaining the area. Data:' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to obtain the area. Cause:' + JSON.stringify(err));
});

setFullScreen

setFullScreen(isFullScreen: boolean, callback: AsyncCallback<void>): void

设置是否为全屏状态，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
isFullScreen	boolean	是	是否设为全屏状态，且全屏状态隐藏状态栏导航栏。
callback	AsyncCallback<void>	是	回调函数。

示例：

var isFullScreen = true;
windowClass.setFullScreen(isFullScreen, (err, data) => {
    if (err.code) {
        console.error('Failed to enable the full-screen mode. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in enabling the full-screen mode. Data: ' + JSON.stringify(data));
});

setFullScreen

setFullScreen(isFullScreen: boolean): Promise<void>

设置是否为全屏状态，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
isFullScreen	boolean	是	是否设为全屏状态，且全屏状态隐藏状态栏导航栏。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

var isFullScreen = true;
let promise = windowClass.setFullScreen(isFullScreen);
promise.then((data)=> {
    console.info('Succeeded in enabling the full-screen mode. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to enable the full-screen mode. Cause: ' + JSON.stringify(err));
});

setLayoutFullScreen⁷⁺

setLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback<void>): void

设置窗口的布局是否为全屏显示状态，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
isLayoutFullScreen	boolean	是	窗口的布局是否为全屏显示状态，且全屏状态下状态栏、导航栏仍然显示。
callback	AsyncCallback<void>	是	回调函数。

示例：

var isLayoutFullScreen= true;
windowClass.setLayoutFullScreen(isLayoutFullScreen, (err, data) => {
    if (err.code) {
        console.error('Failed to set the window layout to full-screen mode. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting the window layout to full-screen mode. Data: ' + JSON.stringify(data));
});

setLayoutFullScreen⁷⁺

setLayoutFullScreen(isLayoutFullScreen: boolean): Promise<void>

设置窗口的布局是否为全屏显示状态，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
isLayoutFullScreen	boolean	是	窗口的布局是否为全屏显示状态，且全屏状态下状态栏、导航栏仍然显示。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

var isLayoutFullScreen = true;
let promise = windowClass.setLayoutFullScreen(isLayoutFullScreen);
promise.then((data)=> {
    console.info('Succeeded in setting the window layout to full-screen mode. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set the window layout to full-screen mode. Cause:' + JSON.stringify(err));
});

setSystemBarEnable⁷⁺

setSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncCallback<void>): void

设置导航栏、状态栏的可见模式，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
names	Array	是	设置状态栏和导航栏是否显示。例如，需全部显示，该参数设置为["status", "navigation"]；不设置，则默认不显示。
callback	AsyncCallback<void>	是	回调函数。

示例：

var names = ["status", "navigation"];
windowClass.setSystemBarEnable(names, (err, data) => {
    if (err.code) {
        console.error('Failed to set the system bar to be visible. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting the system bar to be visible. Data: ' + JSON.stringify(data));
});

setSystemBarEnable⁷⁺

setSystemBarEnable(names: Array<'status' | 'navigation'>): Promise<void>

设置导航栏、状态栏的可见模式，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
names	Array	是	设置状态栏和导航栏是否显示。例如，需全部显示，该参数设置为["status", "navigation"]；不设置，则默认不显示。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

var names = ["status", "navigation"];
let promise = windowClass.setSystemBarEnable(names);
promise.then((data)=> {
    console.info('Succeeded in setting the system bar to be visible. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set the system bar to be visible. Cause:' + JSON.stringify(err));
});

setSystemBarProperties

setSystemBarProperties(systemBarProperties: SystemBarProperties, callback: AsyncCallback<void>): void

设置窗口内导航栏、状态栏的属性，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
SystemBarProperties	SystemBarProperties	是	导航栏、状态栏的属性。
callback	AsyncCallback<void>	是	回调函数。

示例：

var SystemBarProperties={
    statusBarColor: '#ff00ff',
    navigationBarColor: '#00ff00',
    //以下两个属性从API Version7开始支持
    isStatusBarLightIcon: true,
    isNavigationBarLightIcon:false,
    //以下两个属性从API Version8开始支持
    statusBarContentColor:'#ffffff',
    navigationBarContentColor:'#00ffff'
};
windowClass.setSystemBarProperties(SystemBarProperties, (err, data) => {
    if (err.code) {
        console.error('Failed to set the system bar properties. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting the system bar properties. Data: ' + JSON.stringify(data));
});

setSystemBarProperties

setSystemBarProperties(systemBarProperties: SystemBarProperties): Promise<void>

设置窗口内导航栏、状态栏的属性，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
SystemBarProperties	SystemBarProperties	是	导航栏、状态栏的属性。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

var SystemBarProperties={
    statusBarColor: '#ff00ff',
    navigationBarColor: '#00ff00',
    //以下两个属性从API Version7开始支持
    isStatusBarLightIcon: true,
    isNavigationBarLightIcon:false,
    //以下两个属性从API Version8开始支持
    statusBarContentColor:'#ffffff',
    navigationBarContentColor:'#00ffff'
};
let promise = windowClass.setSystemBarProperties(SystemBarProperties);
promise.then((data)=> {
    console.info('Succeeded in setting the system bar properties. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set the system bar properties. Cause: ' + JSON.stringify(err));
});

loadContent⁷⁺

loadContent(path: string, callback: AsyncCallback<void>): void

为当前窗口加载具体页面内容，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
path	string	是	设置加载页面的路径。
callback	AsyncCallback<void>	是	回调函数。

示例：

windowClass.loadContent("pages/page2/page2", (err, data) => {
   if (err.code) {
         console.error('Failed to load the content. Cause:' + JSON.stringify(err));
         return;
   }
  console.info('Succeeded in loading the content. Data: ' + JSON.stringify(data));
});

loadContent⁷⁺

loadContent(path: string): Promise<void>

为当前窗口加载具体页面内容，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
path	string	是	设置加载页面的路径。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

let promise = windowClass.loadContent("pages/page2/page2");
promise.then((data)=> {
    console.info('Succeeded in loading the content. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to load the content. Cause: ' + JSON.stringify(err));
});

loadContent⁹⁺

loadContent(path: string, storage: LocalStorage, callback: AsyncCallback<void>): void

为当前窗口加载与LocalStorage相关联的具体页面内容，使用callback异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
path	string	是	设置加载页面的路径。
storage	LocalStorage	是	存储单元，为应用程序范围内的可变状态属性和非可变状态属性提供存储。
callback	AsyncCallback<void>	是	回调函数。

示例：

class myAbility extends Ability {
    storage : LocalStorage  
    onWindowStageCreate(windowStage) {
        this.storage = new LocalStorage();
        this.storage.setOrCreate("storageSimpleProp",121);
        console.log('onWindowStageCreate');
        windowStage.loadContent("pages/page2",this.storage,(err, data) => {
            if (err.code) {
                console.error('Failed to load the content. Cause:' + JSON.stringify(err));
                return;
            }
            console.info('Succeeded in loading the content. Data: ' + JSON.stringify(data));
        });
    }
}

loadContent⁹⁺

loadContent(path: string, storage: LocalStorage): Promise<void>

为当前窗口加载与LocalStorage相关联的具体页面内容，使用Promise异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
path	string	是	设置加载页面的路径。
storage	LocalStorage	是	存储单元，为应用程序范围内的可变状态属性和非可变状态属性提供存储。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

class myAbility extends Ability {
    storage : LocalStorage 
    onWindowStageCreate(windowStage) {
        this.storage = new LocalStorage();
        this.storage.setOrCreate("storageSimpleProp",121);
        console.log('onWindowStageCreate');
        var windowClass = null;
        let promise = windowStage.loadContent("pages/page2",this.storage);
        promise.then((data)=> {
            windowClass = data;
            console.info('Succeeded in loading the content. Data: ' + JSON.stringify(data));
        }).catch((err)=>{
            console.error('Failed to load the content. Cause:' + JSON.stringify(err));
        })
    }
}

isShowing⁷⁺

isShowing(callback: AsyncCallback<boolean>): void

判断当前窗口是否已显示，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
callback	AsyncCallback<boolean>	是	回调函数。返回true表示当前窗口已显示，返回false则表示当前窗口未显示。

示例：

windowClass.isShowing((err, data) => {
    if (err.code) {
        console.error('Failed to check whether the window is showing. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in checking whether the window is showing. Data: ' + JSON.stringify(data));
});

isShowing⁷⁺

isShowing(): Promise<boolean>

判断当前窗口是否已显示，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型	说明
Promise<boolean>	Promise对象。返回true表示当前窗口已显示，返回false则表示当前窗口未显示。

示例：

let promise = windowClass.isShowing();
promise.then((data)=> {
    console.info('Succeeded in checking whether the window is showing. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to check whether the window is showing. Cause: ' + JSON.stringify(err));
});

on('windowSizeChange')⁷⁺

on(type: 'windowSizeChange', callback: Callback<Size>): void

开启窗口尺寸变化的监听。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	string	是	监听事件，固定为'windowSizeChange'，即窗口尺寸变化事件。
callback	Callback<Size>	是	回调函数。返回当前的窗口尺寸。

示例：

windowClass.on('windowSizeChange', (data) => {
    console.info('Succeeded in enabling the listener for window size changes. Data: ' + JSON.stringify(data));
});

off('windowSizeChange')⁷⁺

off(type: 'windowSizeChange', callback?: Callback<Size >): void

关闭窗口尺寸变化的监听。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	string	是	监听事件，固定为'windowSizeChange'，即窗口尺寸变化事件。
callback	Callback<Size>	否	回调函数。返回当前的窗口尺寸。

示例：

windowClass.off('windowSizeChange');

on('systemAvoidAreaChange')⁷⁺

on(type: 'systemAvoidAreaChange', callback: Callback<AvoidArea>): void

开启系统窗口规避区变化的监听。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	string	是	监听事件，固定为'systemAvoidAreaChange'，即系统窗口规避区变化事件。
callback	Callback<AvoidArea>	是	回调函数。返回当前的窗口规避区。

示例：

windowClass.on('systemAvoidAreaChange', (data) => {
    console.info('Succeeded in enabling the listener for system avoid area changes. Data: ' + JSON.stringify(data));
});

off('systemAvoidAreaChange')⁷⁺

off(type: 'systemAvoidAreaChange', callback?: Callback<AvoidArea>): void

关闭系统窗口规避区变化的监听。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	string	是	监听事件，固定为'systemAvoidAreaChange'，即系统窗口规避区变化事件。
callback	Callback<AvoidArea>	否	回调函数。返回当前的窗口规避区。

示例：

windowClass.off('systemAvoidAreaChange');

on('keyboardHeightChange')⁷⁺

on(type: 'keyboardHeightChange', callback: Callback<number>): void

开启键盘高度变化的监听。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	string	是	监听事件，固定为'keyboardHeightChange'，即键盘高度变化事件。
callback	Callback<number>	是	回调函数。返回当前的键盘高度。

示例：

windowClass.on('keyboardHeightChange', (data) => {
    console.info('Succeeded in enabling the listener for keyboard height changes. Data: ' + JSON.stringify(data));
});

off('keyboardHeightChange')⁷⁺

off(type: 'keyboardHeightChange', callback?: Callback<number>): void

关闭键盘高度变化的监听。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	string	是	监听事件，固定为'keyboardHeightChange'，即键盘高度变化事件。
callback	Callback<number>	否	回调函数。返回当前的键盘高度。

示例：

windowClass.off('keyboardHeightChange');

isSupportWideGamut⁸⁺

isSupportWideGamut(callback: AsyncCallback<boolean>): void

判断当前窗口是否支持广色域模式，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
callback	AsyncCallback<boolean>	是	回调函数。返回true表示当前窗口支持广色域模式，返回false则表示当前窗口不支持广色域模式。

示例：

windowClass.isSupportWideGamut((err, data) => {
    if (err.code) {
        console.error('Failed to check whether the window support WideGamut. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in checking whether the window support WideGamut Data: ' + JSON.stringify(data));
})

isSupportWideGamut⁸⁺

isSupportWideGamut(): Promise<boolean>

判断当前窗口是否支持广色域模式，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型	说明
Promise<boolean>	Promise对象。返回true表示当前窗口支持广色域模式，返回false则表示当前窗口不支持广色域模式。

示例：

let promise = windowClass.isSupportWideGamut();
promise.then((data)=> {
    console.info('Succeeded in checking whether the window support WideGamut. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to check whether the window support WideGamut. Cause: ' + JSON.stringify(err));
});

setColorSpace⁸⁺

setColorSpace(colorSpace:ColorSpace, callback: AsyncCallback<void>): void

设置当前窗口为广色域模式或默认色域模式，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
colorSpace	ColorSpace	是	设置色域模式
callback	AsyncCallback<void>	是	回调函数。

示例：

windowClass.setColorSpace(window.ColorSpace.WIDE_GAMUT, (err, data) => {
    if (err.code) {
        console.error('Failed to set window colorspace. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting window colorspace. Data: ' + JSON.stringify(data));
})

setColorSpace⁸⁺

setColorSpace(colorSpace:ColorSpace): Promise<void>

设置当前窗口为广色域模式或默认色域模式，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
colorSpace	ColorSpace	是	设置色域模式。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

let promise = windowClass.setColorSpace(window.ColorSpace.WIDE_GAMUT);
promise.then((data)=> {
    console.info('Succeeded in setting window colorspace. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set window colorspace. Cause: ' + JSON.stringify(err));
});

getColorSpace⁸⁺

getColorSpace(callback: AsyncCallback<ColorSpace>): void

获取当前窗口色域模式，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
callback	AsyncCallback<ColorSpace>	是	回调函数。当获取成功，err为undefined，data为当前色域模式。

示例：

windowClass.getColorSpace((err, data) => {
    if (err.code) {
        console.error('Failed to get window colorspace. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in getting window colorspace. Cause:' + JSON.stringify(data));
})

getColorSpace⁸⁺

getColorSpace(): Promise<ColorSpace>

获取当前窗口色域模式，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型	说明
Promise<ColorSpace>	Promise对象。返回当前色域模式。

示例：

let promise = windowClass.getColorSpace();
promise.then((data)=> {
    console.info('Succeeded in getting window color space. Cause:' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to get window colorspace. Cause: ' + JSON.stringify(err));
});

setBackgroundColor

setBackgroundColor(color: string, callback: AsyncCallback<void>): void

设置窗口的背景色，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
color	string	是	需要设置的背景色，为十六进制颜色，不区分大小写，例如`#00FF00`或`#FF00FF00`。
callback	AsyncCallback<void>	是	回调函数。

示例：

var color = '#00ff33';
windowClass.setBackgroundColor(color, (err, data) => {
    if (err.code) {
        console.error('Failed to set the background color. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting the background color. Data: ' + JSON.stringify(data));
});

setBackgroundColor

setBackgroundColor(color: string): Promise<void>

设置窗口的背景色，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
color	string	是	需要设置的背景色，为十六进制颜色，不区分大小写，例如"#00FF00"或"#FF00FF00"。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

var color = '#00ff33';
let promise = windowClass.setBackgroundColor(color);
promise.then((data)=> {
    console.info('Succeeded in setting the background color. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set the background color. Cause: ' + JSON.stringify(err));
});

setBrightness

setBrightness(brightness: number, callback: AsyncCallback<void>): void

设置屏幕亮度值，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
brightness	number	是	屏幕亮度值，值为0-1之间。1表示最亮。
callback	AsyncCallback<void>	是	回调函数。

示例：

var brightness = 1;
windowClass.setBrightness(brightness, (err, data) => {
    if (err.code) {
        console.error('Failed to set the brightness. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting the brightness. Data: ' + JSON.stringify(data));
});

setBrightness

setBrightness(brightness: number): Promise<void>

设置屏幕亮度值，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
brightness	number	是	屏幕亮度值，值为0-1之间。1表示最亮。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

var brightness = 1;
let promise = windowClass.setBrightness(brightness);
promise.then((data)=> {
    console.info('Succeeded in setting the brightness. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set the brightness. Cause: ' + JSON.stringify(err));
});

setDimBehind^(deprecated)

setDimBehind(dimBehindValue: number, callback: AsyncCallback<void>): void

窗口叠加时，设备有子窗口的情况下设置靠后的窗口的暗度值，使用callback异步回调。

说明： 从API version 9开始废弃。

从 API version 7开始支持。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
dimBehindValue	number	是	表示靠后的窗口的暗度值，取值范围为0-1，1表示最暗。
callback	AsyncCallback<void>	是	回调函数。

示例：

windowClass.setDimBehind(0.5, (err, data) => {
    if (err.code) {
        console.error('Failed to set the dimness. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting the dimness. Data:' + JSON.stringify(data));
});

setDimBehind^(deprecated)

setDimBehind(dimBehindValue: number): Promise<void>

窗口叠加时，设备有子窗口的情况下设置靠后的窗口的暗度值，使用Promise异步回调。

说明： 从API version 9开始废弃。

从 API version 7开始支持。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
dimBehindValue	number	是	表示靠后的窗口的暗度值，取值范围为0-1，1表示最暗。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

let promise = windowClass.setDimBehind(0.5);
promise.then((data)=> {
    console.info('Succeeded in setting the dimness. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set the dimness. Cause: ' + JSON.stringify(err));
});

setFocusable⁷⁺

setFocusable(isFocusable: boolean, callback: AsyncCallback<void>): void

设置点击时是否支持切换焦点窗口，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
isFocusable	boolean	是	点击时是否支持切换焦点窗口。
callback	AsyncCallback<void>	是	回调函数。

示例：

var isFocusable= true;
windowClass.setFocusable(isFocusable, (err, data) => {
    if (err.code) {
        console.error('Failed to set the window to be focusable. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting the window to be focusable. Data: ' + JSON.stringify(data));
});

setFocusable⁷⁺

setFocusable(isFocusable: boolean): Promise<void>

设置点击时是否支持切换焦点窗口，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
isFocusable	boolean	是	点击时是否支持切换焦点窗口。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

var isFocusable= true;
let promise = windowClass.setFocusable(isFocusable);
promise.then((data)=> {
    console.info('Succeeded in setting the window to be focusable. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set the window to be focusable. Cause: ' + JSON.stringify(err));
});

setKeepScreenOn

setKeepScreenOn(isKeepScreenOn: boolean, callback: AsyncCallback<void>): void

设置屏幕是否为常亮状态，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
isKeepScreenOn	boolean	是	设置屏幕是否为常亮状态。
callback	AsyncCallback<void>	是	回调函数。

示例：

var isKeepScreenOn = true;
windowClass.setKeepScreenOn(isKeepScreenOn, (err, data) => {
    if (err.code) {
        console.error('Failed to set the screen to be always on. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting the screen to be always on. Data: ' + JSON.stringify(data));
});

setKeepScreenOn

setKeepScreenOn(isKeepScreenOn: boolean): Promise<void>

设置屏幕是否为常亮状态，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
isKeepScreenOn	boolean	是	设置屏幕是否为常亮状态。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

var isKeepScreenOn = true;
let promise = windowClass.setKeepScreenOn(isKeepScreenOn);
promise.then((data) => {
    console.info('Succeeded in setting the screen to be always on. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.info('Failed to set the screen to be always on. Cause:  ' + JSON.stringify(err)); 
});

setOutsideTouchable^(deprecated)

setOutsideTouchable(touchable: boolean, callback: AsyncCallback<void>): void

设置是否允许可点击子窗口之外的区域，使用callback异步回调。

说明： 从API version 9开始废弃。

从 API version 7开始支持。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
touchable	boolean	是	设置是否可点击。
callback	AsyncCallback<void>	是	回调函数。

示例：

windowClass.setOutsideTouchable(true, (err, data) => {
    if (err.code) {
        console.error('Failed to set the area to be touchable. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting the area to be touchable. Data: ' + JSON.stringify(data));
})

setOutsideTouchable^(deprecated)

setOutsideTouchable(touchable: boolean): Promise<void>

设置是否允许可点击子窗口之外的区域，使用Promise异步回调。。

说明： 从API version 9开始废弃。

从 API version 7开始支持。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
touchable	boolean	是	设置是否可点击。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

let promise = windowClass.setOutsideTouchable(true);
promise.then((data)=> {
    console.info('Succeeded in setting the area to be touchable. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set the area to be touchable. Cause: ' + JSON.stringify(err));
});

setPrivacyMode⁷⁺

setPrivacyMode(isPrivacyMode: boolean, callback: AsyncCallback<void>): void

设置窗口是否为隐私模式，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
isPrivacyMode	boolean	是	窗口是否为隐私模式。
callback	AsyncCallback<void>	是	回调函数。

示例：

var isPrivacyMode = true;
windowClass.setPrivacyMode(isPrivacyMode, (err, data) => {
    if (err.code) {
        console.error('Failed to set the window to privacy mode. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting the window to privacy mode. Data:' + JSON.stringify(data));

});

setPrivacyMode⁷⁺

setPrivacyMode(isPrivacyMode: boolean): Promise<void>

设置窗口是否为隐私模式，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
isPrivacyMode	boolean	是	窗口是否为隐私模式。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

var isPrivacyMode = true;
let promise = windowClass.setPrivacyMode(isPrivacyMode);
promise.then((data)=> {
    console.info('Succeeded in setting the window to privacy mode. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set the window to privacy mode. Cause: ' + JSON.stringify(err));
});

setTouchable⁷⁺

setTouchable(isTouchable: boolean, callback: AsyncCallback<void>): void

设置窗口是否为可触状态，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
isTouchable	boolean	是	窗口是否为可触状态。
callback	AsyncCallback<void>	是	回调函数。

示例：

var isTouchable = true;
windowClass.setTouchable(isTouchable, (err, data) => {
    if (err.code) {
        console.error('Failed to set the window to be touchable. Cause:' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting the window to be touchable. Data:' + JSON.stringify(data));

});

setTouchable⁷⁺

setTouchable(isTouchable: boolean): Promise<void>

设置窗口是否为可触状态，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
isTouchable	boolean	是	窗口是否为可触状态。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

var isTouchable = true;
let promise = windowClass.setTouchable(isTouchable);
promise.then((data)=> {
    console.info('Succeeded in setting the window to be touchable. Data: ' + JSON.stringify(data));
}).catch((err)=>{
    console.error('Failed to set the window to be touchable. Cause: ' + JSON.stringify(err));
});

WindowStageEventType⁹⁺

WindowStage生命周期。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称	默认值	说明
FOREGROUND	1	切到前台。
ACTIVE	2	获焦状态。
INACTIVE	3	失焦状态。
BACKGROUND	4	切到后台。

WindowStage⁹⁺

窗口管理器。管理各个基本窗口单元，即Window实例。

下列API示例中都需在onWindowStageCreate()函数中使用WindowStage的实例调用对应方法。

getMainWindow⁹⁺

getMainWindow(callback: AsyncCallback<Window>): void

获取该WindowStage实例下的主窗口，使用callback异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
callback	AsyncCallback<Window>	是	回调函数。返回当前WindowStage下的主窗口对象。

示例：

import Ability from '@ohos.application.Ability';
class myAbility extends Ability {
    onWindowStageCreate(windowStage) {
        console.log('onWindowStageCreate');
        var windowClass = null;
        windowStage.getMainWindow((err, data) => {
            if (err.code) {
                console.error('Failed to obtain the main window. Cause: ' + JSON.stringify(err));
                return;
            }
            windowClass = data;
            console.info('Succeeded in obtaining the main window. Data: ' + JSON.stringify(data));
        });
    }
}

getMainWindow⁹⁺

getMainWindow(): Promise<Window>

获取该WindowStage实例下的主窗口，使用Promise异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型	说明
Promise<Window>	Promise对象。返回当前WindowStage下的主窗口对象。

示例：

import Ability from '@ohos.application.Ability';
class myAbility extends Ability {
    onWindowStageCreate(windowStage) {
        console.log('onWindowStageCreate');
        var windowClass = null;
        let promise = windowStage.getMainWindow();
        promise.then((data)=> {
        windowClass = data;
            console.info('Succeeded in obtaining the main window. Data: ' + JSON.stringify(data));
        }).catch((err)=>{
            console.error('Failed to obtain the main window. Cause: ' + JSON.stringify(err));
        });
    }
}

createSubWindow⁹⁺

createSubWindow(name: string, callback: AsyncCallback<Window>): void

创建该WindowStage实例下的子窗口，使用callback异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
name	String	是	子窗口的名字。
callback	AsyncCallback<Window>	是	回调函数。返回当前WindowStage下的子窗口对象。

示例：

import Ability from '@ohos.application.Ability';
class myAbility extends Ability {
    onWindowStageCreate(windowStage) {
        console.log('onWindowStageCreate');
        var windowClass = null;
        windowStage.createSubWindow("mySubWindow", (err, data) => {
            if (err.code) {
                console.error('Failed to create sub window. Cause: ' + JSON.stringify(err));
                return;
            }
            windowClass = data;
            console.info('Succeeded in create sub window. Data: ' + JSON.stringify(data));
            windowClass.resetSize(500, 1000);
        });
    }
}

createSubWindow⁹⁺

createSubWindow(name: string): Promise<Window>

创建该WindowStage实例下的子窗口，使用Promise异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
name	String	是	子窗口的名字。

返回值：

类型	说明
Promise<Window>	Promise对象。返回当前WindowStage下的子窗口对象。

示例：

import Ability from '@ohos.application.Ability';
class myAbility extends Ability {
    onWindowStageCreate(windowStage) {
        console.log('onWindowStageCreate');
        var windowClass = null;
        let promise = windowStage.createSubWindow("mySubWindow");
        promise.then((data)=> {
            windowClass = data;
            console.info('Succeeded in create sub window. Data: ' + JSON.stringify(data));
        }).catch((err)=>{
            console.error('Failed to create sub window. Cause: ' + JSON.stringify(err));
        })
    }
}

getSubWindow⁹⁺

getSubWindow(callback: AsyncCallback<Array<Window>>): void

获取该WindowStage实例下的所有子窗口，使用callback异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
callback	AsyncCallback<Array<Window>>	是	回调函数。返回当前WindowStage下的所有子窗口对象。

示例：

import Ability from '@ohos.application.Ability';
class myAbility extends Ability {
    onWindowStageCreate(windowStage) {
        console.log('onWindowStageCreate');
        var windowClass = null;
        windowStage.getSubWindow((err, data) => {
            if (err.code) {
                console.error('Failed to obtain the sub window. Cause: ' + JSON.stringify(err));
                return;
            }
            windowClass = data;
            console.info('Succeeded in obtaining the sub window. Data: ' + JSON.stringify(data));
        });
    }
}

getSubWindow⁹⁺

getSubWindow(): Promise<Array<Window>>

获取该WindowStage实例下的所有子窗口，使用Promise异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型	说明
Promise<Array<Window>>	Promise对象。返回当前WindowStage下的所有子窗口对象。

示例：

import Ability from '@ohos.application.Ability';
class myAbility extends Ability {
    onWindowStageCreate(windowStage) {
        console.log('onWindowStageCreate');
        var windowClass = null;
        let promise = windowStage.getSubWindow();
        promise.then((data)=> {
            windowClass = data;
            console.info('Succeeded in obtaining the sub window. Data: ' + JSON.stringify(data));
        }).catch((err)=>{
            console.error('Failed to obtain the sub window. Cause: ' + JSON.stringify(err));
        })
    }
}

loadContent⁹⁺

loadContent(path: string, storage: LocalStorage, callback: AsyncCallback<void>): void

为当前WindowStage的主窗口加载与LocalStorage相关联的具体页面内容，使用callback异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
path	string	是	设置加载页面的路径。
storage	LocalStorage	是	存储单元，为应用程序范围内的可变状态属性和非可变状态属性提供存储。
callback	AsyncCallback<void>	是	回调函数。

示例：

import Ability from '@ohos.application.Ability';
class myAbility extends Ability {
    storage : LocalStorage  
    onWindowStageCreate(windowStage) {
        this.storage = new LocalStorage();
        this.storage.setOrCreate("storageSimpleProp",121);
        console.log('onWindowStageCreate');
        windowStage.loadContent("pages/page2",this.storage,(err, data) => {
            if (err.code) {
                console.error('Failed to load the content. Cause:' + JSON.stringify(err));
                return;
            }
            console.info('Succeeded in loading the content. Data: ' + JSON.stringify(data));
        });
    }
}

loadContent⁹⁺

loadContent(path: string, storage?: LocalStorage): Promise<void>

为当前WindowStage的主窗口加载与LocalStorage相关联的具体页面内容，使用Promise异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
path	string	是	设置加载页面的路径。
storage	LocalStorage	否	存储单元，为应用程序范围内的可变状态属性和非可变状态属性提供存储。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

import Ability from '@ohos.application.Ability';
class myAbility extends Ability {
    storage : LocalStorage 
    onWindowStageCreate(windowStage) {
        this.storage = new LocalStorage();
        this.storage.setOrCreate("storageSimpleProp",121);
        console.log('onWindowStageCreate');
        var windowClass = null;
        let promise = windowStage.loadContent("pages/page2",this.storage);
        promise.then((data)=> {
            windowClass = data;
            console.info('Succeeded in loading the content. Data: ' + JSON.stringify(data));
        }).catch((err)=>{
            console.error('Failed to load the content. Cause:' + JSON.stringify(err));
        })
    }
}

loadContent⁹⁺

loadContent(path: string, callback: AsyncCallback<void>): void

为当前WindowStage的主窗口加载具体页面内容，使用callback异步回调。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
path	string	是	设置加载页面的路径。
callback	AsyncCallback<void>	是	回调函数。

示例：

import Ability from '@ohos.application.Ability';
class myAbility extends Ability {
    onWindowStageCreate(windowStage) {
        console.log('onWindowStageCreate');
        windowStage.loadContent("pages/page2", (err, data) => {
            if (err.code) {
                console.error('Failed to load the content. Cause:' + JSON.stringify(err));
                return;
            }
            console.info('Succeeded in loading the content. Data: ' + JSON.stringify(data));
        });
    }
}

on('windowStageEvent')⁹⁺

on(eventType: 'windowStageEvent', callback: Callback<WindowStageEventType>): void

开启WindowStage生命周期变化的监听。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	string	是	监听事件，固定为'windowStageEvent'，即WindowStage生命周期变化事件。
callback	Callback<WindowStageEventType>	是	回调函数。返回当前的WindowStage生命周期状态。

示例：

import Ability from '@ohos.application.Ability';
class myAbility extends Ability {
    onWindowStageCreate(windowStage) {
        console.log('onWindowStageCreate');
        windowStage.on('windowStageEvent', (data) => {
            console.info('Succeeded in enabling the listener for window stage event changes. Data: ' + JSON.stringify(data));
        });
    }
}

off('windowStageEvent')⁹⁺

off(eventType: 'windowStageEvent', callback?: Callback<WindowStageEventType>): void

关闭WindowStage生命周期变化的监听。

此接口仅可在Stage模型下使用。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
type	string	是	监听事件，固定为'windowStageEvent'，即WindowStage生命周期变化事件。
callback	Callback<WindowStageEventType>	否	回调函数。返回当前的WindowStage生命周期状态。

示例：

import Ability from '@ohos.application.Ability';
class myAbility extends Ability {
    onWindowStageCreate(windowStage) {
        console.log('onWindowStageCreate');
        windowStage.off('windowStageEvent');
    }
}

OpenHarmony/docs关闭 .gitee-modal { width: 500px !important; }

窗口

导入模块

WindowType7+

AvoidAreaType7+

WindowMode7+

WindowLayoutMode9+

SystemBarProperties

SystemBarRegionTint8+

SystemBarTintState8+

Rect7+

AvoidArea7+

Size7+

WindowProperties

ColorSpace8+

window.create7+

window.create7+

window.create8+

window.create8+

window.find7+

window.find7+

window.getTopWindow

window.getTopWindow

window.getTopWindow8+

window.getTopWindow8+

window.minimizeAll9+

window.minimizeAll9+

window.toggleShownStateForAllAppWindows9+

window.toggleShownStateForAllAppWindows9+

window.setWindowLayoutMode9+

window.setWindowLayoutMode9+

on('systemBarTintChange')8+

off('systemBarTintChange')8+

Window

hide7+

hide7+

show7+

show7+

destroy7+

destroy7+

moveTo7+

moveTo7+

resetSize7+

resetSize7+

setWindowType7+

setWindowType7+

getProperties

getProperties

getAvoidArea7+

getAvoidArea7+

setFullScreen

setFullScreen

setLayoutFullScreen7+

setLayoutFullScreen7+

setSystemBarEnable7+

setSystemBarEnable7+

setSystemBarProperties

setSystemBarProperties

loadContent7+

loadContent7+

loadContent9+

loadContent9+

isShowing7+

isShowing7+

on('windowSizeChange')7+

off('windowSizeChange')7+

on('systemAvoidAreaChange')7+

off('systemAvoidAreaChange')7+

on('keyboardHeightChange')7+

off('keyboardHeightChange')7+

isSupportWideGamut8+

isSupportWideGamut8+

setColorSpace8+

setColorSpace8+

getColorSpace8+

getColorSpace8+

setBackgroundColor

setBackgroundColor

setBrightness

setBrightness

OpenHarmony/docs
关闭

WindowType⁷⁺

AvoidAreaType⁷⁺

WindowMode⁷⁺

WindowLayoutMode⁹⁺

SystemBarRegionTint⁸⁺

SystemBarTintState⁸⁺

Rect⁷⁺

AvoidArea⁷⁺

Size⁷⁺

ColorSpace⁸⁺

window.create⁷⁺

window.create⁷⁺

window.create⁸⁺

window.create⁸⁺

window.find⁷⁺

window.find⁷⁺

window.getTopWindow⁸⁺

window.getTopWindow⁸⁺

window.minimizeAll⁹⁺

window.minimizeAll⁹⁺

window.toggleShownStateForAllAppWindows⁹⁺

window.toggleShownStateForAllAppWindows⁹⁺

window.setWindowLayoutMode⁹⁺

window.setWindowLayoutMode⁹⁺

on('systemBarTintChange')⁸⁺

off('systemBarTintChange')⁸⁺

hide⁷⁺

hide⁷⁺

show⁷⁺

show⁷⁺

destroy⁷⁺

destroy⁷⁺

moveTo⁷⁺

moveTo⁷⁺

resetSize⁷⁺

resetSize⁷⁺

setWindowType⁷⁺

setWindowType⁷⁺

getAvoidArea⁷⁺

getAvoidArea⁷⁺

setLayoutFullScreen⁷⁺

setLayoutFullScreen⁷⁺

setSystemBarEnable⁷⁺

setSystemBarEnable⁷⁺

loadContent⁷⁺

loadContent⁷⁺

loadContent⁹⁺

loadContent⁹⁺

isShowing⁷⁺

isShowing⁷⁺

on('windowSizeChange')⁷⁺

off('windowSizeChange')⁷⁺

on('systemAvoidAreaChange')⁷⁺

off('systemAvoidAreaChange')⁷⁺

on('keyboardHeightChange')⁷⁺

off('keyboardHeightChange')⁷⁺

isSupportWideGamut⁸⁺

isSupportWideGamut⁸⁺

setColorSpace⁸⁺

setColorSpace⁸⁺

getColorSpace⁸⁺

getColorSpace⁸⁺

setDimBehind^(deprecated)

setDimBehind^(deprecated)

setFocusable⁷⁺

setFocusable⁷⁺

setOutsideTouchable^(deprecated)

setOutsideTouchable^(deprecated)

setPrivacyMode⁷⁺

setPrivacyMode⁷⁺

setTouchable⁷⁺

setTouchable⁷⁺

WindowStageEventType⁹⁺

WindowStage⁹⁺

getMainWindow⁹⁺

getMainWindow⁹⁺

createSubWindow⁹⁺

createSubWindow⁹⁺

getSubWindow⁹⁺