窗口

窗口提供管理窗口的一些基礎能力，包括對當前窗口的創(chuàng)建、銷毀、各屬性設置，以及對各窗口間的管理調度。

該模塊提供以下窗口相關的常用功能：

• [Window]：當前窗口實例，窗口管理器管理的基本單元。
• [WindowStage]：窗口管理器。管理各個基本窗口單元。

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模塊首批接口從API version 6開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。

導入模塊

import window from '@ohos.window';

WindowType7+

窗口類型枚舉。

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

AvoidAreaType7+

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

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

WindowMode7+

窗口模式枚舉。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

WindowLayoutMode9+

窗口布局模式枚舉。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

SystemBarProperties

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

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

SystemBarRegionTint8+

單個導航欄或狀態(tài)欄回調信息。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

SystemBarTintState8+

當前系統(tǒng)欄回調信息集合。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

Rect7+

窗口矩形區(qū)域。

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

AvoidArea7+

窗口內容規(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.create7+

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

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

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

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

參數：

示例：

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.create7+

create(id: string, type: WindowType): Promise

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

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

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

參數：

返回值：

示例：

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.create8+

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

創(chuàng)建子窗口，使用callback異步回調，其中Context詳見[Context]。

從API version 9開始，當Context為[ServiceExtensionContext]時，創(chuàng)建系統(tǒng)窗口，使用callback異步回調。

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

參數：

示例：

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.create8+

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

創(chuàng)建子窗口，使用Promise異步回調，其中Context詳見[Context]

從API version 9開始，當Context為[ServiceExtensionContext]時，創(chuàng)建系統(tǒng)窗口，使用Promise異步回調。

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

參數：

返回值：

示例：

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.find7+

find(id: string, callback: AsyncCallback): void

查找id所對應的窗口，使用callback異步回調。

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

參數：

示例：

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.find7+

find(id: string): Promise

查找id所對應的窗口，使用Promise異步回調。

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

參數：

返回值：

示例：

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): void

獲取當前應用內最后顯示的窗口，使用callback異步回調。

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

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

參數：

示例：

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

獲取當前應用內最后顯示的窗口，使用Promise異步回調。

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

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

返回值：

示例：

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.getTopWindow8+

getTopWindow(ctx: Context, callback: AsyncCallback): void

獲取當前應用內最后顯示的窗口，使用callback異步回調。

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

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

參數：

示例：

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.getTopWindow8+

getTopWindow(ctx: Context): Promise

獲取當前應用內最后顯示的窗口，使用Promise異步回調。

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

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

參數：

返回值：

示例：

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.minimizeAll9+

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

最小化某顯示設備下的所有窗口。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

參數：

示例：

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.minimizeAll9+

minimizeAll(id: number): Promise

最小化某顯示設備下的所有窗口。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

參數：

返回值：

示例：

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.toggleShownStateForAllAppWindows9+

toggleShownStateForAllAppWindows(callback: AsyncCallback): void

多窗口快速切換時隱藏或者恢復應用窗口。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

參數：

示例：

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.toggleShownStateForAllAppWindows9+

toggleShownStateForAllAppWindows(): Promise

多窗口快速切換時隱藏或者恢復應用窗口。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

返回值：

示例：

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.setWindowLayoutMode9+

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

設置窗口布局模式。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

參數：

示例：

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

window.setWindowLayoutMode9+

setWindowLayoutMode(mode: WindowLayoutMode): Promise

設置窗口布局模式。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

參數：

返回值：

示例：

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')8+

on(type: 'systemBarTintChange', callback: Callback): void

開啟狀態(tài)欄、導航欄屬性變化的監(jiān)聽。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

參數：

示例：

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

off('systemBarTintChange')8+

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

關閉狀態(tài)欄、導航欄屬性變化的監(jiān)聽。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

參數：

示例：

window.off('systemBarTintChange');

Window

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

下列API示例中都需先使用[getTopWindow()]、[create()]、[find()]中的任一方法獲取到Window實例，再通過此實例調用對應方法。

hide7+

hide (callback: AsyncCallback): void

隱藏當前窗口，使用callback異步回調。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

參數：

示例：

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));
})

hide7+

hide(): Promise

隱藏當前窗口，使用Promise異步回調。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

返回值：

示例：

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));
})

show7+

show(callback: AsyncCallback): void

顯示當前窗口，使用callback異步回調。

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

參數：

示例：

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));
})

show7+

show(): Promise

顯示當前窗口，使用Promise異步回調。

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

返回值：

示例：

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));
})

destroy7+

destroy(callback: AsyncCallback): void

銷毀當前窗口，使用callback異步回調。

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

參數：

示例：

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));
})

destroy7+

destroy(): Promise

銷毀當前窗口，使用Promise異步回調。

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

返回值：

示例：

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));
})

moveTo7+

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

移動窗口位置，使用callback異步回調。

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

