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>
9> 本模块接口仅可在Stage模型下使用。
10>
11> 当前页面仅包含本模块的系统接口，其他公开接口参见[@ohos.app.ability.StartOptions (StartOptions)](js-apis-app-ability-startOptions.md)。
12
13## 导入模块
14
15```ts
16import { StartOptions } from '@kit.AbilityKit';
17```
18
19## 属性
20
21**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
22
23| 名称 | 类型 | 只读 | 可选 | 说明 |
24| -------- | -------- | -------- | -------- | -------- |
25| [windowMode](js-apis-app-ability-abilityConstant-sys.md#windowmode) | number | 否 | 是 | 窗口模式。<br>**系统API**：该接口为系统接口，三方应用不支持调用。 |
26| windowFocused<sup>12+</sup> | boolean | 否 | 是 | 窗口是否获焦。默认是true，表示窗口获焦。<br>**约束：**<br>1.仅在平板与2in1设备上生效。<br>2.仅在[UIAbilityContext.startAbility](js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability-1)中生效。 |
27
28**示例：**
29
30  ```ts
31  import { UIAbility, Want, StartOptions } from '@kit.AbilityKit';
32  import { BusinessError } from '@kit.BasicServicesKit';
33
34  export default class EntryAbility extends UIAbility {
35
36    onForeground() {
37      let want: Want = {
38        deviceId: '',
39        bundleName: 'com.example.myapplication',
40        abilityName: 'EntryAbility'
41      };
42      let options: StartOptions = {
43        displayId: 0
44      };
45
46      try {
47        this.context.startAbility(want, options, (err: BusinessError) => {
48          if (err.code) {
49            // 处理业务逻辑错误
50            console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
51            return;
52          }
53          // 执行正常业务
54          console.info('startAbility succeed');
55        });
56      } catch (err) {
57        // 处理入参错误异常
58        let code = (err as BusinessError).code;
59        let message = (err as BusinessError).message;
60        console.error(`startAbility failed, code is ${code}, message is ${message}`);
61      }
62    }
63  }
64  ```
65