窗口

導入模塊

import window from '@ohos.window';

WindowType7+

窗口類型枚舉。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

Configuration9+

創(chuàng)建子窗口時的參數(shù)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

AvoidAreaType7+

窗口內(nèi)容需要規(guī)避區(qū)域的類型枚舉。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

SystemBarProperties

狀態(tài)欄、導航欄的屬性。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

Orientation9+

窗口顯示方向類型枚舉。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

Rect7+

窗口矩形區(qū)域。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

AvoidArea7+

窗口內(nèi)容規(guī)避區(qū)域。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

Size7+

窗口大小。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

WindowProperties

窗口屬性。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

ColorSpace8+

色域模式。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

window.createWindow9+

createWindow(config: Configuration, callback: AsyncCallback<Window>): void

創(chuàng)建子窗口，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let windowClass = null;
let config = {name: "alertWindow", windowType: window.WindowType.TYPE_SYSTEM_ALERT, ctx: this.context};
try {
    window.createWindow(config, (err, data) => {
        if (err.code) {
            console.error('Failed to create the window. Cause: ' + JSON.stringify(err));
            return;
        }
        windowClass = data;
        console.info('Succeeded in creating the window. Data: ' + JSON.stringify(data));
        windowClass.resize(500, 1000);
    });
} catch (exception) {
    console.error('Failed to create the window. Cause: ' + JSON.stringify(exception));
}

window.createWindow9+

createWindow(config: Configuration): Promise<Window>

創(chuàng)建子窗口，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let windowClass = null;
let config = {name: "alertWindow", windowType: window.WindowType.TYPE_SYSTEM_ALERT, ctx: this.context};
try {
    let promise = window.createWindow(config);
    promise.then((data)=> {
        windowClass = data;
        console.info('Succeeded in creating the window. Data:' + JSON.stringify(data));
    }).catch((err)=>{
        console.error('Failed to create the Window. Cause:' + JSON.stringify(err));
    });
} catch (exception) {
    console.error('Failed to create the window. Cause: ' + JSON.stringify(exception));
}

window.findWindow9+

findWindow(name: string): Window

查找name所對應的窗口。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

示例：

let windowClass = null;
try {
    windowClass = window.findWindow('alertWindow');
} catch (exception) {
    console.error('Failed to find the Window. Cause: ' + JSON.stringify(exception));
}

window.getLastWindow9+

getLastWindow(ctx: BaseContext, callback: AsyncCallback<Window>): void

獲取當前應用內(nèi)最上層的子窗口，若無應用子窗口，則返回應用主窗口，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';

class myAbility extends UIAbility {
  // ...
  onWindowStageCreate(windowStage) {
    console.log('onWindowStageCreate');
    let windowClass = undefined;
    try {
      window.getLastWindow(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));
      });
    } catch (exception) {
      console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(exception));
    }
  }
}

window.getLastWindow9+

getLastWindow(ctx: BaseContext): Promise<Window>

獲取當前應用內(nèi)最上層的子窗口，若無應用子窗口，則返回應用主窗口，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';

class myAbility extends UIAbility {
  // ...
  onWindowStageCreate(windowStage) {
    console.log('onWindowStageCreate');
    let windowClass = undefined;
    try {
      let promise = window.getLastWindow(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));
      });
    } catch (exception) {
      console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(exception));
    }
  };
}

window.create(deprecated)

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

創(chuàng)建子窗口，使用callback異步回調(diào)。

模型約束： 此接口僅可在FA模型下使用。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

let windowClass = null;
window.create('first', window.WindowType.TYPE_APP,(err,data) => {
    if(err.code){
        console.error('Failed to create the subWindow. Cause: ' + JSON.stringify(err));
        return;
    }
    windowClass = data;
    console.info('Succeeded in creating the subWindow. Data: ' + JSON.stringify(data));
});

window.create(deprecated)

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

創(chuàng)建子窗口，使用Promise異步回調(diào)。

模型約束： 此接口僅可在FA模型下使用。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

示例：

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

window.create(deprecated)

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

創(chuàng)建子窗口，使用callback異步回調(diào)。

當前此接口僅可在FA模型下使用。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

let 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('Succeeded in creating the window. Data: ' + JSON.stringify(data));
    windowClass.resetSize(500, 1000);
});

window.create(deprecated)

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

創(chuàng)建子窗口，使用Promise異步回調(diào)。