參數：

示例：

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));

});

moveTo7+

moveTo(x: number, y: number): Promise

移動窗口位置，使用Promise異步回調。

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

參數：

返回值：

示例：

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));
})

resetSize7+

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

改變當前窗口大小，使用callback異步回調。

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

參數：

示例：

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));
});

resetSize7+

resetSize(width: number, height: number): Promise

改變當前窗口大小，使用Promise異步回調。

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

參數：

返回值：

示例：

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));
});

setWindowType7+

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

設置窗口類型，使用callback異步回調。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

參數：

示例：

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));
});

setWindowType7+

setWindowType(type: WindowType): Promise

設置窗口類型，使用Promise異步回調。

此接口為系統(tǒng)接口，三方應用不支持調用。

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

參數：

返回值：

示例：

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): void

獲取當前窗口的屬性，使用callback異步回調，返回WindowProperties。

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

參數：

示例：

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

獲取當前窗口的屬性，使用Promise異步回調，返回WindowProperties。

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

返回值：

示例：

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));
});

getAvoidArea7+

getAvoidArea(type: AvoidAreaType, callback: AsyncCallback): void

獲取窗口內容規(guī)避的區(qū)域，如系統(tǒng)的系統(tǒng)欄區(qū)域、凹凸區(qū)域。使用callback異步回調。

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

參數：

示例：

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));
});

getAvoidArea7+

getAvoidArea(type: AvoidAreaType): Promise

獲取窗口內容規(guī)避的區(qū)域，如系統(tǒng)的系統(tǒng)欄區(qū)域、凹凸區(qū)域。使用Promise異步回調。

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

參數：

返回值：

示例：

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

設置是否為全屏狀態(tài)，使用callback異步回調。

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

參數：

示例：

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

設置是否為全屏狀態(tài)，使用Promise異步回調。

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

參數：

返回值：

示例：

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));
});

setLayoutFullScreen7+

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

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

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

參數：

示例：

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));
});

setLayoutFullScreen7+

setLayoutFullScreen(isLayoutFullScreen: boolean): Promise

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

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

參數：

返回值：

示例：

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));
});

setSystemBarEnable7+

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

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

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

參數：

示例：

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));
});

setSystemBarEnable7+

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

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

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

參數：

返回值：

示例：

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

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

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

參數：

示例：

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

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

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

參數：

返回值：

示例：

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));
});

loadContent7+

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

為當前窗口加載具體頁面內容，使用callback異步回調。

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

參數：

示例：

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));
});

loadContent7+

loadContent(path: string): Promise

為當前窗口加載具體頁面內容，使用Promise異步回調。

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

參數：

返回值：

示例：

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));
});

loadContent9+

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

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

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

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

參數：

示例：

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));
        });
    }
}

loadContent9+

loadContent(path: string, storage: LocalStorage): Promise

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

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

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

參數：

返回值：

示例：

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));
        })
    }
}

isShowing7+

isShowing(callback: AsyncCallback): void

判斷當前窗口是否已顯示，使用callback異步回調。

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

參數：

示例：

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));
});

isShowing7+

isShowing(): Promise

判斷當前窗口是否已顯示，使用Promise異步回調。

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

返回值：

示例：

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')7+

on(type: 'windowSizeChange', callback: Callback): void

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

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

參數：

示例：

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

off('windowSizeChange')7+

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

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

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

參數：

示例：

windowClass.off('windowSizeChange');

on('systemAvoidAreaChange')7+

on(type: 'systemAvoidAreaChange', callback: Callback): void

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

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

參數：

示例：

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

off('systemAvoidAreaChange')7+

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

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

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

參數：

示例：

windowClass.off('systemAvoidAreaChange');

on('keyboardHeightChange')7+

on(type: 'keyboardHeightChange', callback: Callback): void

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

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

參數：

示例：

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

off('keyboardHeightChange')7+

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

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

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

參數：

示例：

windowClass.off('keyboardHeightChange');

isSupportWideGamut8+

isSupportWideGamut(callback: AsyncCallback): void

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

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

參數：

示例：

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));
})

isSupportWideGamut8+

isSupportWideGamut(): Promise

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

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

返回值：

示例：

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));
});

setColorSpace8+

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

設置當前窗口為廣色域模式或默認色域模式，使用callback異步回調。

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

參數：

示例：

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));
})

setColorSpace8+

setColorSpace(colorSpace:ColorSpace): Promise

設置當前窗口為廣色域模式或默認色域模式，使用Promise異步回調。

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

參數：

返回值：

示例：

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));
});

getColorSpace8+

getColorSpace(callback: AsyncCallback): void

獲取當前窗口色域模式，使用callback異步回調。

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

參數：

示例：

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));
})

getColorSpace8+

getColorSpace(): Promise

獲取當前窗口色域模式，使用Promise異步回調。

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

返回值：

