@ohos.app.form.formHost (formHost)

The formHost module provides APIs related to the widget host, which is an application that displays the widget content and controls the position where the widget is displayed. You can use the APIs to delete, release, and update widgets installed by the same user, and obtain widget information and status.

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.

Modules to Import

import formHost from '@ohos.app.form.formHost';

deleteForm

deleteForm(formId: string, callback: AsyncCallback<void>): void

Deletes a widget. After this API is called, the application can no longer use the widget, and the Widget Manager will not retain the widget information. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  var formId = '12400633174999288';
  formHost.deleteForm(formId, (error, data) => {
  if (error) {
    console.log('formHost deleteForm, error:' + JSON.stringify(error));
  } else {
    console.log('formHost deleteForm success');
  }
  });
} catch (error) {
  console.log(`catch err->${JSON.stringify(error)}`);
}

deleteForm

deleteForm(formId: string): Promise<void>

Deletes a widget. After this API is called, the application can no longer use the widget, and the Widget Manager will not retain the widget information. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

try {
  var formId = '12400633174999288';
  formHost.deleteForm(formId).then(() => {
    console.log('formHost deleteForm success');
  }).catch((error) => {
    console.log('formHost deleteForm, error:' + JSON.stringify(error));
  });
} catch(error) {
  console.log(`catch err->${JSON.stringify(error)}`);
}

releaseForm

releaseForm(formId: string, callback: AsyncCallback<void>): void

