• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 枚举说明
2
3>**说明:**
4>
5>本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
6
7## Color
8
9**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
10
11**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
12
13**系统能力:** SystemCapability.ArkUI.ArkUI.Full
14
15| 名称                     | 值            | 说明                                                         |
16| ------------------------ | ------------- | ------------------------------------------------------------ |
17| Black                    | 0x000000      | ![zh-cn_image_0000001219864153](figures/zh-cn_image_0000001219864153.png) |
18| Blue                     | 0x0000ff      | ![zh-cn_image_0000001174104404](figures/zh-cn_image_0000001174104404.png) |
19| Brown                    | 0xa52a2a      | ![zh-cn_image_0000001219744201](figures/zh-cn_image_0000001219744201.png) |
20| Gray                     | 0x808080      | ![zh-cn_image_0000001174264376](figures/zh-cn_image_0000001174264376.png) |
21| Grey                     | 0x808080      | ![zh-cn_image_0000001174264376](figures/zh-cn_image_0000001174264376.png) |
22| Green                    | 0x008000      | ![zh-cn_image_0000001174422914](figures/zh-cn_image_0000001174422914.png) |
23| Orange                   | 0xffa500      | ![zh-cn_image_0000001219662661](figures/zh-cn_image_0000001219662661.png) |
24| Pink                     | 0xffc0cb      | ![zh-cn_image_0000001219662663](figures/zh-cn_image_0000001219662663.png) |
25| Red                      | 0xff0000      | ![zh-cn_image_0000001219662665](figures/zh-cn_image_0000001219662665.png) |
26| White                    | 0xffffff      | ![zh-cn_image_0000001174582866](figures/zh-cn_image_0000001174582866.png) |
27| Yellow                   | 0xffff00      | ![zh-cn_image_0000001174582864](figures/zh-cn_image_0000001174582864.png) |
28| Transparent<sup>9+</sup> | rgba(0,0,0,0) | 透明色                                                       |
29
30## ImageFit
31
32**系统能力:** SystemCapability.ArkUI.ArkUI.Full
33
34| 名称        | 值    | 说明                              |
35| --------- | ----- | ------------------------------- |
36| Contain   | 0  | 保持宽高比进行缩小或者放大,使得图片完全显示在显示边界内,对齐方式为水平居中。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples01](figures/image_fit_contain.png) |
37| Cover     | 1  | 保持宽高比进行缩小或者放大,使得图片两边都大于或等于显示边界,对齐方式为水平居中。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples02](figures/image_fit_cover.png) |
38| Auto      | 2  | 图像会根据其自身尺寸和组件的尺寸进行适当缩放,以在保持比例的同时填充视图,对齐方式为水平居中。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples03](figures/image_fit_auto.png) |
39| Fill      | 3  | 不保持宽高比进行放大缩小,使得图片充满显示边界,对齐方式为水平居中。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples04](figures/image_fit_fill.png) |
40| ScaleDown | 4  | 保持宽高比显示,图片缩小或者保持不变,对齐方式为水平居中。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples05](figures/image_fit_scaleDown.png) |
41| None      | 5  | 保持原有尺寸显示,对齐方式为水平居中。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples06](figures/image_fit_none.png) |
42| TOP_START<sup>12+</sup> | 7  | 图像显示在Image组件的顶部起始端,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples07](figures/image_fit_top_start.png) |
43| TOP<sup>12+</sup>       | 8  | 图像显示在Image组件的顶部横向居中,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples08](figures/image_fit_top.png)  |
44| TOP_END<sup>12+</sup>   | 9  | 图像显示在Image组件的顶部尾端,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples09](figures/image_fit_top_end.png) |
45| START<sup>12+</sup>     | 10  | 图像显示在Image组件的起始端纵向居中,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples10](figures/image_fit_start.png) |
46| CENTER<sup>12+</sup>    | 11  | 图像显示在Image组件的横向和纵向居中,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples11](figures/image_fit_center.png) |
47| END<sup>12+</sup>       | 12  | 图像显示在Image组件的尾端纵向居中,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples12](figures/image_fit_end.png) |
48| BOTTOM_START<sup>12+</sup> | 13  | 图像显示在Image组件的底部起始端,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples13](figures/image_fit_bottom_start.png) |
49| BOTTOM<sup>12+</sup>    | 14  | 图像显示在Image组件的底部横向居中,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples14](figures/image_fit_bottom.png) |
50| BOTTOM_END<sup>12+</sup>| 15  | 图像显示在Image组件的底部尾端,保持原有尺寸显示。<br/>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。<br/>![ImageFit-Examples15](figures/image_fit_bottom_end.png) |
51| MATRIX<sup>15+</sup>| 16  | 配合[imageMatrix](ts-basic-components-image.md#imagematrix15)使用,使图像在Image组件自定义位置显示,保持原有尺寸显示。不支持svg图源。<br/>**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。 |
52
53## BorderStyle
54
55**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
56
57**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
58
59**系统能力:** SystemCapability.ArkUI.ArkUI.Full
60
61| 名称     | 说明                            |
62| ------ | ----------------------------- |
63| Dotted | 显示为一系列圆点,圆点半径为borderWidth的一半。 |
64| Dashed | 显示为一系列短的方形虚线。                 |
65| Solid  | 显示为一条实线。                      |
66
67## LineJoinStyle
68
69**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
70
71**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
72
73**系统能力:** SystemCapability.ArkUI.ArkUI.Full
74
75| 名称    | 说明         |
76| ----- | ---------- |
77| Bevel | 使用斜角连接路径段。 |
78| Miter | 使用尖角连接路径段。 |
79| Round | 使用圆角连接路径段。 |
80
81## TouchType
82
83**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
84
85**系统能力:** SystemCapability.ArkUI.ArkUI.Full
86
87| 名称     | 说明              |
88| ------ | --------------- |
89| Down   | 手指按下时触发。        |
90| Up     | 手指抬起时触发。        |
91| Move   | 手指按压态在屏幕上移动时触发。 |
92| Cancel | 触摸事件取消时触发。      |
93
94## MouseButton<sup>8+</sup>
95
96**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
97
98**系统能力:** SystemCapability.ArkUI.ArkUI.Full
99
100| 名称      | 说明       |
101| ------- | -------- |
102| Left    | 鼠标左键。    |
103| Right   | 鼠标右键。    |
104| Middle  | 鼠标中键。    |
105| Back    | 鼠标左侧后退键。 |
106| Forward | 鼠标左侧前进键。 |
107| None    | 无按键。     |
108
109## MouseAction<sup>8+</sup>
110
111**系统能力:** SystemCapability.ArkUI.ArkUI.Full
112
113| 名称      | 说明      |
114| ------- | ------- |
115| Press   | 鼠标按键按下。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
116| Release | 鼠标按键松开。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
117| Move    | 鼠标移动。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。   |
118| Hover   | 鼠标悬浮。<br/>**说明:** 该枚举值无效。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。   |
119| CANCEL<sup>18+</sup>  | 鼠标按键被取消。<br/>**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 |
120
121## ModifierKey<sup>10+</sup>
122
123输入法修饰键类型。
124
125**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
126
127**系统能力:** SystemCapability.ArkUI.ArkUI.Full
128
129| 名称    | 说明           |
130| ----- | ------------ |
131| CTRL  | 表示键盘上Ctrl键。  |
132| SHIFT | 表示键盘上Shift键。 |
133| ALT   | 表示键盘上Alt键。   |
134
135## FunctionKey<sup>10+</sup>
136
137输入法功能键类型。
138
139**系统能力:** SystemCapability.ArkUI.ArkUI.Full
140
141| 名称   | 说明           |
142| ---- | ------------ |
143| ESC  | 表示键盘上ESC功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
144| F1   | 表示键盘上F1功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。  |
145| F2   | 表示键盘上F2功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。  |
146| F3   | 表示键盘上F3功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。  |
147| F4   | 表示键盘上F4功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。  |
148| F5   | 表示键盘上F5功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。  |
149| F6   | 表示键盘上F6功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。  |
150| F7   | 表示键盘上F7功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。  |
151| F8   | 表示键盘上F8功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。  |
152| F9   | 表示键盘上F9功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。  |
153| F10  | 表示键盘上F10功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
154| F11  | 表示键盘上F11功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
155| F12  | 表示键盘上F12功能键。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
156| TAB<sup>12+</sup>  | 表示键盘上TAB功能键。 <br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。|
157| DPAD_UP<sup>12+</sup>   | 表示键盘上UP方向键。  <br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。|
158| DPAD_DOWN<sup>12+</sup> | 表示键盘上DOWN方向键。 <br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。|
159| DPAD_LEFT<sup>12+</sup> | 表示键盘上LEFT方向键。 <br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。|
160| DPAD_RIGHT<sup>12+</sup> | 表示键盘上RIGHT方向键。 <br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。|
161
162## Curve
163
164插值曲线,动效请参考<!--RP1-->[贝塞尔曲线](../../../../design/ux-design/animation-attributes.md)<!--RP1End-->。
165
166**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
167
168**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
169
170**系统能力:** SystemCapability.ArkUI.ArkUI.Full
171
172| 名称                  | 说明                                       |
173| ------------------- | ---------------------------------------- |
174| Linear              | 表示动画从头到尾的速度都是相同的。                        |
175| Ease                | 表示动画以低速开始,然后加快,在结束前变慢,CubicBezier(0.25, 0.1, 0.25, 1.0)。 |
176| EaseIn              | 表示动画以低速开始,CubicBezier(0.42, 0.0, 1.0, 1.0)。 |
177| EaseOut             | 表示动画以低速结束,CubicBezier(0.0, 0.0, 0.58, 1.0)。 |
178| EaseInOut           | 表示动画以低速开始和结束,CubicBezier(0.42, 0.0, 0.58, 1.0)。 |
179| FastOutSlowIn       | 标准曲线,CubicBezier(0.4, 0.0, 0.2, 1.0)。   |
180| LinearOutSlowIn     | 减速曲线,CubicBezier(0.0, 0.0, 0.2, 1.0)。   |
181| FastOutLinearIn     | 加速曲线,CubicBezier(0.4, 0.0, 1.0, 1.0)。   |
182| ExtremeDeceleration | 急缓曲线,CubicBezier(0.0, 0.0, 0.0, 1.0)。   |
183| Sharp               | 锐利曲线,CubicBezier(0.33, 0.0, 0.67, 1.0)。 |
184| Rhythm              | 节奏曲线,CubicBezier(0.7, 0.0, 0.2, 1.0)。   |
185| Smooth              | 平滑曲线,CubicBezier(0.4, 0.0, 0.4, 1.0)。   |
186| Friction            | 阻尼曲线,CubicBezier(0.2, 0.0, 0.2, 1.0)。    |
187
188## AnimationStatus
189
190**卡片能力:** 从API version 10开始,该接口支持在ArkTS卡片中使用。
191
192**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
193
194**系统能力:** SystemCapability.ArkUI.ArkUI.Full
195
196| 名称      | 说明        |
197| ------- | --------- |
198| Initial | 动画初始状态。   |
199| Running | 动画处于播放状态。 |
200| Paused  | 动画处于暂停状态。 |
201| Stopped | 动画处于停止状态。 |
202
203## FillMode
204
205**卡片能力:** 从API version 10开始,该接口支持在ArkTS卡片中使用。
206
207**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
208
209**系统能力:** SystemCapability.ArkUI.ArkUI.Full
210
211| 名称        | 说明                                       |
212| --------- | ---------------------------------------- |
213| None      | 动画未执行时不会将任何样式应用于目标,动画播放完成之后恢复初始默认状态。     |
214| Forwards  | 目标将保留动画执行期间最后一个关键帧的状态。                   |
215| Backwards | 动画将在应用于目标时立即应用第一个关键帧中定义的值,并在delay期间保留此值。第一个关键帧取决于playMode,playMode为Normal或Alternate时为from的状态,playMode为Reverse或AlternateReverse时为to的状态。 |
216| Both      | 动画将遵循Forwards和Backwards的规则,从而在两个方向上扩展动画属性。 |
217
218## PlayMode
219
220**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
221
222**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
223
224**系统能力:** SystemCapability.ArkUI.ArkUI.Full
225
226| 名称               | 说明                                       |
227| ---------------- | ---------------------------------------- |
228| Normal           | 动画正向播放。                                 |
229| Reverse          | 动画反向播放。                                  |
230| Alternate        | 动画在奇数次(1、3、5...)正向播放,在偶数次(2、4、6...)反向播放。 |
231| AlternateReverse | 动画在奇数次(1、3、5...)反向播放,在偶数次(2、4、6...)正向播放。 |
232
233## KeyType
234
235**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
236
237**系统能力:** SystemCapability.ArkUI.ArkUI.Full
238
239| 名称   | 说明    |
240| ---- | ----- |
241| Down | 按键按下。 |
242| Up   | 按键松开。 |
243
244## KeySource
245
246**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
247
248**系统能力:** SystemCapability.ArkUI.ArkUI.Full
249
250| 名称       | 说明         |
251| -------- | ---------- |
252| Unknown  | 输入设备类型未知。  |
253| Keyboard | 输入设备类型为键盘。 |
254| JOYSTICK<sup>15+</sup> | 输入设备类型为游戏手柄。<br/>**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。|
255
256## Edge
257
258**系统能力:** SystemCapability.ArkUI.ArkUI.Full
259
260| 名称                             | 说明                                                         |
261| -------------------------------- | ------------------------------------------------------------ |
262| Top                              | 竖直方向上边缘。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
263| Center<sup>(deprecated) </sup>   | 竖直方向居中位置。<br/> 从API version 9开始废弃。            |
264| Bottom                           | 竖直方向下边缘。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
265| Baseline<sup>(deprecated) </sup> | 交叉轴方向文本基线位置。<br/> 从API version 9开始废弃。      |
266| Start                            | 水平方向起始位置。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
267| Middle<sup>(deprecated) </sup>   | 水平方向居中位置。<br/> 从API version 9开始废弃。            |
268| End                              | 水平方向末尾位置。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
269
270## Week
271
272**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
273
274**系统能力:** SystemCapability.ArkUI.ArkUI.Full
275
276| 名称   | 说明   |
277| ---- | ---- |
278| Mon  | 星期一。  |
279| Tue  | 星期二。  |
280| Wed  | 星期三。  |
281| Thur | 星期四。  |
282| Fri  | 星期五。  |
283| Sat  | 星期六。  |
284| Sun  | 星期日。  |
285
286## Direction
287
288**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
289
290**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
291
292**系统能力:** SystemCapability.ArkUI.ArkUI.Full
293
294| 名称   | 说明          |
295| ---- | ----------- |
296| Ltr  | 元素从左到右布局。   |
297| Rtl  | 元素从右到左布局。   |
298| Auto | 使用系统默认布局方向。 |
299
300## BarState
301
302**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
303
304**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
305
306**系统能力:** SystemCapability.ArkUI.ArkUI.Full
307
308| 名称   | 说明                 |
309| ---- | ------------------ |
310| Off  | 不显示。               |
311| On   | 常驻显示。              |
312| Auto | 按需显示(触摸时显示,2s后消失)。 |
313
314## TitleHeight<sup>9+</sup>
315
316**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
317
318**系统能力:** SystemCapability.ArkUI.ArkUI.Full
319
320| 名称          | 说明                         |
321| ----------- | -------------------------- |
322| MainOnly    | 只有主标题时标题栏的推荐高度(56vp)。      |
323| MainWithSub | 同时有主标题和副标题时标题栏的推荐高度(82vp)。 |
324
325## EdgeEffect
326
327**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
328
329**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
330
331**系统能力:** SystemCapability.ArkUI.ArkUI.Full
332
333| 名称     | 说明                                       |
334| ------ | ---------------------------------------- |
335| Spring | 弹性物理动效,滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离,松手后回弹。 |
336| Fade   | 阴影效果,滑动到边缘后会有圆弧状的阴影。                     |
337| None   | 滑动到边缘后无效果。                               |
338
339## Alignment
340
341**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
342
343**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
344
345**系统能力:** SystemCapability.ArkUI.ArkUI.Full
346
347| 名称          | 说明       |
348| ----------- | -------- |
349| TopStart    | 顶部起始端。   |
350| Top         | 顶部横向居中。  |
351| TopEnd      | 顶部尾端。    |
352| Start       | 起始端纵向居中。 |
353| Center      | 横向和纵向居中。 |
354| End         | 尾端纵向居中。  |
355| BottomStart | 底部起始端。   |
356| Bottom      | 底部横向居中。  |
357| BottomEnd   | 底部尾端。    |
358
359## TransitionType
360
361**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
362
363**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
364
365**系统能力:** SystemCapability.ArkUI.ArkUI.Full
366
367| 名称     | 说明                             |
368| ------ | ------------------------------ |
369| All    | 指定当前的Transition动效生效在组件的所有变化场景。 |
370| Insert | 指定当前的Transition动效生效在组件的插入显示场景。 |
371| Delete | 指定当前的Transition动效生效在组件的删除隐藏场景。 |
372
373## RelateType
374
375**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
376
377**系统能力:** SystemCapability.ArkUI.ArkUI.Full
378
379| 名称   | 说明             |
380| ---- | -------------- |
381| FILL | 缩放当前子组件以填充满父组件。 |
382| FIT  | 缩放当前子组件以自适应父组件。 |
383
384## Visibility
385
386**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
387
388**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
389
390**系统能力:** SystemCapability.ArkUI.ArkUI.Full
391
392| 名称      | 说明               |
393| ------- | ---------------- |
394| Hidden  | 隐藏,但参与布局进行占位。    |
395| Visible | 显示。              |
396| None    | 隐藏,但不参与布局,不进行占位。 |
397
398## LineCapStyle
399
400**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
401
402**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
403
404**系统能力:** SystemCapability.ArkUI.ArkUI.Full
405
406| 名称     | 说明                            |
407| ------ | ----------------------------- |
408| Butt   | 线条两端为平行线,不额外扩展。               |
409| Round  | 在线条两端延伸半个圆,直径等于线宽。            |
410| Square | 在线条两端延伸一个矩形,宽度等于线宽的一半,高度等于线宽。 |
411
412## Axis
413
414**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
415
416**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
417
418**系统能力:** SystemCapability.ArkUI.ArkUI.Full
419
420| 名称         | 说明     |
421| ---------- | ------ |
422| Vertical   | 方向为纵向。 |
423| Horizontal | 方向为横向。 |
424
425## HorizontalAlign
426
427**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
428
429**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
430
431**系统能力:** SystemCapability.ArkUI.ArkUI.Full
432
433| 名称     | 说明           |
434| ------ | ------------ |
435| Start  | 按照语言方向起始端对齐。 |
436| Center | 居中对齐,默认对齐方式。 |
437| End    | 按照语言方向末端对齐。  |
438
439## FlexAlign
440
441**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
442
443**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
444
445**系统能力:** SystemCapability.ArkUI.ArkUI.Full
446
447| 名称           | 说明                                       |
448| ------------ | ---------------------------------------- |
449| Start        | 元素在主轴方向首端对齐,第一个元素与行首对齐,同时后续的元素与前一个对齐。    |
450| Center       | 元素在主轴方向中心对齐,第一个元素与行首的距离与最后一个元素与行尾距离相同。   |
451| End          | 元素在主轴方向尾部对齐,最后一个元素与行尾对齐,其他元素与后一个对齐。      |
452| SpaceBetween | Flex主轴方向均匀分配弹性元素,相邻元素之间距离相同。第一个元素与行首对齐,最后一个元素与行尾对齐。 |
453| SpaceAround  | Flex主轴方向均匀分配弹性元素,相邻元素之间距离相同。第一个元素到行首的距离和最后一个元素到行尾的距离是相邻元素之间距离的一半。 |
454| SpaceEvenly  | Flex主轴方向均匀分配弹性元素,相邻元素之间的距离、第一个元素与行首的间距、最后一个元素到行尾的间距都完全一样。 |
455
456## ItemAlign
457
458**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
459
460**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
461
462**系统能力:** SystemCapability.ArkUI.ArkUI.Full
463
464| 名称       | 说明                                       |
465| -------- | ---------------------------------------- |
466| Auto     | 使用Flex容器中默认配置。                           |
467| Start    | 元素在Flex容器中,交叉轴方向首部对齐。                    |
468| Center   | 元素在Flex容器中,交叉轴方向居中对齐。                    |
469| End      | 元素在Flex容器中,交叉轴方向底部对齐。                    |
470| Stretch  | 元素在Flex容器中,交叉轴方向拉伸填充。容器为Flex且设置Wrap为FlexWrap.WrapFlexWrap.WrapReverse时,元素拉伸到与当前行/列交叉轴长度最长的元素尺寸。其余情况下,无论元素尺寸是否设置,均拉伸到容器尺寸。 |
471| Baseline | 元素在Flex容器中,交叉轴方向文本基线对齐。                  |
472
473## FlexDirection
474
475**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
476
477**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
478
479**系统能力:** SystemCapability.ArkUI.ArkUI.Full
480
481| 名称            | 说明               |
482| ------------- | ---------------- |
483| Row           | 主轴与行方向一致作为布局模式。  |
484| RowReverse    | 与Row方向相反方向进行布局。  |
485| Column        | 主轴与列方向一致作为布局模式。  |
486| ColumnReverse | 与Column相反方向进行布局。 |
487
488## FlexWrap
489
490**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
491
492**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
493
494**系统能力:** SystemCapability.ArkUI.ArkUI.Full
495
496| 名称          | 说明                          |
497| ----------- | --------------------------- |
498| NoWrap      | Flex容器的元素单行/列布局,子元素尽可能约束在容器内。当子元素有最小尺寸约束等设置时,Flex容器不会对其强制弹性压缩。  |
499| Wrap        | Flex容器的元素多行/列排布,子项允许超出容器。   |
500| WrapReverse | Flex容器的元素反向多行/列排布,子项允许超出容器。 |
501
502## VerticalAlign
503
504**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
505
506**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
507
508**系统能力:** SystemCapability.ArkUI.ArkUI.Full
509
510| 名称     | 说明           |
511| ------ | ------------ |
512| Top    | 顶部对齐。        |
513| Center | 居中对齐,默认对齐方式。 |
514| Bottom | 底部对齐。        |
515
516## ImageRepeat
517
518**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
519
520**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
521
522**系统能力:** SystemCapability.ArkUI.ArkUI.Full
523
524| 名称       | 说明            |
525| -------- | ------------- |
526| X        | 只在水平轴上重复绘制图片。 |
527| Y        | 只在竖直轴上重复绘制图片。 |
528| XY       | 在两个轴上重复绘制图片。  |
529| NoRepeat | 不重复绘制图片。      |
530
531## ImageSize
532
533**系统能力:** SystemCapability.ArkUI.ArkUI.Full
534
535| 名称    | 值    | 说明                                  |
536| ------- | -------------------------- | ----------------------------------- |
537| Cover   | 1  | 保持宽高比进行缩小或者放大,使得图片两边都大于或等于显示边界。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br />**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
538| Contain | 2  | 保持宽高比进行缩小或者放大,使得图片完全显示在显示边界内。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br /> **原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。      |
539| Auto    | 0  | 默认值,保持原图的比例不变。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br /> **原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。                         |
540| FILL<sup>12+</sup> | 3  | 不保持宽高比进行放大缩小,使得图片充满显示边界。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。|
541
542## GradientDirection
543
544**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
545
546**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
547
548**系统能力:** SystemCapability.ArkUI.ArkUI.Full
549
550| 名称          | 说明    |
551| ----------- | ----- |
552| Left        | 从右向左。 |
553| Top         | 从下向上。 |
554| Right       | 从左向右。 |
555| Bottom      | 从上向下。 |
556| LeftTop     | 左上。   |
557| LeftBottom  | 左下。   |
558| RightTop    | 右上。   |
559| RightBottom | 右下。   |
560| None        | 无。    |
561
562## SharedTransitionEffectType
563
564**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
565
566**系统能力:** SystemCapability.ArkUI.ArkUI.Full
567
568| 名称       | 说明                                       |
569| -------- | ---------------------------------------- |
570| Static   | 目标页面元素的位置保持不变,可以配置透明度动画。目前,只有为重定向到目标页面而配置的静态效果才会生效。 |
571| Exchange | 将源页面元素移动到目标页面元素位置并适当缩放。                  |
572
573## FontStyle
574
575**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
576
577**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
578
579**系统能力:** SystemCapability.ArkUI.ArkUI.Full
580
581| 名称     | 说明       |
582| ------ | -------- |
583| Normal | 标准的字体样式。 |
584| Italic | 斜体的字体样式。 |
585
586## FontWeight
587
588**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
589
590**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
591
592**系统能力:** SystemCapability.ArkUI.ArkUI.Full
593
594| 名称    |  值   |    说明   |
595| ------- | ----- | ----------- |
596| Lighter |  100  |   字体较细。 |
597| Normal  |  400  |   字体粗细正常。 |
598| Regular |  400  |   字体粗细正常。 |
599| Medium  |  500  |   字体粗细适中。 |
600| Bold    |  700  |   字体较粗。   |
601| Bolder  |  900  |   字体非常粗。 |
602
603## TextAlign
604
605**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
606
607**系统能力:** SystemCapability.ArkUI.ArkUI.Full
608
609| 名称                  | 说明                                                         |
610| --------------------- | ------------------------------------------------------------ |
611| Start                 | 水平对齐首部。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
612| Center                | 水平居中对齐。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
613| End                   | 水平对齐尾部。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
614| JUSTIFY<sup>10+</sup> | 双端对齐。<br/>**卡片能力:** 从API version 10开始,该接口支持在ArkTS卡片中使用。 |
615
616## TextOverflow
617
618**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
619
620**系统能力:** SystemCapability.ArkUI.ArkUI.Full
621
622| 名称                    | 说明                  |
623| --------------------- | ------------------- |
624| None                  | 文本超长时按最大行截断显示。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
625| Clip                  | 文本超长时按最大行截断显示。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
626| Ellipsis              | 文本超长时显示不下的文本用省略号代替。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
627| MARQUEE<sup>10+</sup> | 文本超长时以跑马灯的方式展示。 |
628
629## TextDecorationType
630
631**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
632
633**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
634
635**系统能力:** SystemCapability.ArkUI.ArkUI.Full
636
637| 名称          | 说明        |
638| ----------- | --------- |
639| Underline   | 文字下划线修饰。  |
640| LineThrough | 穿过文本的修饰线。 |
641| Overline    | 文字上划线修饰。  |
642| None        | 不使用文本装饰线。 |
643
644## TextCase
645
646**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。
647
648**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
649
650**系统能力:** SystemCapability.ArkUI.ArkUI.Full
651
652| 名称        | 说明         |
653| --------- | ---------- |
654| Normal    | 保持文本原有大小写。 |
655| LowerCase | 文本采用全小写。   |
656| UpperCase | 文本采用全大写。   |
657
658## ResponseType<sup>8+</sup>
659
660**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
661
662**系统能力:** SystemCapability.ArkUI.ArkUI.Full
663
664| 名称         | 说明            |
665| ---------- | ------------- |
666| LongPress  | 通过长按触发菜单弹出。   |
667| RightClick | 通过鼠标右键触发菜单弹出。 |
668
669## HoverEffect<sup>8+</sup>
670
671**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
672
673**系统能力:** SystemCapability.ArkUI.ArkUI.Full
674
675| 名称        | 说明             |
676| --------- | -------------- |
677| Auto      | 使用组件的系统默认悬浮效果。 |
678| Scale     | 放大缩小效果。        |
679| Highlight | 背景淡入淡出的强调效果。   |
680| None      | 不设置效果。         |
681
682## Placement<sup>8+</sup>
683
684**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
685
686**系统能力:** SystemCapability.ArkUI.ArkUI.Full
687
688| 名称                     | 说明                                                         |
689| ------------------------ | ------------------------------------------------------------ |
690| Left                     | 气泡提示位于组件左侧,与组件左侧中心对齐。                   |
691| Right                    | 气泡提示位于组件右侧,与组件右侧中心对齐。                   |
692| Top                      | 气泡提示位于组件上侧,与组件上侧中心对齐。                   |
693| Bottom                   | 气泡提示位于组件下侧,与组件下侧中心对齐。                   |
694| TopLeft                  | 气泡提示位于组件上侧,从API Version 9开始,与组件左侧边缘对齐。 |
695| TopRight                 | 气泡提示位于组件上侧,从API Version 9开始,与组件右侧边缘对齐。 |
696| BottomLeft               | 气泡提示位于组件下侧,从API Version 9开始,与组件左侧边缘对齐。 |
697| BottomRight              | 气泡提示位于组件下侧,从API Version 9开始,与组件右侧边缘对齐。 |
698| LeftTop<sup>9+</sup>     | 气泡提示位于组件左侧,与组件上侧边缘对齐。                   |
699| LeftBottom<sup>9+</sup>  | 气泡提示位于组件左侧,与组件下侧边缘对齐。                   |
700| RightTop<sup>9+</sup>    | 气泡提示位于组件右侧,与组件上侧边缘对齐。                   |
701| RightBottom<sup>9+</sup> | 气泡提示位于组件右侧,与组件下侧边缘对齐。                   |
702
703## CopyOptions<sup>9+</sup>
704
705**系统能力:** SystemCapability.ArkUI.ArkUI.Full
706
707| 名称          | 值 | 说明       |
708| ----------- | --- | -------- |
709| None        | 0 | 不支持复制。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
710| InApp       | 1 | 支持应用内复制。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
711| LocalDevice | 2 | 支持设备内复制。<br/>**卡片能力:** 从API version 9开始,该接口支持在ArkTS卡片中使用。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
712| CROSS_DEVICE<sup>(deprecated)</sup> | 3 | 支持跨设备复制。<br/>**卡片能力:** 从API version 11开始,该接口支持在ArkTS卡片中使用。<br/>**说明:** 从API version 11开始支持,从API version 12开始废弃。 |
713
714## HitTestMode<sup>9+</sup>
715
716**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
717
718**系统能力:** SystemCapability.ArkUI.ArkUI.Full
719
720| 名称          | 说明                                       |
721| ----------- | ---------------------------------------- |
722| Default     | 自身节点和子节点都响应触摸事件的命中测试,但会阻止被该节点屏蔽的其他节点的命中测试。 |
723| Block       | 自身节点响应触摸事件的命中测试,但阻止被该节点屏蔽的子节点和其他节点的命中测试。 |
724| Transparent | 自身节点和子节点响应触摸事件的命中测试,并允许对被该节点屏蔽的其他节点进行命中测试。 |
725| None        | 自身节点不会响应触摸事件的命中测试,但子节点会对触摸事件进行命中测试。      |
726
727## DialogButtonStyle<sup>10+</sup>
728
729**系统能力:** SystemCapability.ArkUI.ArkUI.Full
730
731**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
732
733**系统能力:** SystemCapability.ArkUI.ArkUI.Full
734
735| 名称      | 值   | 说明                              |
736| --------- | ---- | --------------------------------- |
737| DEFAULT   | 0    | 白底蓝字(深色主题:白底=黑底)。 |
738| HIGHLIGHT | 1    | 蓝底白字。                        |
739
740## TextHeightAdaptivePolicy<sup>10+</sup>
741
742**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
743
744**系统能力:** SystemCapability.ArkUI.ArkUI.Full
745
746| 名称                      | 说明                       |
747| ----------------------- | ------------------------ |
748| MAX_LINES_FIRST         | 设置文本高度自适应方式为以MaxLines优先。 |
749| MIN_FONT_SIZE_FIRST     | 设置文本高度自适应方式为以缩小字体优先。     |
750| LAYOUT_CONSTRAINT_FIRST | 设置文本高度自适应方式为以布局约束(高度)优先。 |
751
752## NestedScrollMode<sup>10+</sup>
753
754**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
755
756**系统能力:** SystemCapability.ArkUI.ArkUI.Full
757
758| 名称     | 说明                             |
759| ------ | ------------------------------ |
760| SELF_ONLY   | 只自身滚动,不与父组件联动。  |
761| SELF_FIRST | 自身先滚动,自身滚动到边缘以后父组件滚动。父组件滚动到边缘以后,如果父组件有边缘效果,则父组件触发边缘效果,否则子组件触发边缘效果。        |
762| PARENT_FIRST  | 父组件先滚动,父组件滚动到边缘以后自身滚动。自身滚动到边缘后,如果有边缘效果,会触发自身的边缘效果,否则触发父组件的边缘效果。 |
763| PARALLEL  | 自身和父组件同时滚动,自身和父组件都到达边缘以后,如果自身有边缘效果,则自身触发边缘效果,否则父组件触发边缘效果。|
764
765## ObscuredReasons<sup>10+</sup>
766
767**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
768
769**系统能力:** SystemCapability.ArkUI.ArkUI.Full
770
771| 名称        | 值 | 说明                     |
772| ----------- | -- | ------------------------ |
773| PLACEHOLDER | 0 |显示的数据为通用占位符。 |
774
775## ColoringStrategy<sup>10+</sup>
776
777智能取色枚举类型。
778
779**系统能力:** SystemCapability.ArkUI.ArkUI.Full
780
781| 名称     | 值 | 说明              |
782| ------ | --- | --------------- |
783| INVERT | invert | 设置前景色为控件背景色的反色。仅支持在[foregroundColor](ts-universal-attributes-foreground-color.md#foregroundcolor)中设置该枚举。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
784| AVERAGE<sup>11+</sup> | average | 设置控件背景阴影色为控件背景阴影区域的平均色。仅支持在入参类型为ShadowOptions的[shadow](ts-universal-attributes-image-effect.md#shadow)中设置该枚举。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 |
785| PRIMARY<sup>11+</sup> | primary | 设置控件背景阴影色为控件背景阴影区域的主色。仅支持在入参类型为ShadowOptions的[shadow](ts-universal-attributes-image-effect.md#shadow)中设置该枚举。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 |
786
787## ClickEffectLevel<sup>10+</sup>
788
789**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
790
791**系统能力:** SystemCapability.ArkUI.ArkUI.Full
792
793| 名称   | 说明               | 动效参数                          | 默认缩放比                     |
794| ------ | --------------------------------- | --------------------------------- | --------------------------------- |
795| LIGHT  | 小面积(轻盈) | 弹簧动效, 刚性:410,阻尼:38,初始速度:1 | 90% |
796| MIDDLE | 中面积(稳定) | 弹簧动效, 刚性:350,阻尼:35,初始速度:0.5 | 95% |
797| HEAVY  | 大面积(厚重) | 弹簧动效, 刚性:240,阻尼:28,初始速度:0 | 95% |
798
799## CheckBoxShape<sup>11+</sup>
800
801**卡片能力:** 从API version 11开始,该接口支持在ArkTS卡片中使用。
802
803**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
804
805**系统能力:** SystemCapability.ArkUI.ArkUI.Full
806
807| 名称           | 值   | 说明     |
808| -------------- | ---- | -------- |
809| CIRCLE         | 0    | 圆形     |
810| ROUNDED_SQUARE | 1    | 圆角方形 |
811
812## FoldStatus<sup>11+</sup>
813
814**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
815
816**系统能力:** SystemCapability.ArkUI.ArkUI.Full
817
818| 名称                      |值| 说明         |
819| ----------------------  |----|---------- |
820| FOLD_STATUS_UNKNOWN     |0|表示设备当前折叠状态未知。 |
821| FOLD_STATUS_EXPANDED    |1| 表示设备当前折叠状态为完全展开。   |
822| FOLD_STATUS_FOLDED      |2|表示设备当前折叠状态为折叠。   |
823| FOLD_STATUS_HALF_FOLDED |3| 表示设备当前折叠状态为半折叠。半折叠指完全展开和折叠之间的状态。|
824
825## TextContentStyle<sup>10+</sup>
826
827**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
828
829**系统能力:** SystemCapability.ArkUI.ArkUI.Full
830
831| 名称    | 说明                                                         |
832| ------- | ------------------------------------------------------------ |
833| DEFAULT | 默认风格,光标宽1.5vp,光标高度与文本选中底板高度和字体大小相关。 |
834| INLINE  | 内联输入风格。文本选中底板高度与输入框高度相同。<br/>内联输入是在有明显的编辑态/非编辑态的区分场景下使用,例如:文件列表视图中的重命名。<br/>不支持showError属性。<br/>内联模式下,不支持拖入文本。 |
835
836
837## Nullable\<T><sup>11+</sup>
838
839type Nullable\<T> = T | undefined;
840
841开发者在使用该类型时候,该类型的对象可以是自定义类型,也可以是undefined。
842
843**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
844
845**系统能力**:SystemCapability.ArkUI.ArkUI.Full
846
847| 类型 | 说明                       |
848| ---- | -------------------------- |
849| T \| undefined | 该类型申明的对象可以是自定义类型,也可以是undefined。 |
850
851## WordBreak<sup>11+</sup>
852
853**系统能力:** SystemCapability.ArkUI.ArkUI.Full
854
855| 名称  | 值 | 说明                                   |
856| ----- | --- | -------------------------------------- |
857| NORMAL  | 0 | CJK(中文、日文、韩文)文本可以在任意2个字符间断行,而Non-CJK文本(如英文等)只能在空白符处断行。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
858| BREAK_ALL | 1 | 对于Non-CJK的文本,可在任意2个字符间断行。对于CJK与NORMAL效果一致。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
859| BREAK_WORD | 2 | 与BREAK_ALL相同,对于Non-CJK的文本可在任意2个字符间断行,一行文本中有断行破发点(如空白符)时,优先按破发点换行,保障单词优先完整显示。若整一行文本均无断行破发点时,则在任意2个字符间断行。对于CJK与NORMAL效果一致。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
860| HYPHENATION<sup>18+</sup> | 3 | 对于Non-CJK的文本,可以按照音节断行。对于CJK的文本,换行效果与NORMAL效果保持一致。<br/>**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 |
861
862## LineBreakStrategy<sup>12+</sup>
863
864**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
865
866**系统能力:** SystemCapability.ArkUI.ArkUI.Full
867
868| 名称         | 值 | 说明                                                         |
869| ------------ | --- | ------------------------------------------------------------ |
870| GREEDY       | 0 | 使每一行尽量显示多的字符,直到这一行不能显示更多字符再进行折行。 |
871| HIGH_QUALITY | 1 | 在BALANCED的基础上,尽可能填满行,在最后一行的权重上比较低,可能会出现最后一行留白比较多。 |
872| BALANCED     | 2 | 尽可能保证在不拆词的情况下,使一个段落中每一行的宽度相同。   |
873
874## TextSelectableMode<sup>12+</sup>
875
876**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
877
878**系统能力:** SystemCapability.ArkUI.ArkUI.Full
879
880| 名称         | 值 | 说明                                                         |
881| ------------ | --- | ------------------------------------------------------------ |
882| SELECTABLE_UNFOCUSABLE  | 0 | 文本可选择,但不可获焦,设置属性selection、bindSelectionMenu、copyOption不影响当前行为。 |
883| SELECTABLE_FOCUSABLE | 1 | 文本可选择,可获焦并Touch后获得焦点。 |
884| UNSELECTABLE     | 2 | 文本不可选择,不可获焦,设置属性selection、bindSelectionMenu、copyOption都不生效。  |
885
886## AccessibilityHoverType<sup>12+</sup>
887
888**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
889
890**系统能力:** SystemCapability.ArkUI.ArkUI.Full
891
892| 名称         | 值 | 说明                                                         |
893| ------------ | - | ------------------------------------------------------------ |
894| HOVER_ENTER  | 0 | 手指按下时触发。         |
895| HOVER_MOVE   | 1 | 触摸移动时触发。         |
896| HOVER_EXIT   | 2 | 抬手触发。              |
897| HOVER_CANCEL | 3 | 打断取消当前触发的事件。  |
898
899## EllipsisMode<sup>11+</sup>
900
901**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
902
903**系统能力:** SystemCapability.ArkUI.ArkUI.Full
904
905| 名称  | 值 | 说明                                   |
906| ----- | --- | -------------------------------------- |
907| START  | 0 | 省略行首内容。|
908| CENTER | 1 | 省略行中内容。|
909| END | 2 | 省略行末内容。|
910
911## ArrowPointPosition<sup>11+</sup>
912
913**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
914
915**系统能力:** SystemCapability.ArkUI.ArkUI.Full
916
917| 名称            | 值           | 说明                                     |
918| ------------- | -------------------------------------- | -------------------------------------- |
919| START | 'Start' | 水平方向:位于父组件最左侧,垂直方向:位于父组件最上侧。 |
920| CENTER | 'Center' | 位于父组件居中位置。 |
921| END | 'End' | 水平方向:位于父组件最右侧,垂直方向:位于父组件最下侧。 |
922
923## OptionWidthMode<sup>11+</sup>
924
925**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
926
927**系统能力:** SystemCapability.ArkUI.ArkUI.Full
928
929| 名称        | 值       | 说明                           |
930| ----------- | ------------------------------ | ------------------------------ |
931| FIT_CONTENT | 'fit_content' | 设置该值时,下拉菜单宽度按默认2栅格显示。            |
932| FIT_TRIGGER | 'fit_trigger' | 设置下拉菜单继承下拉按钮宽度。 |
933
934## PixelRoundCalcPolicy<sup>11+</sup>
935
936组件边界像素取整计算策略。
937
938**卡片能力:** 从API version 11开始,该接口支持在ArkTS卡片中使用。
939
940**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
941
942**系统能力:** SystemCapability.ArkUI.ArkUI.Full
943
944| 名称     |值| 说明                            |
945| ------ |----| ----------------------------- |
946| NO_FORCE_ROUND |0| 不取整计算。|
947| FORCE_CEIL |1| 取上整计算。|
948| FORCE_FLOOR |2| 取下整计算。|
949
950## TextDecorationStyle<sup>12+</sup>
951
952**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
953
954**系统能力:** SystemCapability.ArkUI.ArkUI.Full
955
956| 名称          | 值 | 说明        |
957| ----------- | --- | --------- |
958| SOLID   | 0 | 单实线(默认值)。  |
959| DOUBLE | 1 | 双实线。 |
960| DOTTED    | 2 | 点线。  |
961| DASHED        | 3 | 虚线。 |
962| WAVY        | 4 | 波浪线。 |
963
964## EmbeddedType<sup>12+</sup>
965枚举类型,用于指定EmbeddedComponent可拉起的提供方类型。
966
967**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
968
969**系统能力:** SystemCapability.ArkUI.ArkUI.Full
970
971| 名称                  | 值 | 说明                                                |
972| --------------------- | - | ---------------------------------------------------- |
973| EMBEDDED_UI_EXTENSION | 0 | 表示当前拉起的提供方类型为EmbeddedUIExtensionAbility。|
974
975## MarqueeUpdateStrategy<sup>12+</sup>
976
977**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
978
979**系统能力:** SystemCapability.ArkUI.ArkUI.Full
980
981| 名称       | 值      | 说明                     |
982| ---------- | ------------------------ | ------------------------ |
983| DEFAULT | 0 | 跑马灯组件属性更新后, 从开始位置, 运行跑马灯效果。     |
984| PRESERVE_POSITION  | 1 | 跑马灯组件属性更新后, 保持当前位置, 运行跑马灯效果。 |
985
986## AppRotation<sup>12+</sup>
987
988**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
989
990**系统能力:** SystemCapability.ArkUI.ArkUI.Full
991
992| 名称     |值| 说明                            |
993| ------ |----| ----------------------------- |
994| ROTATION_0 |0| 应用方向为0度。|
995| ROTATION_90 |1|应用方向为90度。|
996| ROTATION_180 |2| 应用方向为180度。|
997| ROTATION_270 |3| 应用方向为270度。|
998
999## ScrollSource<sup>12+</sup>
1000
1001滑动操作的来源。
1002
1003**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
1004
1005**系统能力:** SystemCapability.ArkUI.ArkUI.Full
1006
1007| 名称     |  值  | 说明                                       |
1008| ------ | ------ | ---------------------------------------- |
1009| DRAG   |  0  | 拖拽事件。 |
1010| FLING |  1  | 拖拽结束之后的惯性滑动。 |
1011| EDGE_EFFECT  |  2  | EdgeEffect.Spring的边缘滚动效果。 |
1012| OTHER_USER_INPUT  |  3  | 除拖拽外的其他用户输入,如鼠标滚轮、键盘事件等。 |
1013| SCROLL_BAR  |  4  | 滚动条的拖拽事件。 |
1014| SCROLL_BAR_FLING  |  5  | 滚动条拖拽结束后的带速度的惯性滑动。 |
1015| SCROLLER  |  6  | Scroller的不带动效方法。 |
1016| SCROLLER_ANIMATION  |  7  | Scroller的带动效方法。 |
1017
1018## ImageSpanAlignment<sup>10+</sup>
1019
1020**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
1021
1022**系统能力:** SystemCapability.ArkUI.ArkUI.Full
1023
1024| 名称     | 说明                           |
1025| -------- | ------------------------------ |
1026| TOP      | 图片上边沿与行上边沿对齐。   |
1027| CENTER   | 图片中间与行中间对齐。       |
1028| BOTTOM   | 图片下边沿与行下边沿对齐。   |
1029| BASELINE | 图片下边沿与文本BaseLine对齐。 |
1030
1031
1032## XComponentType<sup>10+</sup>
1033
1034**系统能力:** SystemCapability.ArkUI.ArkUI.Full
1035
1036| 名称                             | 说明                                                         |
1037| -------------------------------- | ------------------------------------------------------------ |
1038| SURFACE                          | 用于EGL/OpenGLES和媒体数据写入,开发者定制的绘制内容单独展示到屏幕上。背景色设置为黑色时会走显示子系统(DSS)。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
1039| COMPONENT<sup>(deprecated)</sup> | XComponent将变成一个容器组件,并可在其中执行非UI逻辑以动态加载显示内容。<br/>**说明:**<br/>从API version 12 开始,该接口废弃,建议使用其他容器组件替代。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
1040| TEXTURE                          | 用于EGL/OpenGLES和媒体数据写入,开发者定制的绘制内容会和XComponent组件的内容合成后展示到屏幕上。1、保持帧同步,保持在同一帧将图形处理器(GPU)纹理和ArkUI其他的绘制指令统一发给渲染服务(RenderService)。2、动效和系统组件统一。3、走图形处理器(GPU)合成,相比surface可能走显示子系统(DSS)功耗更高。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
1041| NODE<sup>12+</sup>            | 用于Native UI节点的占位容器,开发者通过Native API 开发的页面组件可展示在此容器区域内。<br/>**说明:**<br/>该类型不再演进,推荐使用[ContentSlot](../../../ui/state-management/arkts-rendering-control-contentslot.md)占位组件管理Native API创建的组件,ContentSlot在内存和性能方面都优于NODE类型的XComponent。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 |
1042
1043## HoverModeAreaType<sup>14+</sup>
1044
1045悬停态显示区域类型。
1046
1047**原子化服务API:** 从API version 14开始,该接口支持在原子化服务中使用。
1048
1049**系统能力**:SystemCapability.ArkUI.ArkUI.Full
1050
1051| 名称     | 值    | 说明                            |
1052| ------ | ----------------------------- | ----------------------------- |
1053| TOP_SCREEN | 0 | 上半屏。|
1054| BOTTOM_SCREEN | 1 | 下半屏。|
1055
1056## WidthBreakpoint<sup>13+</sup>
1057
1058表示窗口不同宽度阈值下对应的宽度断点枚举值。通过[getWindowWidthBreakpoint](../js-apis-arkui-UIContext.md#getwindowwidthbreakpoint13)返回。
1059
1060**原子化服务API:** 从API version 13开始,该接口支持在原子化服务中使用。
1061
1062**系统能力:**  SystemCapability.ArkUI.ArkUI.Full
1063
1064| 名称     | 值   | 说明                   |
1065| -------- | ---- | ---------------------- |
1066| WIDTH_XS | 0   | 窗口宽度小于320vp。 |
1067| WIDTH_SM | 1   | 窗口宽度大于等于320vp,且小于600vp。 |
1068| WIDTH_MD | 2   | 窗口宽度大于等于600vp,且小于840vp。 |
1069| WIDTH_LG | 3   | 窗口宽度大于等于840vp,且小于1440vp。 |
1070| WIDTH_XL | 4   | 窗口宽度大于等于1440vp。 |
1071
1072## HeightBreakpoint<sup>13+</sup>
1073
1074表示窗口不同高宽比阈值下对应的高度断点枚举值。通过[getWindowHeightBreakpoint](../js-apis-arkui-UIContext.md#getwindowheightbreakpoint13)返回。
1075
1076**原子化服务API:** 从API version 13开始,该接口支持在原子化服务中使用。
1077
1078**系统能力:**  SystemCapability.ArkUI.ArkUI.Full
1079
1080| 名称     | 值   | 说明                   |
1081| -------- | ---- | ---------------------- |
1082| HEIGHT_SM | 0   | 窗口高宽比小于0.8。 |
1083| HEIGHT_MD | 1   | 窗口高宽比大于等于0.8,且小于1.2。 |
1084| HEIGHT_LG | 2   | 窗口高宽比大于等于1.2。 |
1085
1086## AxisModel<sup>15+</sup>
1087
1088定义焦点轴事件的轴类型。
1089
1090**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。
1091
1092**系统能力:**  SystemCapability.ArkUI.ArkUI.Full
1093
1094| 名称    | 值   | 说明                               |
1095| ------- | ---- | ---------------------------------- |
1096| ABS_X  | 0    | 游戏手柄X轴。 |
1097| ABS_Y  | 1    | 游戏手柄Y轴。 |
1098| ABS_Z  | 2    | 游戏手柄Z轴。 |
1099| ABS_RZ | 3    | 游戏手柄RZ轴。 |
1100| ABS_GAS | 4    | 游戏手柄GAS轴。 |
1101| ABS_BRAKE | 5    | 游戏手柄BRAKE轴。 |
1102| ABS_HAT0X | 6    | 游戏手柄HAT0X轴。 |
1103| ABS_HAT0Y | 7    | 游戏手柄HAT0Y轴。 |
1104
1105## PageFlipMode<sup>15+</sup>
1106
1107表示鼠标滚轮翻页模式。
1108
1109**卡片能力:** 从API version 15开始,该接口支持在ArkTS卡片中使用。
1110
1111**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。
1112
1113**系统能力:**  SystemCapability.ArkUI.ArkUI.Full
1114
1115| 名称     | 值   | 说明                   |
1116| -------- | ---- | ---------------------- |
1117| CONTINUOUS | 0   | 连续翻页模式,鼠标滚轮连续滚动时连续翻多页。 |
1118| SINGLE | 1   | 单次翻页模式,在一次翻页动画结束前不响应滚轮事件。 |
1119
1120## RenderFit<sup>10+</sup>
1121
1122表示宽高动画过程中组件内容的填充方式。
1123
1124**卡片能力:** 从API version 18开始,该接口支持在ArkTS卡片中使用。
1125
1126**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
1127
1128**系统能力:**  SystemCapability.ArkUI.ArkUI.Full
1129
1130| 名称                          | 值                          | 说明                                                                              |
1131| --------------------------- | -- | ---------------------------------------------------------------------------------- |
1132| CENTER                      | 0                           | 保持动画终态的内容大小,并且内容始终与组件保持中心对齐。               ![renderfit_center](figures/renderfit_center.png) |
1133| TOP                         | 1                           | 保持动画终态的内容大小,并且内容始终与组件保持顶部中心对齐。             ![renderfit_top](figures/renderfit_top.png) |
1134| BOTTOM                      | 2                           | 保持动画终态的内容大小,并且内容始终与组件保持底部中心对齐。             ![renderfit_bottom](figures/renderfit_bottom.png) |
1135| LEFT                        | 3                           | 保持动画终态的内容大小,并且内容始终与组件保持左侧对齐。               ![renderfit_left](figures/renderfit_left.png) |
1136| RIGHT                       | 4                           | 保持动画终态的内容大小,并且内容始终与组件保持右侧对齐。              ![renderfit_right](figures/renderfit_right.png) |
1137| TOP_LEFT                    | 5                           | 保持动画终态的内容大小,并且内容始终与组件保持左上角对齐。              ![renderfit_top_left](figures/renderfit_top_left.png) |
1138| TOP_RIGHT                   | 6                           | 保持动画终态的内容大小,并且内容始终与组件保持右上角对齐。             ![renderfit_top_right](figures/renderfit_top_right.png) |
1139| BOTTOM_LEFT                 | 7                           | 保持动画终态的内容大小,并且内容始终与组件保持左下角对齐。              ![renderfit_bottom_left](figures/renderfit_bottom_left.png) |
1140| BOTTOM_RIGHT                | 8                           | 保持动画终态的内容大小,并且内容始终与组件保持右下角对齐。              ![renderfit_bottom_right](figures/renderfit_bottom_right.png) |
1141| RESIZE_FILL                 | 9                           | 不考虑动画终态内容的宽高比,并且内容始终缩放到组件的大小。              ![renderfit_resize_fill](figures/renderfit_resize_fill.png) |
1142| RESIZE_CONTAIN              | 10                          | 保持动画终态内容的宽高比进行缩小或放大,使内容完整显示在组件内,且与组件保持中心对齐。   ![renderfit_resize_contain](figures/renderfit_resize_contain.png) |
1143| RESIZE_CONTAIN_TOP_LEFT     | 11                          | 保持动画终态内容的宽高比进行缩小或放大,使内容完整显示在组件内。当组件宽方向有剩余时,内容与组件保持左侧对齐,当组件高方向有剩余时,内容与组件保持顶部对齐。   ![renderfit_resize_contain_top_left](figures/renderfit_resize_contain_top_left.png) |
1144| RESIZE_CONTAIN_BOTTOM_RIGHT | 12                          | 保持动画终态内容的宽高比进行缩小或放大,使内容完整显示在组件内。当组件宽方向有剩余时,内容与组件保持右侧对齐,当组件高方向有剩余时,内容与组件保持底部对齐。   ![renderfit_resize_contain_bottom_right](figures/renderfit_resize_contain_bottom_right.png) |
1145| RESIZE_COVER                | 13                          | 保持动画终态内容的宽高比进行缩小或放大,使内容两边都大于或等于组件两边,且与组件保持中心对齐,显示内容的中间部分。   ![renderfit_resize_cover](figures/renderfit_resize_cover.png) |
1146| RESIZE_COVER_TOP_LEFT       | 14                          | 保持动画终态内容的宽高比进行缩小或放大,使内容的两边都恰好大于或等于组件两边。当内容宽方向有剩余时,内容与组件保持左侧对齐,显示内容的左侧部分。当内容高方向有剩余时,内容与组件保持顶部对齐,显示内容的顶侧部分。   ![renderfit_resize_cover_top_left](figures/renderfit_resize_cover_top_left.png) |
1147| RESIZE_COVER_BOTTOM_RIGHT   | 15                          | 保持动画终态内容的宽高比进行缩小或放大,使内容的两边都恰好大于或等于组件两边。当内容宽方向有剩余时,内容与组件保持右侧对齐,显示内容的右侧部分。当内容高方向有剩余时,内容与组件保持底部对齐,显示内容的底侧部分。   ![renderfit_resize_cover_bottom_right](figures/renderfit_resize_cover_bottom_right.png) |
1148
1149
1150> **说明:**
1151>
1152> - 示意图中,蓝色区域表示内容,橙黄色区域表示节点大小。
1153> - 不同的内容填充方式在宽高动画过程中效果不一致,开发者需要选择合适的内容填充方式以实现需要的动画效果。
1154
1155## CrownAction<sup>18+</sup>
1156
1157旋转表冠动作。
1158
1159**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。
1160
1161**系统能力:** SystemCapability.ArkUI.ArkUI.Full
1162
1163|名称	            | 值 | 说明                                   |
1164|-------------------| -- | ------------------------------------- |
1165| BEGIN             | 0  | 表冠开始转动。                          |
1166| UPDATE	        | 1  | 表冠转动中。                            |
1167| END	            | 2  | 表冠停止转动。                          |
1168
1169## CrownSensitivity<sup>18+</sup>
1170
1171旋转表冠灵敏度。
1172
1173**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。
1174
1175**系统能力:** SystemCapability.ArkUI.ArkUI.Full
1176
1177| 名称           | 值  | 说明                                      |
1178| -------------- | -- | ---------------------------------------- |
1179| LOW 	         | 0   | 低灵敏度。                                 |
1180| MEDIUM         | 1   | 中灵敏度。                                 |
1181| HIGH 	         | 2   | 高灵敏度。                                 |
1182
1183## AxisAction<sup>17+</sup>
1184
1185定义轴事件的轴动作类型。
1186
1187**原子化服务API:** 从API version 17开始,该接口支持在原子化服务中使用。
1188
1189**系统能力:**  SystemCapability.ArkUI.ArkUI.Full
1190
1191| 名称    | 值   | 说明                               |
1192| ------- | ---- | ---------------------------------- |
1193| NONE   | 0    | 无轴事件。 |
1194| BEGIN  | 1    | 轴事件开始。 |
1195| UPDATE | 2    | 轴事件触发中。 |
1196| END    | 3    | 轴事件结束。 |
1197| CANCEL | 4    | 轴事件取消。 |
1198
1199## InteractionHand<sup>15+</sup>
1200
1201定义事件是由左手点击触发还是右手点击触发。
1202
1203**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。
1204
1205**系统能力:**  SystemCapability.ArkUI.ArkUI.Full
1206
1207| 名称     | 值   | 说明                   |
1208| -------- | ---- | ---------------------- |
1209| NONE     | 0   | 未知。 |
1210| LEFT     | 1   | 左手。 |
1211| RIGHT    | 2   | 右手。 |
1212
1213## PixelRoundMode<sup>18+</sup>
1214
1215指定像素取整模式。
1216
1217**卡片能力:** 从API version 18开始,该接口支持在ArkTS卡片中使用。
1218
1219**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。
1220
1221**系统能力:** SystemCapability.ArkUI.ArkUI.Full
1222
1223| 名称    |  值   | 说明                   |
1224| ------  |---- | -------------------- |
1225| PIXEL_ROUND_ON_LAYOUT_FINISH | 0 | 在组件测量大小和位置后进行像素取整,默认值为0。 |
1226| PIXEL_ROUND_AFTER_MEASURE |  1 | 在组件测量大小结束后进行像素取整。 |
1227
1228>  **说明:**
1229> 在PIXEL_ROUND_AFTER_MEASURE模式下,组件会在测量时进行一次取整,也即最终大小与PIXEL_ROUND_ON_LAYOUT_FINISH会有1px的区别。