• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.app.ability.StartOptions (StartOptions)
2
3**StartOptions** is used as an input parameter of [startAbility](js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability-1) to specify the window mode of an ability.
4
5> **NOTE**
6>
7> 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.
8> The APIs of this module can be used only in the stage model.
9
10## Modules to Import
11
12```ts
13import StartOptions from '@ohos.app.ability.StartOptions';
14```
15
16## Attributes
17
18**System capability**: SystemCapability.Ability.AbilityRuntime.Core
19
20| Name| Type| Mandatory| Description|
21| -------- | -------- | -------- | -------- |
22| [windowMode](js-apis-app-ability-abilityConstant.md#abilityconstantwindowmode) | number | No| Window mode.|
23| displayId | number | No| Display ID. |
24
25**Example**
26
27  ```ts
28  import missionManager from '@ohos.app.ability.missionManager';
29
30  try {
31    missionManager.getMissionInfos('', 10, (error, missions) => {
32      if (error.code) {
33          console.log('getMissionInfos failed, error.code:' + JSON.stringify(error.code) +
34            'error.message:' + JSON.stringify(error.message));
35          return;
36      }
37      console.log('size = ' + missions.length);
38      console.log('missions = ' + JSON.stringify(missions));
39      let id = missions[0].missionId;
40
41      let startOptions = {
42          windowMode : 101,
43          displayId: 0
44      };
45      missionManager.moveMissionToFront(id, startOptions).then(() => {
46  	    console.log('moveMissionToFront is called ');
47      });
48    });
49  } catch (paramError) {
50    console.log('error: ' + paramError.code + ', ' + paramError.message);
51  }
52  ```
53