1# @ohos.app.form.formInfo (formInfo)(系统接口)
2
3formInfo模块提供了卡片信息和状态等相关类型和枚举。
4
5> **说明：**
6>
7> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8> 当前页面仅包含本模块的系统接口，其他公共接口参见[@ohos.app.form.formInfo (formInfo)](./js-apis-app-form-formInfo.md)。
9
10## 导入模块
11
12```ts
13import { formInfo } from '@kit.FormKit';
14```
15
16
17##  FormParam
18
19卡片参数枚举。
20
21**系统能力：** SystemCapability.Ability.Form
22
23| 名称        | 值   | 说明         |
24| ----------- | ---- | ------------ |
25| DEVICE_ID_KEY    | 'ohos.extra.param.key.device_id'   | 设备标识。 <br>**系统接口：** 此接口为系统接口。  |
26
27## FormUsageState
28
29卡片当前使用状态枚举。
30
31**系统能力：** SystemCapability.Ability.Form
32
33**系统接口：** 此接口为系统接口。
34
35| 名称        |  值   | 说明         |
36| ----------- | ---- | ------------ |
37| USED<sup>11+</sup> | 0   | 表示卡片在使用中。 |
38| UNUSED<sup>11+</sup> | 1   | 表示卡片未被使用。 |
39
40## RunningFormInfo<sup>10+</sup>
41
42已添加的卡片信息，包括使用中的以及未使用的卡片。
43
44**系统能力：** SystemCapability.Ability.Form
45
46**系统接口：** 此接口为系统接口。
47
48| 名称        | 类型                 | 可读    | 可写    | 说明                                                         |
49| ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------ |
50| formId  | string               | 是    | 否     | 卡片标识。                   |
51| bundleName<sup>10+</sup>  | string               | 是    | 否     | 提供方卡片所属包的Bundle名称。                   |
52| hostBundleName  | string               | 是    | 否     | 使用方卡片所属包的Bundle名称。                   |
53| visibilityType  | [VisibilityType](js-apis-app-form-formInfo.md#visibilitytype)               | 是    | 否     | 卡片当前可见类型枚举。                   |
54| moduleName<sup>10+</sup>  | string               | 是    | 否     | 卡片所属模块的模块名称。                      |
55| abilityName<sup>10+</sup> | string               | 是    | 否     | 卡片所属的Ability名称。                       |
56| formName<sup>10+</sup>        | string               | 是    | 否     | 卡片名称。                                 |
57| dimension | number               | 是    | 否     | 卡片规格。   |
58| formUsageState<sup>11+</sup> | [FormUsageState](#formusagestate)         | 是    | 否     | 卡片当前使用状态枚举。   |
59| formDescription<sup>11+</sup> | string         | 是    | 否     | 提供方卡片配置文件中的描述信息。   |
60| formLocation<sup>12+</sup> | [FormLocation](#formlocation12)| 是    | 否     | 卡片位置信息。   |
61
62## formProviderFilter<sup>10+</sup>
63
64卡片提供方信息。
65
66**模型约束：** 此接口仅可在Stage模型下使用。
67
68**系统能力：** SystemCapability.Ability.Form
69
70**系统接口：** 此接口为系统接口。
71
72| 名称        | 类型                 | 可读    | 可写    | 说明                                                         |
73| ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------ |
74| bundleName  | string               | 是    | 否     | 提供方卡片所属包的Bundle名称。  |
75| formName    | string               | 是    | 否     | 卡片名称。                     |
76| moduleName  | string               | 是    | 否     | 卡片所属模块的模块名称。        |
77| abilityName | string               | 是    | 否     | 卡片所属的Ability名称。        |
78| isUnusedIncluded<sup>11+</sup> | boolean               | 是    | 否     | 是否包含未使用的卡片。        |
79
80
81## FormInfoFilter
82
83卡片信息过滤器，仅将符合过滤器内要求的卡片信息返回。
84
85**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。
86
87**系统能力：** SystemCapability.Ability.Form
88
89| 名称        | 类型   | 必填         |说明         |
90| ----------- | ---- | ------------ |------------ |
91| bundleName    | string    |否    | 选填，仅保留含bundleName与提供值相符的卡片信息，未填写时则不通过bundleName进行过滤。<br>**系统接口：** 此接口为系统接口。  |
92| supportedDimensions | Array<number> |否    | 选填，仅保留含supportedDimensions提供值相符的卡片信息，未填写时则不通过supportedDimensions进行过滤。<br>**系统接口：** 此接口为系统接口。  |
93| supportedShapes<sup>12+</sup>  | Array\<number> |否    | 选填，仅保留含supportedShapes提供值相符的卡片信息，未填写时则不通过supportedShapes进行过滤。<br>**系统接口：** 此接口为系统接口。   |
94
95## FormLocation<sup>12+</sup>
96
97卡片当前位置枚举。
98
99**系统能力**：SystemCapability.Ability.Form
100
101| 名称                         | 值   | 说明                             |
102| ---------------------------- | ---- | -------------------------------- |
103| OTHER                        | -1   | 表示卡片位于其他位置。           |
104| DESKTOP                      | 0    | 表示卡片位于桌面。               |
105| FORM_CENTER                  | 1    | 表示卡片位于桌面的卡片中心。     |
106| FORM_MANAGER                 | 2    | 表示卡片位于桌面的卡片管理器。   |
107| NEGATIVE_SCREEN              | 3    | 表示卡片位于负一屏。             |
108| FORM_CENTER_NEGATIVE_SCREEN  | 4    | 表示卡片位于负一屏的服务中心。   |
109| FORM_MANAGER_NEGATIVE_SCREEN | 5    | 表示卡片位于负一屏的卡片管理器。 |
110| SCREEN_LOCK                  | 6    | 表示卡片位于锁屏。               |
111| AI_SUGGESTION                | 7    | 表示卡片位于小艺建议推荐区。     |
112
113## PublishFormResult
114
115发布卡片加桌结果。
116
117**系统能力：** SystemCapability.Ability.Form
118
119| 名称    | 类型                                          | 可读 | 可写 | 说明                       |
120| ------- | --------------------------------------------- | ---- | ---- | -------------------------- |
121| code    | [PublishFormErrorCode](#publishformerrorcode) | 是   | 否   | 发布卡片加桌错误码。       |
122| message | string                                        | 是   | 否   | 设置卡片加桌结果返回信息。 |
123
124## PublishFormErrorCode
125
126发布卡片加桌错误码枚举。
127
128**系统能力**：SystemCapability.Ability.Form
129
130| 名称           | 值   | 说明                             |
131| -------------- | ---- | -------------------------------- |
132| SUCCESS        | 0    | 表示卡片加桌成功。               |
133| NO_SPACE       | 1    | 表示没有空间添加卡片。           |
134| PARAM_ERROR    | 2    | 表示参数检查失败。               |
135| INTERNAL_ERROR | 3    | 表示卡片处理过程中出现内部错误。 |
136