往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


@ohos.app.ability.StartOptions (StartOptions)

StartOptions可以作为startAbility()的入参,用于指定目标Ability的窗口模式。

说明

  • 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

  • 本模块接口仅可在Stage模型下使用。

导入模块

import { StartOptions } from '@kit.AbilityKit';

属性

系统能力:SystemCapability.Ability.AbilityRuntime.Core

名称 类型 只读 可选 说明
windowMode12+ number 启动Ability时的窗口模式。
displayId number

屏幕ID模式。默认是0,表示当前屏幕。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

withAnimation11+ boolean Ability是否具有动画效果。
windowLeft11+ number 窗口左边的位置。
windowTop11+ number 窗口顶部的位置。
windowWidth11+ number 窗口的宽度。
windowHeight11+ number 窗口的高度。
processMode12+ contextConstant.ProcessMode

进程模式。

约束:

1.仅在平板类设备上生效。

2.仅在UIAbilityContext.startAbility中生效。

3.processMode和startupVisibility必须同时设置。

startupVisibility12+ contextConstant.StartupVisibility

Ability启动后的可见性。

约束:

1.仅在平板类设备上生效。

2.仅在UIAbilityContext.startAbility中生效。

3.processMode和startupVisibility必须同时设置。

示例:

import { UIAbility, Want, StartOptions } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {

  onForeground() {
    let want: Want = {
      deviceId: '',
      bundleName: 'com.example.myapplication',
      abilityName: 'EntryAbility'
    };
    let options: StartOptions = {
      displayId: 0
    };

    try {
      this.context.startAbility(want, options, (err: BusinessError) => {
        if (err.code) {
          // 处理业务逻辑错误
          console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
          return;
        }
        // 执行正常业务
        console.info('startAbility succeed');
      });
    } catch (err) {
      // 处理入参错误异常
      let code = (err as BusinessError).code;
      let message = (err as BusinessError).message;
      console.error(`startAbility failed, code is ${code}, message is ${message}`);
    }
  }
}

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