WindowExtensionContext
WindowExtensionContext
WindowExtensionContext模块是WindowExtensionAbility的上下文环境,继承自ExtensionContext。
WindowExtensionContext模块提供WindowExtensionAbility具有的能力,包括启动Ability。
说明:
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
本模块接口为系统接口。
本模块接口仅可在Stage模型下使用。
使用说明
在使用WindowExtensionContext的功能前,需要通过WindowExtensionAbility子类实例获取。
import WindowExtensionAbility from '@ohos.application.WindowExtensionAbility';
let context;
class WindowExtAbility extends WindowExtensionAbility {
onConnect() {
context = this.context; // 获取WindowExtensionContext
}
}
2
3
4
5
6
7
8
WindowExtensionContext.startAbility
startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void
启动Ability,使用callback异步回调。
系统能力:SystemCapability.WindowManager.WindowManager.Core
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
want | Want | 是 | 启动Ability的want信息。 |
options | StartOptions | 是 | 启动Ability所携带的参数。 |
callback | AsyncCallback<void> | 是 | callback形式返回启动结果。 |
示例:
var want = {
bundleName: 'com.example.myapplication',
abilityName: 'MainAbility'
};
var options = {
windowMode: 102
};
try {
this.context.startAbility(want, options, (error) => {
if (error.code) {
// 处理业务逻辑错误
console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}');
return;
}
// 执行正常业务
console.log('startAbility succeed');
});
} catch (paramError) {
// 处理入参错误异常
console.error('error.code: ${paramError.code}, error.message: ${paramError.message}');
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
WindowExtensionContext.startAbility
startAbility(want: Want, options?: StartOptions): Promise<void>
启动Ability,使用Promise异步回调。
系统能力:SystemCapability.WindowManager.WindowManager.Core
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
want | Want | 是 | Want类型参数,传入需要启动的ability的信息,如Ability名称,Bundle名称等。 |
options | StartOptions | 否 | 启动Ability所携带的参数。 |
返回值:
类型 | 说明 |
---|---|
Promise<void> | 无返回结果的Promise对象。 |
示例:
var want = {
bundleName: 'com.example.myapp',
abilityName: 'MainAbility'
};
var options = {
windowMode: 102,
};
try {
this.context.startAbility(want, options)
.then((data) => {
// 执行正常业务
console.log('startAbility succeed');
})
.catch((error) => {
// 处理业务逻辑错误
console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}');
});
} catch (paramError) {
// 处理入参错误异常
console.error('error.code: ${paramError.code}, error.message: ${paramError.message}');
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22