• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.app.ability.AbilityConstant (Ability相关常量)(系统接口)
2
3<!--Kit: Ability Kit-->
4<!--Subsystem: Ability-->
5<!--Owner: @littlejerry1-->
6<!--Designer: @ccllee1-->
7<!--Tester: @lixueqing513-->
8<!--Adviser: @huipeizi-->
9
10AbilityConstant提供Ability相关的枚举,包括WindowMode等。
11
12> **说明:**
13>
14> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
15>
16> 本模块接口仅可在Stage模型下使用。
17>
18> 当前页面仅包含本模块的系统接口,其他公开接口参见[@ohos.app.ability.AbilityConstant (Ability相关常量)](js-apis-app-ability-abilityConstant.md)。
19
20## 导入模块
21
22```ts
23import { AbilityConstant } from '@kit.AbilityKit';
24```
25
26## WindowMode<sup>12+</sup>
27
28启动Ability时的窗口模式,该类型为枚举,可配合startAbility使用指定启动Ability的窗口模式。
29
30**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
31
32**系统接口**:此接口为系统接口。
33
34| 名称                        | 值 | 说明                 |
35| ---                         | --- | ---                  |
36| WINDOW_MODE_UNDEFINED       | 0   | 未定义窗口模式。       |
37| WINDOW_MODE_FLOATING        | 102 | 自由悬浮形式窗口模式。 |
38
39**示例:**
40
41```ts
42import { UIAbility, StartOptions, Want, AbilityConstant } from '@kit.AbilityKit';
43import { BusinessError } from '@kit.BasicServicesKit';
44
45let want: Want = {
46  bundleName: 'com.example.myapplication',
47  abilityName: 'EntryAbility'
48};
49let option: StartOptions = {
50  windowMode: AbilityConstant.WindowMode.WINDOW_MODE_FULLSCREEN
51};
52
53// 确保从上下文获取到context
54export default class MyAbility extends UIAbility {
55  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
56    this.context.startAbility(want, option).then(() => {
57      console.log('Succeed to start ability.');
58    }).catch((error: BusinessError) => {
59      console.error(`Failed to start ability with error: ${JSON.stringify(error)}`);
60    });
61  }
62}
63```
64