1# @ohos.application.WindowExtensionAbility (窗口扩展能力) 2 3WindowExtensionAbility基于ExtensionAbility。WindowExtensionAbility中展示的内容可作为一个控件(AbilityComponent)内容展示在其他应用窗口中。 4 5> **说明：** 6> 7> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8> 9> 本模块接口为系统接口。 10> 11> 本模块接口仅可在Stage模型下使用。 12 13## 导入模块 14 15```ts 16import WindowExtensionAbility from '@ohos.application.WindowExtensionAbility'; 17``` 18 19## 属性 20 21**系统能力：** SystemCapability.WindowManager.WindowManager.Core 22 23| 名称 | 类型 | 可读 | 可写 | 说明 | 24| --------- | -------- | ---- | ---- | ------------------------- | 25| context | [WindowExtensionContext](js-apis-inner-application-windowExtensionContext.md) | 是 | 否 | 上下文。 | 26 27## WindowExtensionAbility.onConnect 28 29onConnect(want: Want): void 30 31当窗口扩展组件第一次连接ability时回调。 32 33**系统能力：** SystemCapability.WindowManager.WindowManager.Core 34 35**参数：** 36 37| 参数名 | 类型 | 必填 | 说明 | 38| -------- | -------- | -------- | -------- | 39| want | [Want](js-apis-application-want.md) | 是 | 当前ability的Want类型信息，包括ability名称、bundle名称等。 | 40 41**示例：** 42 43```ts 44export default class MyWindowExtensionAbility extends WindowExtensionAbility { 45 46 onConnect(want) { 47 console.info('WindowExtAbility onConnect ' + want.abilityName); 48 } 49 50} 51``` 52 53## WindowExtensionAbility.onDisconnect 54 55onDisconnect(want: Want): void 56 57当所有连接到窗口扩展组件的ability断开连接时回调。 58 59**系统能力：** SystemCapability.WindowManager.WindowManager.Core 60 61**参数：** 62 63| 参数名 | 类型 | 必填 | 说明 | 64| -------- | -------- | -------- | -------- | 65| want | [Want](js-apis-application-want.md) | 是 | 当前Ability的Want类型信息，包括ability名称、bundle名称等。 | 66 67 68**示例：** 69 70```ts 71export default class MyWindowExtensionAbility extends WindowExtensionAbility { 72 73 onDisconnect(want) { 74 console.info('WindowExtAbility onDisconnect ' + want.abilityName); 75 } 76 77} 78``` 79 80## WindowExtensionAbility.onWindowReady 81 82onWindowReady(window: window.Window): void 83 84当窗口被创建时回调。 85 86**系统能力：** SystemCapability.WindowManager.WindowManager.Core 87 88**参数：** 89 90| 参数名 | 类型 | 必填 | 说明 | 91| -------- | -------- | -------- | -------- | 92| window | [window.Window](js-apis-window.md#window) | 是 | 当前窗口实例。 | 93 94 95**示例：** 96 97```ts 98export default class MyWindowExtensionAbility extends WindowExtensionAbility { 99 100 onWindowReady(window) { 101 window.loadContent('WindowExtAbility/pages/index1').then(() => { 102 window.getProperties().then((pro) => { 103 console.log('WindowExtension ' + JSON.stringify(pro)); 104 }); 105 window.show(); 106 }); 107 } 108 109} 110```