harmony 鸿蒙WindowExtensionContext
WindowExtensionContext
The WindowExtensionContext module, inherited from ExtensionContext, is the context environment of the WindowExtensionAbility.
The WindowExtensionContext module provides the capabilities of the WindowExtensionAbility, including starting the ability.
NOTE
The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
The APIs provided by this module are system APIs.
The APIs of this module can be used only in the stage model.
Usage
Before using the WindowExtensionContext module, you must define a child class that inherits from WindowExtensionAbility.
import WindowExtensionAbility from '@ohos.application.WindowExtensionAbility';
import WindowExtensionContext from 'application/WindowExtensionContext';
let context: WindowExtensionContext|null = null;
class WindowExtAbility extends WindowExtensionAbility {
onConnect() {
context = this.context; // Obtain a WindowExtensionContext instance.
}
}
WindowExtensionContext.startAbility
startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void
Starts an ability. This API uses an asynchronous callback to return the result.
System capability: SystemCapability.WindowManager.WindowManager.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
want | Want | Yes | Want information about the target ability. |
options | StartOptions | Yes | Parameters used for starting the ability. |
callback | AsyncCallback<void> | Yes | Callback used to return the result. |
Example
import { BusinessError } from '@ohos.base';
import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'MainAbility'
};
let options: StartOptions = {
windowMode: 102
};
try {
this.context.startAbility(want, options, (error: BusinessError) => {
let message = (error as BusinessError).message;
let errCode = (error as BusinessError).code;
if (errCode) {
// Process service logic errors.
console.error('startAbility failed, error.code: ${errCode}, error.message: ${message}');
return;
}
// Carry out normal service processing.
console.log('startAbility succeed');
});
} catch (paramError) {
// Process input parameter errors.
let message = (paramError as BusinessError).message;
let errCode = (paramError as BusinessError).code;
console.error('error.code: ${errCode}, error.message: ${message}');
}
WindowExtensionContext.startAbility
startAbility(want: Want, options?: StartOptions): Promise<void>
Starts an ability. This API uses a promise to return the result.
System capability: SystemCapability.WindowManager.WindowManager.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
want | Want | Yes | Want information about the target ability, such as the ability name and bundle name. |
options | StartOptions | No | Parameters used for starting the ability. |
Return value
Type | Description |
---|---|
Promise<void> | Promise that returns no value. |
Example
import { BusinessError } from '@ohos.base';
import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
let want: Want = {
bundleName: 'com.example.myapp',
abilityName: 'MainAbility'
};
let options: StartOptions = {
windowMode: 102,
};
try {
this.context.startAbility(want, options)
.then(() => {
// Carry out normal service processing.
console.log('startAbility succeed');
})
.catch((error: BusinessError) => {
// Process service logic errors.
let message = (error as BusinessError).message;
let errCode = (error as BusinessError).code;
console.error('startAbility failed, error.code: ${errCode}, error.message: ${message}');
});
} catch (paramError) {
// Process input parameter errors.
let message = (paramError as BusinessError).message;
let errCode = (paramError as BusinessError).code;
console.error('error.code: ${errCode}, error.message: ${message}');
}
你可能感兴趣的鸿蒙文章
harmony 鸿蒙System Common Events (To Be Deprecated Soon)
harmony 鸿蒙System Common Events
harmony 鸿蒙API Reference Document Description
harmony 鸿蒙Enterprise Device Management Overview (for System Applications Only)
harmony 鸿蒙BundleStatusCallback
harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager)
harmony 鸿蒙@ohos.distributedBundle (Distributed Bundle Management)
harmony 鸿蒙@ohos.bundle (Bundle)
harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (EnterpriseAdminExtensionAbility)
- 所属分类: 后端技术
- 本文标签:
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