示例：

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

設置窗口的背景色，使用callback異步回調。

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

參數：

示例：

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

設置窗口的背景色，使用Promise異步回調。

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

參數：

返回值：

示例：

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

設置屏幕亮度值，使用callback異步回調。

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

參數：

示例：

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

設置屏幕亮度值，使用Promise異步回調。

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

參數：

返回值：

示例：

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

窗口疊加時，設備有子窗口的情況下設置靠后的窗口的暗度值，使用callback異步回調。

說明： 從API version 9開始廢棄。

從 API version 7開始支持。

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

參數：

示例：

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

窗口疊加時，設備有子窗口的情況下設置靠后的窗口的暗度值，使用Promise異步回調。

說明： 從API version 9開始廢棄。

從 API version 7開始支持。

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

參數：

返回值：

示例：

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));
});

setFocusable7+

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

設置點擊時是否支持切換焦點窗口，使用callback異步回調。

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

參數：

示例：

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));
});

setFocusable7+

setFocusable(isFocusable: boolean): Promise

設置點擊時是否支持切換焦點窗口，使用Promise異步回調。

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

參數：

返回值：

示例：

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

設置屏幕是否為常亮狀態(tài)，使用callback異步回調。

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

參數：

示例：

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

設置屏幕是否為常亮狀態(tài)，使用Promise異步回調。

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

參數：

返回值：

示例：

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

設置是否允許可點擊子窗口之外的區(qū)域，使用callback異步回調。

說明： 從API version 9開始廢棄。

從 API version 7開始支持。

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

參數：

示例：

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

設置是否允許可點擊子窗口之外的區(qū)域，使用Promise異步回調。。

說明： 從API version 9開始廢棄。

從 API version 7開始支持。

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

參數：

返回值：

示例：

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));
});

setPrivacyMode7+

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

設置窗口是否為隱私模式，使用callback異步回調。

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

參數：

示例：

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));

});

setPrivacyMode7+

setPrivacyMode(isPrivacyMode: boolean): Promise

設置窗口是否為隱私模式，使用Promise異步回調。

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

參數：

返回值：

示例：

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));
});

setTouchable7+

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

設置窗口是否為可觸狀態(tài)，使用callback異步回調。

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

參數：

示例：

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));

});

setTouchable7+

setTouchable(isTouchable: boolean): Promise

設置窗口是否為可觸狀態(tài)，使用Promise異步回調。

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

參數：

返回值：

示例：

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));
});

WindowStageEventType9+

WindowStage生命周期。

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

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

WindowStage9+

窗口管理器。管理各個基本窗口單元，即[Window]實例。

下列API示例中都需在[onWindowStageCreate()]函數中使用WindowStage的實例調用對應方法。

getMainWindow9+

getMainWindow(callback: AsyncCallback): void

獲取該WindowStage實例下的主窗口，使用callback異步回調。

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

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

參數：

示例：

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));
        });
    }
}

getMainWindow9+

getMainWindow(): Promise

獲取該WindowStage實例下的主窗口，使用Promise異步回調。

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

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

返回值：

示例：

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));
        });
    }
}

createSubWindow9+

createSubWindow(name: string, callback: AsyncCallback): void

創(chuàng)建該WindowStage實例下的子窗口，使用callback異步回調。

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

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

參數：

示例：

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);
        });
    }
}

createSubWindow9+

createSubWindow(name: string): Promise

創(chuàng)建該WindowStage實例下的子窗口，使用Promise異步回調。

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

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

參數：

返回值：

示例：

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));
        })
    }
}

getSubWindow9+

getSubWindow(callback: AsyncCallback>): void

獲取該WindowStage實例下的所有子窗口，使用callback異步回調。

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

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

參數：

示例：

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));
        });
    }
}

getSubWindow9+

getSubWindow(): Promise>

獲取該WindowStage實例下的所有子窗口，使用Promise異步回調。

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

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

返回值：

示例：

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));
        })
    }
}

loadContent9+

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

為當前WindowStage的主窗口加載與LocalStorage相關聯(lián)的具體頁面內容，使用callback異步回調。

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

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

參數：

示例：

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));
        });
    }
}

loadContent9+

loadContent(path: string, storage?: LocalStorage): Promise

為當前WindowStage的主窗口加載與LocalStorage相關聯(lián)的具體頁面內容，使用Promise異步回調。

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

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

參數：

返回值：

示例：

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));
        })
    }
}

loadContent9+

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

為當前WindowStage的主窗口加載具體頁面內容，使用callback異步回調。

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

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

參數：

示例：

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')9+

on(eventType: 'windowStageEvent', callback: Callback): void

開啟WindowStage生命周期變化的監(jiān)聽。

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

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

參數：

示例：

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')9+

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

關閉WindowStage生命周期變化的監(jiān)聽。

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

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

參數：

示例：

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

審核編輯 黃宇