harmony 鸿蒙FormEditExtensionContext

2025-06-12
浏览 (4)

FormEditExtensionContext

FormEditExtensionContext, inherited from UIExtensionContext, is the context of FormEditExtensionAbility.

You can use FormEditExtensionContext to access specific FormEditExtensionAbility resources.

NOTE

The initial APIs of this module are supported since API version 18. Newly added APIs will be marked with a superscript to indicate their earliest API version.

The APIs of this module can be used only in the stage model.

Modules to Import

import { FormEditExtensionAbility } from '@kit.FormKit';

FormEditExtensionAbility.startSecondPage

startSecondPage(want: Want): Promise<AbilityResult>

Starts the widget provider page to be edited.

Model restriction: This API can be used only in the stage model.

Atomic service API: This API can be used in atomic services since API version 18.

System capability: SystemCapability.Ability.Form

Parameters

Name	Type	Mandatory	Description
want	Want	Yes	Information about the editing page that needs to be started by the home screen of a third-party application.

Error codes

For details about the error codes, see Form Error Codes and Universal Error Codes.

ID	Error Message
202	The application is not a system application.
401	Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
16500050	An IPC connection error happened.
16501000	An internal functional error occurred.
16500100	Failed to obtain the configuration information.

Example

import { FormEditExtensionAbility } from '@kit.FormKit'
import { Want,UIExtensionContentSession } from '@kit.AbilityKit';

const TAG: string = '[testTag] ExampleFormEditExtensionAbility'
export default class ExampleFormEditAbility extends FormEditExtensionAbility {
  abilityName: string = 'FormEditSecPageAbility'
  onSessionCreate(want: Want, session: UIExtensionContentSession) {
    try {
      this.context.startSecondPage({
        bundleName: 'com.example.formEditDemo',
        parameters: {
          "secPageAbilityName": this.abilityName
        }

      }).then(data => {
        console.log(TAG, `startSecondPage result want: ${JSON.stringify(data)}`)
      });
    } catch (e) {
      console.error(TAG, `startSecondPage failed:${e}`)
      return
    }
  }
}