當前此接口僅可在FA模型下使用。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

示例：

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

window.find(deprecated)

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

查找id所對應的窗口，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

let 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('Succeeded in finding the window. Data: ' + JSON.stringify(data));
});

window.find(deprecated)

find(id: string): Promise<Window>

查找id所對應的窗口，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

示例：

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

window.getTopWindow(deprecated)

getTopWindow(callback: AsyncCallback<Window>): void

獲取當前應用內(nèi)最后顯示的窗口，使用callback異步回調(diào)。

模型約束： 此接口僅可在FA模型下使用。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

let 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(deprecated)

getTopWindow(): Promise<Window>

獲取當前應用內(nèi)最后顯示的窗口，使用Promise異步回調(diào)。

模型約束： 此接口僅可在FA模型下使用。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

示例：

let 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(deprecated)

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

獲取當前應用內(nèi)最后顯示的窗口，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

let 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(deprecated)

getTopWindow(ctx: BaseContext): Promise<Window>

獲取當前應用內(nèi)最后顯示的窗口，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

示例：

let 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

當前窗口實例，窗口管理器管理的基本單元。

下列API示例中都需先使用getLastWindow()、createWindow()、findWindow()中的任一方法獲取到Window實例，再通過此實例調(diào)用對應方法。

showWindow9+

showWindow(callback: AsyncCallback<void>): void

顯示當前窗口，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

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

showWindow9+

showWindow(): Promise<void>

顯示當前窗口，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

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

destroyWindow9+

destroyWindow(callback: AsyncCallback<void>): void

銷毀當前窗口，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

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

destroyWindow9+

destroyWindow(): Promise<void>

銷毀當前窗口，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

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

moveWindowTo9+

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

移動窗口位置，使用callback異步回調(diào)。

全屏模式窗口不支持該操作。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

try {
    windowClass.moveWindowTo(300, 300, (err)=>{
        if (err.code) {
            console.error('Failed to move the window. Cause:' + JSON.stringify(err));
            return;
        }
        console.info('Succeeded in moving the window.');
    });
} catch (exception) {
    console.error('Failed to move the window. Cause:' + JSON.stringify(exception));
}

moveWindowTo9+

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

移動窗口位置，使用Promise異步回調(diào)。

全屏模式窗口不支持該操作。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

try {
    let promise = windowClass.moveWindowTo(300, 300);
    promise.then(()=> {
        console.info('Succeeded in moving the window.');
    }).catch((err)=>{
        console.error('Failed to move the window. Cause: ' + JSON.stringify(err));
    });
} catch (exception) {
    console.error('Failed to move the window. Cause:' + JSON.stringify(exception));
}

resize9+

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

改變當前窗口大小，使用callback異步回調(diào)。

應用主窗口與子窗口存在大小限制，寬度范圍：[320, 2560]，高度范圍：[240, 2560]，單位為vp。

系統(tǒng)窗口存在大小限制，寬度范圍：[0, 2560]，高度范圍：[0, 2560]，單位為vp。

設(shè)置的寬度與高度受到此約束限制，規(guī)則： 若所設(shè)置的窗口寬/高尺寸小于窗口最小寬/高限值，則窗口最小寬/高限值生效； 若所設(shè)置的窗口寬/高尺寸大于窗口最大寬/高限值，則窗口最大寬/高限值生效。

全屏模式窗口不支持該操作。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

try {
    windowClass.resize(500, 1000, (err) => {
        if (err.code) {
            console.error('Failed to change the window size. Cause:' + JSON.stringify(err));
            return;
        }
        console.info('Succeeded in changing the window size.');
    });
} catch (exception) {
    console.error('Failed to change the window size. Cause:' + JSON.stringify(exception));
}

resize9+

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

改變當前窗口大小，使用Promise異步回調(diào)。

應用主窗口與子窗口存在大小限制，寬度范圍：[320, 2560]，高度范圍：[240, 2560]，單位為vp。

系統(tǒng)窗口存在大小限制，寬度范圍：[0, 2560]，高度范圍：[0, 2560]，單位為vp。

設(shè)置的寬度與高度受到此約束限制，規(guī)則： 若所設(shè)置的窗口寬/高尺寸小于窗口最小寬/高限值，則窗口最小寬/高限值生效； 若所設(shè)置的窗口寬/高尺寸大于窗口最大寬/高限值，則窗口最大寬/高限值生效。

