@ohos.application.WindowExtensionAbility (窗口扩展能力)
WindowExtensionAbility基于ExtensionAbility。WindowExtensionAbility中展示的内容可作为一个控件(AbilityComponent)内容展示在其他应用窗口中。
说明:
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
本模块接口为系统接口。
本模块接口仅可在Stage模型下使用。
导入模块
import WindowExtensionAbility from '@ohos.application.WindowExtensionAbility';
属性
系统能力: SystemCapability.WindowManager.WindowManager.Core
名称 | 类型 | 可读 | 可写 | 说明 |
---|---|---|---|---|
context | WindowExtensionContext | 是 | 否 | 上下文。 |
WindowExtensionAbility.onConnect
onConnect(want: Want): void
当窗口扩展组件第一次连接ability时回调。
系统能力: SystemCapability.WindowManager.WindowManager.Core
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
want | Want | 是 | 当前ability的Want类型信息,包括ability名称、bundle名称等。 |
示例:
export default class MyWindowExtensionAbility extends WindowExtensionAbility {
onConnect(want) {
console.info('WindowExtAbility onConnect ' + want.abilityName);
}
}
WindowExtensionAbility.onDisconnect
onDisconnect(want: Want): void
当所有连接到窗口扩展组件的ability断开连接时回调。
系统能力: SystemCapability.WindowManager.WindowManager.Core
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
want | Want | 是 | 当前Ability的Want类型信息,包括ability名称、bundle名称等。 |
示例:
export default class MyWindowExtensionAbility extends WindowExtensionAbility {
onDisconnect(want) {
console.info('WindowExtAbility onDisconnect ' + want.abilityName);
}
}
WindowExtensionAbility.onWindowReady
onWindowReady(window: window.Window): void
当窗口被创建时回调。
系统能力: SystemCapability.WindowManager.WindowManager.Core
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
window | window.Window | 是 | 当前窗口实例。 |
示例:
export default class MyWindowExtensionAbility extends WindowExtensionAbility {
onWindowReady(window) {
window.loadContent('WindowExtAbility/pages/index1').then(() => {
window.getProperties().then((pro) => {
console.log('WindowExtension ' + JSON.stringify(pro));
});
window.show();
});
}
}