harmony 鸿蒙WindowExtensionContext

2023-06-24
浏览 (506)

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