全屏模式窗口不支持該操作。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

try {
    let promise = windowClass.resize(500, 1000);
    promise.then(()=> {
        console.info('Succeeded in changing the window size.');
    }).catch((err)=>{
        console.error('Failed to change the window size. Cause: ' + JSON.stringify(err));
    });
} catch (exception) {
    console.error('Failed to change the window size. Cause: ' + JSON.stringify(exception));
}

getWindowProperties9+

getWindowProperties(): WindowProperties

獲取當前窗口的屬性，返回WindowProperties。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

try {
    let properties = windowClass.getWindowProperties();
} catch (exception) {
    console.error('Failed to obtain the window properties. Cause: ' + JSON.stringify(exception));
}

getWindowAvoidArea9+

getWindowAvoidArea(type: AvoidAreaType): AvoidArea

獲取窗口內(nèi)容規(guī)避的區(qū)域；如系統(tǒng)欄區(qū)域、劉海屏區(qū)域、手勢區(qū)域、軟鍵盤區(qū)域等與窗口內(nèi)容重疊時，需要窗口內(nèi)容避讓的區(qū)域。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let type = window.AvoidAreaType.TYPE_SYSTEM;
try {
    let avoidArea = windowClass.getWindowAvoidArea(type);
} catch (exception) {
    console.error('Failed to obtain the area. Cause:' + JSON.stringify(exception));
}

setWindowLayoutFullScreen9+

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

設(shè)置窗口的布局是否為全屏顯示狀態(tài)，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let isLayoutFullScreen= true;
try {
    windowClass.setWindowLayoutFullScreen(isLayoutFullScreen, (err) => {
        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.');
    });
} catch (exception) {
    console.error('Failed to set the window layout to full-screen mode. Cause:' + JSON.stringify(exception));
}

setWindowLayoutFullScreen9+

setWindowLayoutFullScreen(isLayoutFullScreen: boolean): Promise<void>

設(shè)置窗口的布局是否為全屏顯示狀態(tài)，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

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

setWindowSystemBarEnable9+

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

設(shè)置導航欄、狀態(tài)欄的可見模式，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

// 此處以不顯示導航欄、狀態(tài)欄為例
let names = [];
try {
    windowClass.setWindowSystemBarEnable(names, (err) => {
        if (err.code) {
            console.error('Failed to set the system bar to be invisible. Cause:' + JSON.stringify(err));
            return;
        }
        console.info('Succeeded in setting the system bar to be invisible.');
    });
} catch (exception) {
    console.error('Failed to set the system bar to be invisible. Cause:' + JSON.stringify(exception));
}

setWindowSystemBarEnable9+

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

設(shè)置導航欄、狀態(tài)欄的可見模式，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

// 此處以不顯示導航欄、狀態(tài)欄為例
let names = [];
try {
    let promise = windowClass.setWindowSystemBarEnable(names);
    promise.then(()=> {
        console.info('Succeeded in setting the system bar to be invisible.');
    }).catch((err)=>{
        console.error('Failed to set the system bar to be invisible. Cause:' + JSON.stringify(err));
    });
} catch (exception) {
    console.error('Failed to set the system bar to be invisible. Cause:' + JSON.stringify(exception));
}

setWindowSystemBarProperties9+

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

設(shè)置窗口內(nèi)導航欄、狀態(tài)欄的屬性，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let SystemBarProperties = {
    statusBarColor: '#ff00ff',
    navigationBarColor: '#00ff00',
    //以下兩個屬性從API Version8開始支持
    statusBarContentColor:'#ffffff',
    navigationBarContentColor:'#00ffff'
};
try {
    windowClass.setWindowSystemBarProperties(SystemBarProperties, (err) => {
        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.');
    });
} catch (exception) {
    console.error('Failed to set the system bar properties. Cause: ' + JSON.stringify(exception));
}

setWindowSystemBarProperties9+

setWindowSystemBarProperties(systemBarProperties: SystemBarProperties): Promise<void>

設(shè)置窗口內(nèi)導航欄、狀態(tài)欄的屬性，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let SystemBarProperties = {
    statusBarColor: '#ff00ff',
    navigationBarColor: '#00ff00',
    //以下兩個屬性從API Version8開始支持
    statusBarContentColor:'#ffffff',
    navigationBarContentColor:'#00ffff'
};
try {
    let promise = windowClass.setWindowSystemBarProperties(SystemBarProperties);
    promise.then(()=> {
        console.info('Succeeded in setting the system bar properties.');
    }).catch((err)=>{
        console.error('Failed to set the system bar properties. Cause: ' + JSON.stringify(err));
    });
} catch (exception) {
    console.error('Failed to set the system bar properties. Cause: ' + JSON.stringify(exception));
}