Releases a widget. After this API is called, the application can no longer use the widget, but the Widget Manager still retains the widget cache and storage information. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  var formId = '12400633174999288';
  formHost.releaseForm(formId, (error, data) => {
    if (error) {
      console.log('formHost releaseForm, error:' + JSON.stringify(error));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

releaseForm

releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback<void>): void

Releases a widget. After this API is called, the application can no longer use the widget, but the Widget Manager retains the storage information about the widget and retains or releases the cache information based on the setting. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  var formId = '12400633174999288';
  formHost.releaseForm(formId, true, (error, data) => {
    if (error) {
      console.log('formHost releaseForm, error:' + JSON.stringify(error));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

releaseForm

releaseForm(formId: string, isReleaseCache?: boolean): Promise<void>

Releases a widget. After this API is called, the application can no longer use the widget, but the Widget Manager retains the storage information about the widget and retains or releases the cache information based on the setting. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

try {
  var formId = '12400633174999288';
  formHost.releaseForm(formId, true).then(() => {
    console.log('formHost releaseForm success');
  }).catch((error) => {
    console.log('formHost releaseForm, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

requestForm

requestForm(formId: string, callback: AsyncCallback<void>): void

Requests a widget update. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  var formId = '12400633174999288';
  formHost.requestForm(formId, (error, data) => {
    if (error) {
      console.log('formHost requestForm, error:' + JSON.stringify(error));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

requestForm

requestForm(formId: string): Promise<void>

Requests a widget update. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

try {
  var formId = '12400633174999288';
  formHost.requestForm(formId).then(() => {
    console.log('formHost requestForm success');
  }).catch((error) => {
    console.log('formHost requestForm, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

castToNormalForm

castToNormalForm(formId: string, callback: AsyncCallback<void>): void

Converts a temporary widget to a normal one. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  var formId = '12400633174999288';
  formHost.castToNormalForm(formId, (error, data) => {
    if (error) {
      console.log('formHost castTempForm, error:' + JSON.stringify(error));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

castToNormalForm

castToNormalForm(formId: string): Promise<void>

Converts a temporary widget to a normal one. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

try {
  var formId = '12400633174999288';
  formHost.castToNormalForm(formId).then(() => {
    console.log('formHost castTempForm success');
  }).catch((error) => {
    console.log('formHost castTempForm, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

notifyVisibleForms

notifyVisibleForms(formIds: Array<string>, callback: AsyncCallback<void>): void

Instructs the widget framework to make a widget visible. After this API is called, onVisibilityChange is invoked to notify the widget provider. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  var formId = ['12400633174999288'];
  formHost.notifyVisibleForms(formId, (error, data) => {
    if (error) {
      console.log('formHost notifyVisibleForms, error:' + JSON.stringify(error));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

notifyVisibleForms

notifyVisibleForms(formIds: Array<string>): Promise<void>

Instructs the widget framework to make a widget visible. After this API is called, onVisibilityChange is invoked to notify the widget provider. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

try {
  var formId = ['12400633174999288'];
  formHost.notifyVisibleForms(formId).then(() => {
    console.log('formHost notifyVisibleForms success');
  }).catch((error) => {
    console.log('formHost notifyVisibleForms, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

notifyInvisibleForms

notifyInvisibleForms(formIds: Array<string>, callback: AsyncCallback<void>): void

Instructs the widget framework to make a widget invisible. After this API is called, onVisibilityChange is invoked to notify the widget provider. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  var formId = ['12400633174999288'];
  formHost.notifyInvisibleForms(formId, (error, data) => {
    if (error) {
      console.log('formHost notifyInvisibleForms, error:' + JSON.stringify(error));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

notifyInvisibleForms

notifyInvisibleForms(formIds: Array<string>): Promise<void>

Instructs the widget framework to make a widget invisible. After this API is called, onVisibilityChange is invoked to notify the widget provider. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

try {
  var formId = ['12400633174999288'];
  formHost.notifyInvisibleForms(formId).then(() => {
    console.log('formHost notifyInvisibleForms success');
  }).catch((error) => {
    console.log('formHost notifyInvisibleForms, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

enableFormsUpdate

enableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void>): void

Instructs the widget framework to make a widget updatable. After this API is called, the widget is in the enabled state and can receive updates from the widget provider. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  var formId = ['12400633174999288'];
  formHost.enableFormsUpdate(formId, (error, data) => {
    if (error) {
      console.log('formHost enableFormsUpdate, error:' + JSON.stringify(error));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

enableFormsUpdate

enableFormsUpdate(formIds: Array<string>): Promise<void>

Instructs the widget framework to make a widget updatable. After this API is called, the widget is in the enabled state and can receive updates from the widget provider. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

try {
  var formId = ['12400633174999288'];
  formHost.enableFormsUpdate(formId).then(() => {
    console.log('formHost enableFormsUpdate success');
  }).catch((error) => {
    console.log('formHost enableFormsUpdate, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

disableFormsUpdate

disableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void>): void

Instructs the widget framework to make a widget not updatable. After this API is called, the widget cannot receive updates from the widget provider. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  var formId = ['12400633174999288'];
  formHost.disableFormsUpdate(formId, (error, data) => {
    if (error) {
      console.log('formHost disableFormsUpdate, error:' + JSON.stringify(error));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

disableFormsUpdate

disableFormsUpdate(formIds: Array<string>): Promise<void>

Instructs the widget framework to make a widget not updatable. After this API is called, the widget cannot receive updates from the widget provider. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

try {
  var formId = ['12400633174999288'];
  formHost.disableFormsUpdate(formId).then(() => {
    console.log('formHost disableFormsUpdate success');
  }).catch((error) => {
    console.log('formHost disableFormsUpdate, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

isSystemReady

isSystemReady(callback: AsyncCallback<void>): void

Checks whether the system is ready. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  var formId = '12400633174999288';
  formHost.isSystemReady((error, data) => {
    if (error) {
      console.log('formHost isSystemReady, error:' + JSON.stringify(error));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

isSystemReady

isSystemReady(): Promise<void>

Checks whether the system is ready. This API uses a promise to return the result.

System capability: SystemCapability.Ability.Form

Return value

Error codes

Example

try {
  var formId = '12400633174999288';
  formHost.isSystemReady().then(() => {
    console.log('formHost isSystemReady success');
  }).catch((error) => {
    console.log('formHost isSystemReady, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

getAllFormsInfo

getAllFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>): void

Obtains the widget information provided by all applications on the device. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability: SystemCapability.Ability.Form

Error codes

Parameters

Example

try {
  formHost.getAllFormsInfo((error, data) => {
    if (error) {
      console.log('formHost getAllFormsInfo, error:' + JSON.stringify(error));
    } else {
      console.log('formHost getAllFormsInfo, data:' + JSON.stringify(data));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

getAllFormsInfo

getAllFormsInfo(): Promise<Array<formInfo.FormInfo>>

Obtains the widget information provided by all applications on the device. This API uses a promise to return the result.

Required permissions: ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability: SystemCapability.Ability.Form

Error codes

Return value

Example

try {
  formHost.getAllFormsInfo().then((data) => {
      console.log('formHost getAllFormsInfo data:' + JSON.stringify(data));
  }).catch((error) => {
      console.log('formHost getAllFormsInfo, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

getFormsInfo

getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.FormInfo>>): void

Obtains the widget information provided by a given application on the device. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  formHost.getFormsInfo('com.example.ohos.formjsdemo', (error, data) => {
    if (error) {
      console.log('formHost getFormsInfo, error:' + JSON.stringify(error));
    } else {
      console.log('formHost getFormsInfo, data:' + JSON.stringify(data));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

getFormsInfo

getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback<Array<formInfo.FormInfo>>): void

Obtains the widget information provided by a given application on the device. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  formHost.getFormsInfo('com.example.ohos.formjsdemo', 'entry', (error, data) => {
    if (error) {
        console.log('formHost getFormsInfo, error:' + JSON.stringify(error));
    } else {
        console.log('formHost getFormsInfo, data:' + JSON.stringify(data));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

getFormsInfo

getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formInfo.FormInfo>>

Obtains the widget information provided by a given application on the device. This API uses a promise to return the result.

Required permissions: ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

try {
  formHost.getFormsInfo('com.example.ohos.formjsdemo', 'entry').then((data) => {
    console.log('formHost getFormsInfo, data:' + JSON.stringify(data));
  }).catch((error) => {
    console.log('formHost getFormsInfo, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

deleteInvalidForms

deleteInvalidForms(formIds: Array<string>, callback: AsyncCallback<number>): void

Deletes invalid widgets from the list. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

try {
  var formIds = new Array('12400633174999288', '12400633174999289');
  formHost.deleteInvalidForms(formIds, (error, data) => {
    if (error) {
      console.log('formHost deleteInvalidForms, error:' + JSON.stringify(error));
    } else {
      console.log('formHost deleteInvalidForms, data:' + JSON.stringify(data));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

deleteInvalidForms

deleteInvalidForms(formIds: Array<string>): Promise<number>

Deletes invalid widgets from the list. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

try {
  var formIds = new Array('12400633174999288', '12400633174999289');
  formHost.deleteInvalidForms(formIds).then((data) => {
    console.log('formHost deleteInvalidForms, data:' + JSON.stringify(data));
  }).catch((error) => {
    console.log('formHost deleteInvalidForms, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

acquireFormState

acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo>): void

Obtains the widget state. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM and ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

var want = {
  'deviceId': '',
  'bundleName': 'ohos.samples.FormApplication',
  'abilityName': 'FormAbility',
  'parameters': {
    'ohos.extra.param.key.module_name': 'entry',
    'ohos.extra.param.key.form_name': 'widget',
    'ohos.extra.param.key.form_dimension': 2
  }
};
try {
  formHost.acquireFormState(want, (error, data) => {
    if (error) {
      console.log('formHost acquireFormState, error:' + JSON.stringify(error));
    } else {
      console.log('formHost acquireFormState, data:' + JSON.stringify(data));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

acquireFormState

acquireFormState(want: Want): Promise<formInfo.FormStateInfo>

Obtains the widget state. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM and ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

var want = {
  'deviceId': '',
  'bundleName': 'ohos.samples.FormApplication',
  'abilityName': 'FormAbility',
  'parameters': {
    'ohos.extra.param.key.module_name': 'entry',
    'ohos.extra.param.key.form_name': 'widget',
    'ohos.extra.param.key.form_dimension': 2
  }
};
try {
  formHost.acquireFormState(want).then((data) => {
    console.log('formHost acquireFormState, data:' + JSON.stringify(data));
  }).catch((error) => {
    console.log('formHost acquireFormState, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

on('formUninstall')

on(type: 'formUninstall', callback: Callback<string>): void

Subscribes to widget uninstall events. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

let callback = function(formId) {
  console.log('formHost on formUninstall, formId:' + formId);
}
formHost.on('formUninstall', callback);

off('formUninstall')

off(type: 'formUninstall', callback?: Callback<string>): void

Unsubscribes from widget uninstall events. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

let callback = function(formId) {
  console.log('formHost on formUninstall, formId:' + formId);
}
formHost.off('formUninstall', callback);

notifyFormsVisible

notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: AsyncCallback<void>): void

Instructs the widgets to make themselves visible. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

var formIds = new Array('12400633174999288', '12400633174999289');
try {
  formHost.notifyFormsVisible(formIds, true, (error, data) => {
    if (error) {
      console.log('formHost notifyFormsVisible, error:' + JSON.stringify(error));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

notifyFormsVisible

notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise<void>

Instructs the widgets to make themselves visible. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

var formIds = new Array('12400633174999288', '12400633174999289');
try {
  formHost.notifyFormsVisible(formIds, true).then(() => {
    console.log('formHost notifyFormsVisible success');
  }).catch((error) => {
    console.log('formHost notifyFormsVisible, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

notifyFormsEnableUpdate

notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, callback: AsyncCallback<void>): void

Instructs the widgets to enable or disable updates. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

var formIds = new Array('12400633174999288', '12400633174999289');
try {
  formHost.notifyFormsEnableUpdate(formIds, true, (error, data) => {
    if (error) {
      console.log('formHost notifyFormsEnableUpdate, error:' + JSON.stringify(error));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

notifyFormsEnableUpdate

notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean): Promise<void>

Instructs the widgets to enable or disable updates. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

var formIds = new Array('12400633174999288', '12400633174999289');
try {
  formHost.notifyFormsEnableUpdate(formIds, true).then(() => {
    console.log('formHost notifyFormsEnableUpdate success');
  }).catch((error) => {
    console.log('formHost notifyFormsEnableUpdate, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

shareForm

shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>): void

Shares a specified widget with a remote device. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM and ohos.permission.DISTRIBUTED_DATASYNC

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

var formId = '12400633174999288';
var deviceId = 'EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2';
try {
  formHost.shareForm(formId, deviceId, (error, data) => {
    if (error) {
      console.log('formHost shareForm, error:' + JSON.stringify(error));
    }
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

shareForm

shareForm(formId: string, deviceId: string): Promise<void>

Shares a specified widget with a remote device. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM and ohos.permission.DISTRIBUTED_DATASYNC

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

Example

var formId = '12400633174999288';
var deviceId = 'EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2';
try {
  formHost.shareForm(formId, deviceId).then(() => {
    console.log('formHost shareForm success');
  }).catch((error) => {
    console.log('formHost shareForm, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}

notifyFormsPrivacyProtected

notifyFormsPrivacyProtected(formIds: Array<string>, isProtected: boolean, callback: AsyncCallback<void>): void

Notifies that the privacy protection status of the specified widgets changes. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Error codes

Example

import formHost from '@ohos.app.form.formHost';

let formIds = new Array('12400633174999288', '12400633174999289');
try {
  formHost.notifyFormsPrivacyProtected(formIds, true, (error) => {
    if (error) {
      console.error(`error, code: ${error.code}, message: ${error.message}`);
    }
  });
} catch(error) {
  console.error(`catch error, code: ${error.code}, message: ${error.message}`);
}

notifyFormsPrivacyProtected

function notifyFormsPrivacyProtected(formIds: Array<string>, isProtected: boolean): Promise<void>;

Notifies that the privacy protection status of the specified widgets changes. This API uses a promise to return the result.

Required permissions: ohos.permission.REQUIRE_FORM

System capability: SystemCapability.Ability.Form

Parameters

Return value

Error codes

import formHost from '@ohos.app.form.formHost';

let formIds = new Array('12400633174999288', '12400633174999289');
try {
  formHost.notifyFormsPrivacyProtected(formIds, true).then(() => {
    console.log('formHost shareForm success');
  }).catch((error) => {
    console.log('formHost shareForm, error:' + JSON.stringify(error));
  });
} catch(error) {
    console.log(`catch err->${JSON.stringify(error)}`);
}