@ohos.application.FormExtension (FormExtension)

The FormExtension module provides APIs related to Form Extension abilities.

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. This module is deprecated since API version 9. You are advised to use FormExtensionAbility instead. The APIs of this module can be used only in the stage model.

Modules to Import

import FormExtension from '@ohos.application.FormExtension';

Attributes

System capability: SystemCapability.Ability.Form

onCreate

onCreate(want: Want): formBindingData.FormBindingData

Called to notify the widget provider that a Form instance (widget) has been created.

System capability: SystemCapability.Ability.Form

Parameters

Return value

Example

import formBindingData from '@ohos.application.formBindingData'
export default class MyFormExtension extends FormExtension {
  onCreate(want) {
    console.log('FormExtension onCreate, want:' + want.abilityName);
    let dataObj1 = {
      temperature:"11c",
      "time":"11:00"
    };
    let obj1 = formBindingData.createFormBindingData(dataObj1);
    return obj1;
  }
}

FormExtension.onCastToNormal

onCastToNormal(formId: string): void

Called to notify the widget provider that a temporary widget has been converted to a normal one.

System capability: SystemCapability.Ability.Form

Parameters

Example

export default class MyFormExtension extends FormExtension {
  onCastToNormal(formId) {
    console.log('FormExtension onCastToNormal, formId:' + formId);
  }
}

FormExtension.onUpdate

onUpdate(formId: string): void

Called to notify the widget provider that a widget has been updated. After obtaining the latest data, the caller invokes updateForm of the FormExtensionContext class to update the widget data.

System capability: SystemCapability.Ability.Form

Parameters

Example

import formBindingData from '@ohos.application.formBindingData'
export default class MyFormExtension extends FormExtension {
  onUpdate(formId) {
    console.log('FormExtension onUpdate, formId:' + formId);
    let obj2 = formBindingData.createFormBindingData({temperature:"22c", time:"22:00"});
    this.context.updateForm(formId, obj2).then((data)=>{
      console.log('FormExtension context updateForm, data:' + data);
    }).catch((error) => {
      console.error('Operation updateForm failed. Cause: ' + error);});
    }
}

FormExtension.onVisibilityChange

onVisibilityChange(newStatus: { [key: string]: number }): void

Called to notify the widget provider of the change of visibility.

System capability: SystemCapability.Ability.Form

Parameters

Example

import formBindingData from '@ohos.application.formBindingData'
export default class MyFormExtension extends FormExtension {
  onVisibilityChange(newStatus) {
  console.log('FormExtension onVisibilityChange, newStatus:' + newStatus);
  let obj2 = formBindingData.createFormBindingData({temperature:"22c", time:"22:00"});

  for (let key in newStatus) {
    console.log('FormExtension onVisibilityChange, key:' + key + ", value=" + newStatus[key]);
    this.context.updateForm(key, obj2).then((data)=>{
        console.log('FormExtension context updateForm, data:' + data);
    }).catch((error) => {
        console.error('Operation updateForm failed. Cause: ' + error);});
    }
  }
}

FormExtension.onEvent

onEvent(formId: string, message: string): void

Called to instruct the widget provider to receive and process the widget event.

System capability: SystemCapability.Ability.Form

Parameters

Example

export default class MyFormExtension extends FormExtension {
  onEvent(formId, message) {
    console.log('FormExtension onEvent, formId:' + formId + ", message:" + message);
  }
}

FormExtension.onDestroy

onDestroy(formId: string): void

Called to notify the widget provider that a Form instance (widget) has been destroyed.

System capability: SystemCapability.Ability.Form

Parameters

Example

export default class MyFormExtension extends FormExtension {
  onDestroy(formId) {
    console.log('FormExtension onDestroy, formId:' + formId);
  }
}

FormExtension.onConfigurationUpdated

onConfigurationUpdated(config: Configuration): void;

Called when the configuration of the environment where the ability is running is updated.

System capability: SystemCapability.Ability.Form

Parameters

Example

class MyFormExtension extends FormExtension {
  onConfigurationUpdated(config) {
    console.log('onConfigurationUpdated, config:' + JSON.stringify(config));
  }
}

FormExtension.onAcquireFormState

onAcquireFormState?(want: Want): formInfo.FormState;

Called when the widget provider receives the status query result of a widget. By default, the initial state is returned.

System capability: SystemCapability.Ability.Form

Parameters

Example

import formInfo from '@ohos.application.formInfo'
class MyFormExtension extends FormExtension {
  onAcquireFormState(want) {
    console.log('FormExtension onAcquireFormState, want:' + want);
    return formInfo.FormState.UNKNOWN;
  }
}

FormExtension.onShare

onShare?(formId: string): {[key: string]: any};

Called by the widget provider to receive shared widget data.

System API: This is a system API.

System capability: SystemCapability.Ability.Form

Parameters

Return value

Example

class MyFormExtension extends FormExtension {
  onShare(formId) {
    console.log('FormExtension onShare, formId:' + formId);
    let wantParams = {
      "temperature":"20",
      "time":"2022-8-8 09:59",
    };
    return wantParams;
  }
}

你可能感兴趣的鸿蒙文章

harmony 鸿蒙APIs

harmony 鸿蒙System Common Events

harmony 鸿蒙System Common Events

harmony 鸿蒙API Reference Document Description

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager)

harmony 鸿蒙@ohos.distributedBundle (Distributed Bundle Management)

harmony 鸿蒙@ohos.bundle (Bundle)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (EnterpriseAdminExtensionAbility)

harmony 鸿蒙@ohos.WorkSchedulerExtensionAbility (Work Scheduler Callbacks)