setPreferredOrientation9+

setPreferredOrientation(orientation: Orientation, callback: AsyncCallback<void>): void

設(shè)置窗口的顯示方向?qū)傩裕褂胏allback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let orientation = window.Orientation.AUTO_ROTATION;
try {
    windowClass.setPreferredOrientation(orientation, (err) => {
        if (err.code) {
            console.error('Failed to set window orientation. Cause: ' + JSON.stringify(err));
            return;
        }
        console.info('Succeeded in setting window orientation.');
    });
} catch (exception) {
    console.error('Failed to set window orientation. Cause: ' + JSON.stringify(exception));
}

setPreferredOrientation9+

setPreferredOrientation(orientation: Orientation): Promise<void>

設(shè)置窗口的顯示方向?qū)傩裕褂肞romise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let orientation = window.Orientation.AUTO_ROTATION;
try {
    let promise = windowClass.setPreferredOrientation(orientation);
    promise.then(()=> {
        console.info('Succeeded in setting the window orientation.');
    }).catch((err)=>{
        console.error('Failed to set the window orientation. Cause: ' + JSON.stringify(err));
    });
} catch (exception) {
    console.error('Failed to set window orientation. Cause: ' + JSON.stringify(exception));
}

setUIContent9+

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

為當前窗口加載具體頁面內(nèi)容，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

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

setUIContent9+

setUIContent(path: string): Promise<void>

為當前窗口加載具體頁面內(nèi)容，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

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

loadContent9+

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

為當前窗口加載與LocalStorage相關(guān)聯(lián)的具體頁面內(nèi)容，使用callback異步回調(diào)。

模型約束： 此接口僅可在Stage模型下使用。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let storage = new LocalStorage();
storage.setOrCreate('storageSimpleProp',121);
console.log('onWindowStageCreate');
try {
    windowClass.loadContent('pages/page2', storage, (err) => {
        if (err.code) {
            console.error('Failed to load the content. Cause:' + JSON.stringify(err));
            return;
        }
        console.info('Succeeded in loading the content.');
    });
} catch (exception) {
    console.error('Failed to load the content. Cause:' + JSON.stringify(exception));
}

loadContent9+

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

為當前窗口加載與LocalStorage相關(guān)聯(lián)的具體頁面內(nèi)容，使用Promise異步回調(diào)。

模型約束： 此接口僅可在Stage模型下使用。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let storage = new LocalStorage();
storage.setOrCreate('storageSimpleProp',121);
console.log('onWindowStageCreate');
try {
    let promise = windowClass.loadContent('pages/page2', storage);
    promise.then(() => {
        console.info('Succeeded in loading the content.');
    }).catch((err) => {
        console.error('Failed to load the content. Cause:' + JSON.stringify(err));
    });
} catch (exception) {
    console.error('Failed to load the content. Cause:' + JSON.stringify(exception));
}

isWindowShowing9+

isWindowShowing(): boolean

判斷當前窗口是否已顯示。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

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

on('windowSizeChange')7+

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

開啟窗口尺寸變化的監(jiān)聽。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

try {
    windowClass.on('windowSizeChange', (data) => {
        console.info('Succeeded in enabling the listener for window size changes. Data: ' + JSON.stringify(data));
    });
} catch (exception) {
    console.error('Failed to enable the listener for window size changes. Cause: ' + JSON.stringify(exception));
}

off('windowSizeChange')7+

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

關(guān)閉窗口尺寸變化的監(jiān)聽。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

try {
    windowClass.off('windowSizeChange');
} catch (exception) {
    console.error('Failed to disable the listener for window size changes. Cause: ' + JSON.stringify(exception));
}

on('avoidAreaChange')9+

on(type: 'avoidAreaChange', callback: Callback<{type: AvoidAreaType, area: AvoidArea}>): void

開啟系統(tǒng)規(guī)避區(qū)變化的監(jiān)聽。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

