• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.app.ability.StartOptions (StartOptions)
2
3StartOptions可以作为[startAbility()](js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability-1)的入参,用于指定目标Ability的窗口模式。
4
5> **说明:**
6>
7> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8> 本模块接口仅可在Stage模型下使用。
9
10## 导入模块
11
12```ts
13import StartOptions from '@ohos.app.ability.StartOptions';
14```
15
16## 属性
17
18**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
19
20| 名称 | 类型 | 必填 | 说明 |
21| -------- | -------- | -------- | -------- |
22| [windowMode](js-apis-app-ability-abilityConstant.md#abilityconstantwindowmode) | number | 否 | 窗口模式。<br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
23| displayId | number | 否 | 屏幕ID。默认是0,表示当前屏幕。 |
24
25**示例:**
26
27  ```ts
28  import missionManager from '@ohos.app.ability.missionManager';
29  import StartOptions from '@ohos.app.ability.StartOptions';
30  import { BusinessError } from '@ohos.base';
31
32  try {
33    missionManager.getMissionInfos('', 10, (error, missions) => {
34      if (error) {
35          console.error(`getMissionInfos failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}`);
36          return;
37      }
38      console.log(`size = ${missions.length}`);
39      console.log(`missions = ${JSON.stringify(missions)}`);
40      let id = missions[0].missionId;
41
42      let startOptions: StartOptions = {
43          windowMode : 101,
44          displayId: 0
45      };
46      missionManager.moveMissionToFront(id, startOptions).then(() => {
47  	    console.log('moveMissionToFront is called');
48      });
49    });
50  } catch (paramError) {
51    let code = (paramError as BusinessError).code;
52    let message = (paramError as BusinessError).message;
53    console.error(`error: ${code}, ${message}`);
54  }
55  ```
56