try {
    windowClass.on('avoidAreaChange', (data) => {
        console.info('Succeeded in enabling the listener for system avoid area changes. type:' +
            JSON.stringify(data.type) + ', area: ' + JSON.stringify(data.area));
    });
} catch (exception) {
    console.error('Failed to enable the listener for system avoid area changes. Cause: ' + JSON.stringify(exception));
}

off('avoidAreaChange')9+

off(type: 'avoidAreaChange', callback?: Callback<{type: AvoidAreaType, area: AvoidArea}>): void

關(guān)閉系統(tǒng)規(guī)避區(qū)變化的監(jiān)聽。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

try {
    windowClass.off('avoidAreaChange');
} catch (exception) {
    console.error('Failed to disable the listener for system avoid area changes. Cause: ' + JSON.stringify(exception));
}

on('keyboardHeightChange')7+

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

開啟鍵盤高度變化的監(jiān)聽。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

try {
    windowClass.on('keyboardHeightChange', (data) => {
        console.info('Succeeded in enabling the listener for keyboard height changes. Data: ' + JSON.stringify(data));
    });
} catch (exception) {
    console.error('Failed to enable the listener for keyboard height changes. Cause: ' + JSON.stringify(exception));
}

off('keyboardHeightChange')7+

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

關(guān)閉鍵盤高度變化的監(jiān)聽。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

try {
    windowClass.off('keyboardHeightChange');
} catch (exception) {
    console.error('Failed to disable the listener for keyboard height changes. Cause: ' + JSON.stringify(exception));
}

on('screenshot')9+

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

開啟截屏事件的監(jiān)聽。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

try {
    windowClass.on('screenshot', () => {
        console.info('screenshot happened');
    });
} catch (exception) {
    console.error('Failed to register callback. Cause: ' + JSON.stringify(exception));
}

off('screenshot')9+

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

關(guān)閉截屏事件的監(jiān)聽。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

let callback = () => {
    console.info('screenshot happened');
};
try {
    windowClass.on('screenshot', callback);
} catch (exception) {
    console.error('Failed to register callback. Cause: ' + JSON.stringify(exception));
}
try {
    windowClass.off('screenshot', callback);
    // 如果通過on開啟多個callback進行監(jiān)聽，同時關(guān)閉所有監(jiān)聽：
    windowClass.off('screenshot');
} catch (exception) {
    console.error('Failed to unregister callback. Cause: ' + JSON.stringify(exception));
}

isWindowSupportWideGamut9+

isWindowSupportWideGamut(callback: AsyncCallback<boolean>): void

判斷當前窗口是否支持廣色域模式，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

windowClass.isWindowSupportWideGamut((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));
});

isWindowSupportWideGamut9+

isWindowSupportWideGamut(): Promise<boolean>

判斷當前窗口是否支持廣色域模式，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let promise = windowClass.isWindowSupportWideGamut();
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));
});

setWindowColorSpace9+

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

設(shè)置當前窗口為廣色域模式或默認色域模式，使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

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

setWindowColorSpace9+

setWindowColorSpace(colorSpace:ColorSpace): Promise<void>

設(shè)置當前窗口為廣色域模式或默認色域模式，使用Promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

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

getWindowColorSpace9+

getWindowColorSpace(): ColorSpace

獲取當前窗口色域模式。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let colorSpace = windowClass.getWindowColorSpace();

setWindowBackgroundColor9+

setWindowBackgroundColor(color: string): void

設(shè)置窗口的背景色。Stage模型下，該接口需要在loadContent或setUIContent之后使用。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let color = '#00ff33';
try {
    windowClass.setWindowBackgroundColor(color);
} catch (exception) {
    console.error('Failed to set the background color. Cause: ' + JSON.stringify(exception));
}

setWindowBrightness9+

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

設(shè)置屏幕亮度值，使用callback異步回調(diào)。

當前屏幕亮度規(guī)格：窗口設(shè)置屏幕亮度生效時，控制中心不可以調(diào)整系統(tǒng)屏幕亮度，窗口恢復默認系統(tǒng)亮度之后，控制中心可以調(diào)整系統(tǒng)屏幕亮度。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見窗口錯誤碼。

示例：

let brightness = 1;
try {
    windowClass.setWindowBrightness(brightness, (err) => {
        if (err.code) {
            console.error('Failed to set the brightness. Cause: ' + JSON.stringify(err));
            return;
        }
        console.info('Succeeded in setting the brightness.');
    });
} catch (exception) {
    console.error('Failed to set the brightness. Cause: ' + JSON.stringify(exception));
}