openharmony 鸿蒙 capi-native-node-h-nodeattributetype-animator

2026-08-25 浏览 (1)

ArkUI_NodeAttributeType(动效、视效相关属性)

enum ArkUI_NodeAttributeType

概述

定义ArkUI在Native侧可以设置的动效、视效相关属性样式集合,包含图形变换、渐变、阴影、模糊和转场等属性设置。

起始版本: 12

相关模块: ArkUI_NativeModule

所在头文件: native_node.h

NODE_TRANSLATE

NODE_TRANSLATE = 8

设置组件平移,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32x轴移动距离,单位vp,默认值0。
.value[1].f32y轴移动距离,单位vp,默认值0。
.value[2].f32z轴移动距离,单位vp,默认值0。

返回:

类型说明
.value[0].f32x轴移动距离,单位vp。
.value[1].f32y轴移动距离,单位vp。
.value[2].f32z轴移动距离,单位vp。

NODE_SCALE

NODE_SCALE = 9

设置组件缩放,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32x轴的缩放系数,默认值1。
.value[1].f32y轴的缩放系数,默认值1。

返回:

类型说明
.value[0].f32x轴的缩放系数。
.value[1].f32y轴的缩放系数。

NODE_ROTATE

NODE_ROTATE = 10

设置组件旋转,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32旋转轴向量x坐标,默认值0。
.value[1].f32旋转轴向量y坐标,默认值0。
.value[2].f32旋转轴向量z坐标,默认值0。
.value[3].f32旋转角度,默认值0。
.value[4].f32视距,即视点到z=0平面的距离,单位vp,默认值0。

返回:

类型说明
.value[0].f32旋转轴向量x坐标。
.value[1].f32旋转轴向量y坐标。
.value[2].f32旋转轴向量z坐标。
.value[3].f32旋转角度。
.value[4].f32视距,即视点到z=0平面的距离,单位vp。

NODE_BRIGHTNESS

NODE_BRIGHTNESS = 11

设置组件高光效果,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32亮度值,默认值1.0,推荐取值范围[0, 2.0]。

返回:

类型说明
.value[0].f32亮度值。

NODE_SATURATION

NODE_SATURATION = 12

设置组件饱和度效果,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32饱和度值,默认值1.0,推荐取值范围[0, 50.0)。

返回:

类型说明
.value[0].f32饱和度值。

NODE_BLUR

NODE_BLUR = 13

设置组件内容模糊效果,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32模糊半径,模糊半径越大越模糊,为0时不模糊,小于0时按0处理且不会返回错误码。单位vp,默认值0.0。

返回:

类型说明
.value[0].f32模糊半径,模糊半径越大越模糊,为0时不模糊。单位vp。

NODE_LINEAR_GRADIENT

NODE_LINEAR_GRADIENT = 14

设置组件颜色渐变效果,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32线性渐变的起始角度,当ArkUI_LinearGradientDirection为ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM时,angle属性生效,否则按direction为主要布局方式。0点方向顺时针旋转为正向角度,默认值:180。
.value[1].i32线性渐变的方向,设置除ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM的线性渐变方向后,angle不生效。数据类型ArkUI_LinearGradientDirection
.value[2].i32为渐变的颜色重复着色,默认值 false。
.object参数类型为ArkUI_ColorStop。指定某百分比位置处的渐变色颜色,设置非法颜色直接跳过:
colors渐变色颜色。
stops渐变位置。
size颜色个数。

返回:

类型说明
.value[0].f32线性渐变的起始角度。当为ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM时,angle为设置值,其他情况均为默认值。
.value[1].i32线性渐变的方向。
.value[2].i32为渐变的颜色重复着色。
.object参数类型为ArkUI_ColorStop。指定某百分比位置处的渐变色颜色,设置非法颜色直接跳过:
colors渐变色颜色。
stops渐变位置。
size颜色个数。

NODE_OPACITY

NODE_OPACITY = 16

透明度属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32透明度数值,默认值为1,取值范围为0到1。

返回:

类型说明
.value[0].f32透明度数值,取值范围为0到1。

NODE_Z_INDEX

NODE_Z_INDEX = 21

组件的堆叠顺序属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32堆叠顺序数值。

返回:

类型说明
.value[0].i32堆叠顺序数值。

NODE_VISIBILITY

NODE_VISIBILITY = 22

组件是否可见属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32控制当前组件显示或隐藏,参数类型ArkUI_Visibility,默认值为ARKUI_VISIBILITY_VISIBLE。

返回:

类型说明
.value[0].i32控制当前组件显示或隐藏,参数类型ArkUI_Visibility,默认值为ARKUI_VISIBILITY_VISIBLE。

NODE_CLIP

NODE_CLIP = 23

组件进行裁剪、遮罩处理属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32控制是否对子组件超出当前组件范围外的区域进行裁剪,0表示不裁切,1表示裁切。默认为不裁切。

返回:

类型说明
.value[0].i32控制是否对子组件超出当前组件范围外的区域进行裁剪,0表示不裁切,1表示裁切。

NODE_CLIP_SHAPE

NODE_CLIP_SHAPE = 24

组件上指定形状的裁剪,支持属性设置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

1.rect类型:

参数项描述
.value[0].i32裁剪类型,参数类型ArkUI_ClipType,ARKUI_CLIP_TYPE_RECTANGLE。
.value[1].f32矩形宽度,单位为vp。
.value[2].f32矩形高度,单位为vp。
.value[3].f32矩形圆角宽度,单位为vp。
.value[4].f32矩形圆角高度,单位为vp。
.value[5]?.f32矩形形状的左上圆角半径,单位为vp。
.value[6]?.f32矩形形状的左下圆角半径,单位为vp。
.value[7]?.f32矩形形状的右上圆角半径,单位为vp。
.value[8]?.f32矩形形状的右下圆角半径,单位为vp。
.object参数类型为ArkUI_RenderNodeClipOption,矩形形状的坐标偏移量,在仅传入.object参数时生效。

2.circle类型:

参数项描述
.value[0].i32裁剪类型,参数类型ArkUI_ClipType,ARKUI_CLIP_TYPE_CIRCLE。
.value[1].f32圆形宽度,单位为vp。
.value[2].f32圆形高度,单位为vp。
.object参数类型为ArkUI_RenderNodeClipOption,圆形坐标偏移量,在仅传入.object参数时生效。

3.ellipse类型:

参数项描述
.value[0].i32裁剪类型,参数类型ArkUI_ClipType,ARKUI_CLIP_TYPE_ELLIPSE。
.value[1].f32椭圆形宽度,单位为vp。
.value[2].f32椭圆形高度,单位为vp。
.object参数类型为ArkUI_RenderNodeClipOption,椭圆形坐标偏移量,在仅传入.object参数时生效。

4.path类型:

参数项描述
.value[0].i32裁剪类型,参数类型ArkUI_ClipType,ARKUI_CLIP_TYPE_PATH。
.value[1].f32路径宽度,单位为vp。
.value[2].f32路径高度,单位为vp。
.string路径绘制的命令字符串。
.object参数类型为ArkUI_RenderNodeClipOption,路径绘制的命令,在仅传入.object参数时生效。

返回:

1.rect类型:

类型说明
.value[0].i32裁剪类型,参数类型ArkUI_ClipType,ARKUI_CLIP_TYPE_RECTANGLE。
.value[1].f32矩形宽度,单位为vp。
.value[2].f32矩形高度,单位为vp。
.value[3].f32矩形圆角宽度,单位为vp。
.value[4].f32矩形圆角高度,单位为vp。
.value[5]?.f32矩形形状的左上圆角半径,单位为vp。
.value[6]?.f32矩形形状的左下圆角半径,单位为vp。
.value[7]?.f32矩形形状的右上圆角半径,单位为vp。
.value[8]?.f32矩形形状的右下圆角半径,单位为vp。
.value[9]?.f32矩形形状的横坐标偏移,单位为vp。
.value[10]?.f32矩形形状的纵坐标偏移,单位为vp。

2.circle类型:

类型说明
.value[0].i32裁剪类型,参数类型ArkUI_ClipType,ARKUI_CLIP_TYPE_CIRCLE。
.value[1].f32圆形宽度,单位为vp。
.value[2].f32圆形高度,单位为vp。
.value[3]?.f32圆形横坐标偏移,单位为vp。
.value[4]?.f32圆形纵坐标偏移,单位为vp。

3.ellipse类型:

类型说明
.value[0].i32裁剪类型,参数类型ArkUI_ClipType,ARKUI_CLIP_TYPE_ELLIPSE。
.value[1].f32椭圆形宽度,单位为vp。
.value[2].f32椭圆形高度,单位为vp。
.value[3]?.f32椭圆形横坐标偏移,单位为vp。
.value[4]?.f32椭圆形纵坐标偏移,单位为vp。

4.path类型:

类型说明
.value[0].i32裁剪类型,参数类型ArkUI_ClipType,ARKUI_CLIP_TYPE_PATH。
.value[1].f32路径宽度,单位为vp。
.value[2].f32路径高度,单位为vp。
.string路径绘制的命令字符串。

NODE_TRANSFORM

NODE_TRANSFORM = 25

矩阵变换功能,可对图形进行平移、旋转和缩放等,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0...15].f3216个浮点数。此时ArkUI_AttributeItem中的size取值不应为0。
.object是指向ArkUI_Matrix4的指针,此时ArkUI_AttributeItem中的size取值为0。

返回:

类型说明
.value[0...15].f3216个浮点数字。

NODE_SHADOW

NODE_SHADOW = 28

阴影效果属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32设置当前组件阴影效果,参数类型ArkUI_ShadowStyle

返回:

类型说明
.value[0].i32设置当前组件阴影效果,参数类型ArkUI_ShadowStyle

NODE_CUSTOM_SHADOW

NODE_CUSTOM_SHADOW = 29

自定义阴影效果,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0]?.f32阴影模糊半径,单位为px。
.value[1]?.i32是否开启智能取色,0代表不开启,1代表开启,默认不开启。
.value[2]?.f32阴影X轴偏移量,单位为px。
.value[3]?.f32阴影Y轴偏移量,单位为px。
.value[4]?.i32阴影类型ArkUI_ShadowType,默认值为ARKUI_SHADOW_TYPE_COLOR。
.value[5]?.u32阴影颜色,0xargb格式,形如 0xFFFF0000 表示红色。
.value[6]?.u32阴影是否内部填充,0表示不填充,1表示填充。

返回:

类型说明
.value[0].f32阴影模糊半径,单位为px。
.value[1].i32是否开启智能取色。
.value[2].f32阴影X轴偏移量,单位为px。
.value[3].f32阴影Y轴偏移量,单位为px。
.value[4].i32阴影类型ArkUI_ShadowType,默认值为ARKUI_SHADOW_TYPE_COLOR。
.value[5].u32阴影颜色,0xargb格式,形如 0xFFFF0000 表示红色。
.value[6].u32阴影是否内部填充,0表示不填充,1表示填充。

NODE_BACKGROUND_BLUR_STYLE

NODE_BACKGROUND_BLUR_STYLE = 32

背景和内容之间的模糊属性,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32表示模糊类型,取ArkUI_BlurStyle枚举值。
.value[1]?.i32表示深浅色模式,取ArkUI_ColorMode枚举值。
.value[2]?.i32表示取色模式,取ArkUI_AdaptiveColor枚举值。
.value[3]?.f32表示模糊效果程度,取[0.0,1.0]范围内的值。
.value[4]?.f32表示灰阶模糊起始边界。
.value[5]?.f32表示灰阶模糊终点边界。

返回:

类型说明
.value[0].i32表示模糊类型,取ArkUI_BlurStyle枚举值。
.value[1].i32表示深浅色模式,取ArkUI_ColorMode枚举值。
.value[2].i32表示取色模式,取ArkUI_AdaptiveColor枚举值。
.value[3].f32表示模糊效果程度,取[0.0,1.0]范围内的值。
.value[4].f32表示灰阶模糊起始边界。
.value[5].f32表示灰阶模糊终点边界。

NODE_TRANSFORM_CENTER

NODE_TRANSFORM_CENTER = 33

图形变换和转场的中心点属性,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。
注:如果设置坐标百分比位置,属性获取方法返回计算后的以vp为单位的值。

起始版本: 12

参数:

参数项描述
.value[0]?.f32表示中心点X轴坐标值,单位为vp。
.value[1]?.f32表示中心点Y轴坐标,单位为vp。
.value[2]?.f32表示中心点Z轴坐标,单位为vp。
.value[3]?.f32表示中心点X轴坐标的百分比位置,如0.2表示百分之20的位置,该属性覆盖value[0].f32,默认值:0.5f。
.value[4]?.f32表示中心点Y轴坐标的百分比位置,如0.2表示百分之20的位置,该属性覆盖value[1].f32,默认值:0.5f。
.value[5]?.f32表示中心点Z轴坐标的百分比位置,如0.2表示百分之20的位置,该属性覆盖value[2].f32,默认值:0.0f。

返回:

类型说明
.value[0].f32表示中心点X轴坐标,单位为vp。
.value[1].f32表示中心点Y轴坐标,单位为vp。
.value[2].f32表示中心点Z轴坐标,单位为vp。

NODE_MOTION_PATH

NODE_MOTION_PATH = 111

设置组件的运动路径属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 23

参数:

参数项描述
.object指向路径动画的运动路径配置项的指针;参数类型为ArkUI_MotionPathOptions

返回:

类型说明
.object指向路径动画的运动路径配置项的指针;参数类型为ArkUI_MotionPathOptions

NODE_OPACITY_TRANSITION

NODE_OPACITY_TRANSITION = 34

转场时的透明度效果属性,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32表示起终点的透明度值。
.value[1].i32表示动画时长,单位ms。
.value[2].i32表示动画曲线类型,取ArkUI_AnimationCurve枚举值。
.value[3]?.i32表示动画延迟时长,单位ms。
.value[4]?.i32表示动画播放次数。
.value[5]?.i32表示动画播放模式,取ArkUI_AnimationPlayMode枚举值。
.value[6]?.f32表示动画播放速度。

返回:

类型说明
.value[0].f32表示起终点的透明度值。
.value[1].i32表示动画时长,单位ms。
.value[2].i32表示动画曲线类型,取ArkUI_AnimationCurve枚举值。
.value[3].i32表示动画延迟时长,单位ms。
.value[4].i32表示动画播放次数。
.value[5].i32表示动画播放模式,取ArkUI_AnimationPlayMode枚举值。
.value[6].f32表示动画播放速度。

NODE_ROTATE_TRANSITION

NODE_ROTATE_TRANSITION = 35

转场时的旋转效果属性,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32表示横向旋转分量。
.value[1].f32表示纵向的旋转分量。
.value[2].f32表示竖向的旋转分量。
.value[3].f32表示角度。
.value[4].f32表示视距,默认值:0.0f。
.value[5].i32表示动画时长,单位ms。
.value[6].i32表示动画曲线类型,取ArkUI_AnimationCurve枚举值。
.value[7]?.i32表示动画延迟时长,单位ms。
.value[8]?.i32表示动画播放次数。
.value[9]?.i32表示动画播放模式,取ArkUI_AnimationPlayMode枚举值。
.value[10]?.f32表示动画播放速度。

返回:

类型说明
.value[0].f32表示横向旋转分量。
.value[1].f32表示纵向的旋转分量。
.value[2].f32表示竖向的旋转分量。
.value[3].f32表示角度。
.value[4].f32表示视距。
.value[5].i32表示动画时长,单位ms。
.value[6].i32表示动画曲线类型,取ArkUI_AnimationCurve枚举值。
.value[7].i32表示动画延迟时长,单位ms。
.value[8].i32表示动画播放次数。
.value[9].i32表示动画播放模式,取ArkUI_AnimationPlayMode枚举值。
.value[10].f32表示动画播放速度。

NODE_SCALE_TRANSITION

NODE_SCALE_TRANSITION = 36

转场时的缩放效果属性,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32横向放大倍数。
.value[1].f32纵向放大倍数。
.value[2].f32竖向放大倍数。
.value[3].i32表示动画时长,单位ms。
.value[4].i32表示动画曲线类型,取ArkUI_AnimationCurve枚举值。
.value[5]?.i32表示动画延迟时长,单位ms。
.value[6]?.i32表示动画播放次数。
.value[7]?.i32表示动画播放模式,取ArkUI_AnimationPlayMode枚举值。
.value[8]?.f32表示动画播放速度。

返回:

类型说明
.value[0].f32横向放大倍数。
.value[1].f32纵向放大倍数。
.value[2].f32竖向放大倍数。
.value[3].i32表示动画时长,单位ms。
.value[4].i32表示动画曲线类型,取ArkUI_AnimationCurve枚举值。
.value[5].i32表示动画延迟时长,单位ms。
.value[6].i32表示动画播放次数。
.value[7].i32表示动画播放模式,取ArkUI_AnimationPlayMode枚举值。
.value[8].f32表示动画播放速度。

NODE_TRANSLATE_TRANSITION

NODE_TRANSLATE_TRANSITION = 37

转场时的平移效果属性,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32表示横向平移距离值,单位为vp。默认值为0.0vp。
.value[1].f32表示纵向平移距离值,单位为vp。默认值为0.0vp。
.value[2].f32表示竖向平移距离值,单位为vp。默认值为0.0vp。
.value[3].i32表示动画时长,单位ms。
.value[4].i32表示动画曲线类型,取ArkUI_AnimationCurve枚举值。
.value[5]?.i32表示动画延迟时长,单位ms。
.value[6]?.i32表示动画播放次数。
.value[7]?.i32表示动画播放模式,取ArkUI_AnimationPlayMode枚举值。
.value[8]?.f32表示动画播放速度。

返回:

类型说明
.value[0].f32表示横向平移距离值,单位为vp。
.value[1].f32表示纵向平移距离值,单位为vp。
.value[2].f32表示竖向平移距离值,单位为vp。
.value[3].i32表示动画时长,单位ms。
.value[4].i32表示动画曲线类型,取ArkUI_AnimationCurve枚举值。
.value[5].i32表示动画延迟时长,单位ms。
.value[6].i32表示动画播放次数。
.value[7].i32表示动画播放模式,取ArkUI_AnimationPlayMode枚举值。
.value[8].f32表示动画播放速度。

NODE_MOVE_TRANSITION

NODE_MOVE_TRANSITION = 38

转场时从屏幕边缘滑入和滑出的效果属性,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32参数类型ArkUI_TransitionEdge
.value[1].i32表示动画时长,单位ms。
.value[2].i32表示动画曲线类型,取ArkUI_AnimationCurve枚举值。
.value[3]?.i32表示动画延迟时长,单位ms。
.value[4]?.i32表示动画播放次数。
.value[5]?.i32表示动画播放模式,取ArkUI_AnimationPlayMode枚举值。
.value[6]?.f32表示动画播放速度。

返回:

类型说明
.value[0].i32参数类型ArkUI_TransitionEdge
.value[1].i32表示动画时长,单位ms。
.value[2].i32表示动画曲线类型,取ArkUI_AnimationCurve枚举值。
.value[3].i32表示动画延迟时长,单位ms。
.value[4].i32表示动画播放次数。
.value[5].i32表示动画播放模式,取ArkUI_AnimationPlayMode枚举值。
.value[6].f32表示动画播放速度。

NODE_SWEEP_GRADIENT

NODE_SWEEP_GRADIENT = 43

角度渐变效果,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0]?.f32为角度渐变的中心点,即相对于当前组件左上角的坐标,X轴坐标。
.value[1]?.f32为角度渐变的中心点,即相对于当前组件左上角的坐标,Y轴坐标。
.value[2]?.f32角度渐变的起点,默认值0。
.value[3]?.f32角度渐变的终点,默认值0。
.value[4]?.f32角度渐变的旋转角度,默认值0。
.value[5]?.i32为渐变的颜色重复着色,0表示不重复着色,1表示重复着色。
.object参数类型为ArkUI_ColorStop。指定某百分比位置处的渐变色颜色,设置非法颜色直接跳过:
colors渐变色颜色。
stops渐变位置。
size颜色个数。

返回:

类型说明
.value[0].f32为角度渐变的中心点,即相对于当前组件左上角的坐标,X轴坐标。
.value[1].f32为角度渐变的中心点,即相对于当前组件左上角的坐标,Y轴坐标。
.value[2].f32角度渐变的起点,默认值0。
.value[3].f32角度渐变的终点,默认值0。
.value[4].f32角度渐变的旋转角度,默认值0。
.value[5].i32为渐变的颜色重复着色,0表示不重复着色,1表示重复着色。
.object参数类型为ArkUI_ColorStop。指定某百分比位置处的渐变色颜色,设置非法颜色直接跳过:
colors渐变色颜色。
stops渐变位置。
size颜色个数。

NODE_RADIAL_GRADIENT

NODE_RADIAL_GRADIENT = 44

径向渐变渐变效果,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0]?.f32为径向渐变的中心点,即相对于当前组件左上角的坐标,X轴坐标。
.value[1]?.f32为径向渐变的中心点,即相对于当前组件左上角的坐标,Y轴坐标。
.value[2]?.f32径向渐变的半径,默认值0。
.value[3]?.i32为渐变的颜色重复着色,0表示不重复着色,1表示重复着色。
.object参数类型为ArkUI_ColorStop。指定某百分比位置处的渐变色颜色,设置非法颜色直接跳过:
colors渐变色颜色。
stops渐变位置。
size颜色个数。

返回:

类型说明
.value[0].f32为径向渐变的中心点,即相对于当前组件左上角的坐标,X轴坐标。
.value[1].f32为径向渐变的中心点,即相对于当前组件左上角的坐标,Y轴坐标。
.value[2].f32径向渐变的半径,默认值0。
.value[3].i32为渐变的颜色重复着色,0表示不重复着色,1表示重复着色。
.object参数类型为ArkUI_ColorStop。指定某百分比位置处的渐变色颜色,设置非法颜色直接跳过:
colors渐变色颜色。
stops渐变位置。
size颜色个数。

NODE_MASK

NODE_MASK = 45

组件上加上指定形状的遮罩,支持属性设置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
1.rect类型.value[0].u32:填充颜色,0xargb类型;
.value[1].u32:描边颜色,0xargb类型;
.value[2].f32:描边宽度,单位为vp;
.value[3].i32:遮罩类型,参数类型ArkUI_MaskType,遮罩类型枚举值为ARKUI_MASK_TYPE_RECTANGLE;
.value[4].f32:矩形宽度,单位为vp;
.value[5].f32:矩形高度,单位为vp;
.value[6].f32:矩形圆角宽度,单位为vp;
.value[7].f32:矩形圆角高度,单位为vp;
.value[8]?.f32:矩形形状的左上圆角半径,单位为vp;
.value[9]?.f32:矩形形状的左下圆角半径,单位为vp;
.value[10]?.f32:矩形形状的右上圆角半径,单位为vp;
.value[11]?.f32:矩形形状的右下圆角半径,单位为vp。
2.circle类型.value[0].u32:填充颜色,0xargb类型;
.value[1].u32:描边颜色,0xargb类型;
.value[2].f32:描边宽度,单位为vp;
.value[3].i32:遮罩类型,参数类型ArkUI_MaskType,遮罩类型枚举值为ARKUI_MASK_TYPE_CIRCLE;
.value[4].f32:圆形宽度,单位为vp;
.value[5].f32:圆形高度,单位为vp。
3.ellipse类型.value[0].u32:填充颜色,0xargb类型;
.value[1].u32:描边颜色,0xargb类型;
.value[2].f32:描边宽度,单位为vp;
.value[3].i32:遮罩类型,参数类型ArkUI_MaskType,遮罩类型枚举值为ARKUI_MASK_TYPE_ELLIPSE;
.value[4].f32:椭圆形宽度,单位为vp;
.value[5].f32:椭圆形高度,单位为vp。
4.path类型.value[0].u32:填充颜色,0xargb类型;
.value[1].u32:描边颜色,0xargb类型;
.value[2].f32:描边宽度,单位为vp;
.value[3].i32:遮罩类型,参数类型ArkUI_MaskType,遮罩类型枚举值为ARKUI_MASK_TYPE_PATH;
.value[4].f32:路径宽度,单位为vp;
.value[5].f32:路径高度,单位为vp;
.string:路径绘制的命令字符串。
5.progress类型.value[0].i32:遮罩类型,参数类型ArkUI_MaskType,遮罩类型枚举值为ARKUI_MASK_TYPE_PROGRESS;
.value[1].f32:进度遮罩的当前值;
.value[2].f32:进度遮罩的最大值;
.value[3].u32:进度遮罩的颜色。

返回:

类型说明
1.rect类型.value[0].u32:填充颜色,0xargb类型;
.value[1].u32:描边颜色,0xargb类型;
.value[2].f32:描边宽度,单位为vp;
.value[3].i32:遮罩类型;
.value[4].f32:矩形宽度,单位为vp;
.value[5].f32:矩形高度,单位为vp;
.value[6].f32:矩形圆角宽度,单位为vp;
.value[7].f32:矩形圆角高度,单位为vp;
.value[8]?.f32:矩形形状的左上圆角半径,单位为vp;
.value[9]?.f32:矩形形状的左下圆角半径,单位为vp;
.value[10]?.f32:矩形形状的右上圆角半径,单位为vp;
.value[11]?.f32:矩形形状的右下圆角半径,单位为vp。
2.circle类型.value[0].u32:填充颜色,0xargb类型;
.value[1].u32:描边颜色,0xargb类型;
.value[2].f32:描边宽度,单位为vp;
.value[3].i32:遮罩类型;
.value[4].f32:圆形宽度,单位为vp;
.value[5].f32:圆形高度,单位为vp。
3.ellipse类型.value[0].u32:填充颜色,0xargb类型;
.value[1].u32:描边颜色,0xargb类型;
.value[2].f32:描边宽度,单位为vp;
.value[3].i32:遮罩类型;
.value[4].f32:椭圆形宽度,单位为vp;
.value[5].f32:椭圆形高度,单位为vp。
4.path类型.value[0].u32:填充颜色,0xargb类型;
.value[1].u32:描边颜色,0xargb类型;
.value[2].f32:描边宽度,单位为vp;
.value[3].i32:遮罩类型;
.value[4].f32:路径宽度,单位为vp;
.value[5].f32:路径高度,单位为vp;
.string:路径绘制的命令字符串。
5.progress类型.value[0].i32:遮罩类型;
.value[1].f32:进度遮罩的当前值;
.value[2].f32:进度遮罩的最大值;
.value[3].u32:进度遮罩的颜色。

NODE_BLEND_MODE

NODE_BLEND_MODE = 46

当前控件背景与子节点内容进行混合,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32控制当前组件的混合模式类型,参数类型ArkUI_BlendMode,默认值为ARKUI_BLEND_MODE_NONE。
.value[1]?.i32blendMode实现方式是否离屏,参数类型ArkUI_BlendApplyType,默认值为BLEND_APPLY_TYPE_FAST。

返回:

类型说明
.value[0].i32控制当前组件的混合模式类型,参数类型ArkUI_BlendMode,默认值为ARKUI_BLEND_MODE_NONE。
.value[1].i32blendMode实现方式是否离屏,参数类型ArkUI_BlendApplyType,默认值为BLEND_APPLY_TYPE_FAST。

NODE_GRAY_SCALE

NODE_GRAY_SCALE = 49

灰度效果属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32灰度转换比例,范围0-1之间,默认值为0,比如0.5指按照50%进行灰度处理。

返回:

类型说明
.value[0].f32灰度转换比例,范围0-1之间。

NODE_INVERT

NODE_INVERT = 50

反转输入的图像比例属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32图像反转比例,范围0-1之间,默认值为0,比如0.5指按照50%进行反转处理。

返回:

类型说明
.value[0].f32图像反转比例,范围0-1之间。

NODE_SEPIA

NODE_SEPIA = 51

图像转换为深褐色比例属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32图像转换为深褐色比例,范围0-1之间,默认值为0,比如0.5指按照50%进行深褐色处理。

返回:

类型说明
.value[0].f32图像转换为深褐色比例,范围0-1之间。

NODE_CONTRAST

NODE_CONTRAST = 52

对比度属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32对比度,等于1时为原图,越大则对比度越高,默认值为1,取值范围:[0, 10)。

返回:

类型说明
.value[0].f32对比度,取值范围:[0, 10)。

NODE_FOREGROUND_COLOR

NODE_FOREGROUND_COLOR = 53

前景颜色属性,支持属性设置和属性获取接口。属性重置接口无效果。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].u32颜色数值,0xargb类型,如0xFFFF0000表示红色,默认值为0xFF000000。
.value[0].i32颜色数值枚举ArkUI_ColoringStrategy。

返回:

类型说明
.value[0].u32颜色数值,0xargb类型。

NODE_OUTLINE_WIDTH

NODE_OUTLINE_WIDTH = 70

设置元素的外描边宽度,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32左侧外描边宽度,单位为vp。
.value[1].f32上侧外描边宽度,单位为vp。
.value[2].f32右侧外描边宽度,单位为vp。
.value[3].f32下侧外描边宽度,单位为vp。

返回:

类型说明
.value[0].f32左侧外描边宽度,单位为vp。
.value[1].f32上侧外描边宽度,单位为vp。
.value[2].f32右侧外描边宽度,单位为vp。
.value[3].f32下侧外描边宽度,单位为vp。

NODE_GEOMETRY_TRANSITION

NODE_GEOMETRY_TRANSITION = 75

组件内隐式共享元素转场,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0]?.i32参数类型为1或者0。共享元素绑定的2个组件,针对出场元素未进行删除时是否要继续参与共享元素动画,默认为false,不参与保持原始位置不动。
.string用于设置绑定关系,id置""清除绑定关系避免参与共享行为,id可更换重新建立绑定关系。同一个id只能有两个组件绑定且是in/out不同类型角色,不能多个组件绑定同一个id。

返回:

类型说明
.value[0].i32参数类型为1或者0。共享元素绑定的2个组件,针对出场元素未进行删除时是否要继续参与共享元素动画,默认未false,不参与保持原始位置不动。
.string用于设置绑定关系,id置""清除绑定关系避免参与共享行为,id可更换重新建立绑定关系。同一个id只能有两个组件绑定且是in/out不同类型角色,不能多个组件绑定同一个id。

NODE_RENDER_FIT

NODE_RENDER_FIT = 77

设置宽高动画过程中的组件内容填充方式,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32内容填充方式,使用ArkUI_RenderFit枚举值。

返回:

类型说明
.value[0].i32内容填充方式,使用ArkUI_RenderFit枚举值。

NODE_OUTLINE_COLOR

NODE_OUTLINE_COLOR = 78

外描边颜色属性,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].u32统一设置四条边的边框颜色,使用0xargb表示,如0xFFFF11FF。
.value[0].u32设置上侧边框颜色,使用0xargb表示,如0xFFFF11FF。
.value[1].u32设置右侧边框颜色,使用0xargb表示,如0xFFFF11FF。
.value[2].u32设置下侧边框颜色,使用0xargb表示,如0xFFFF11FF。
.value[3].u32设置左侧边框颜色,使用0xargb表示,如0xFFFF11FF。

返回:

类型说明
.value[0].u32设置上侧边框颜色,使用0xargb表示,如0xFFFF11FF。
.value[1].u32设置右侧边框颜色,使用0xargb表示,如0xFFFF11FF。
.value[2].u32设置下侧边框颜色,使用0xargb表示,如0xFFFF11FF。
.value[3].u32设置左侧边框颜色,使用0xargb表示,如0xFFFF11FF。

NODE_COLOR_BLEND

NODE_COLOR_BLEND = 81

为组件添加颜色叠加效果,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].u32叠加的颜色,使用0xargb表示,默认值为0x00000000。

返回:

类型说明
.value[0].u32叠加的颜色,使用0xargb表示,如0xFFFF11FF。

NODE_FOREGROUND_BLUR_STYLE

NODE_FOREGROUND_BLUR_STYLE = 82

为当前组件提供内容模糊能力,支持属性设置,属性重置,属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32表示内容模糊样式,取ArkUI_BlurStyle枚举值。
.value[1]?.i32表示内容模糊效果使用的深浅色模式,取ArkUI_ColorMode枚举值。
.value[2]?.i32表示内容模糊效果使用的取色模式,取ArkUI_AdaptiveColor枚举值。
.value[3]?.f32表示模糊效果程度,取[0.0,1.0]范围内的值。
.value[4]?.i32表示灰阶模糊参数,对黑色的提亮程度,取值范围为[0,127]。
.value[5]?.i32表示灰阶模糊参数,对白色的压暗程度,取值范围为[0,127]。

返回:

类型说明
.value[0].i32表示内容模糊样式,取ArkUI_BlurStyle枚举值。
.value[1].i32表示内容模糊效果使用的深浅色模式,取ArkUI_ColorMode枚举值。
.value[2].i32表示内容模糊效果使用的取色模式,取ArkUI_AdaptiveColor枚举值。
.value[3].f32表示模糊效果程度,取[0.0,1.0]范围内的值。
.value[4].i32表示灰阶模糊参数,对黑色的提亮程度,取值范围为[0,127]。
.value[5].i32表示灰阶模糊参数,对白色的压暗程度,取值范围为[0,127]。

NODE_TRANSITION

NODE_TRANSITION = 94

定义组件插入和删除时显示过渡动效,支持属性设置,属性获取。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.object参数类型为ArkUI_TransitionEffect

返回:

类型说明
.object参数类型为ArkUI_TransitionEffect

NODE_BACKDROP_BLUR

NODE_BACKDROP_BLUR = 99

设置背景模糊效果,支持属性设置,属性重置和属性获取。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 15

参数:

参数项描述
.value[0].f32表示背景模糊半径,取值范围[0,+∞)。单位px,默认值0.0。
.value[1]?.f32表示灰阶模糊参数,对黑色的提亮程度,取值范围为[0,127]。
.value[2]?.f32表示灰阶模糊参数,对白色的压暗程度,取值范围为[0,127]。

返回:

类型说明
.value[0].f32表示背景模糊半径,取值范围[0,+∞)。单位px。
.value[1].f32表示灰阶模糊参数,对黑色的提亮程度,取值范围为[0,127]。
.value[2].f32表示灰阶模糊参数,对白色的压暗程度,取值范围为[0,127]。

NODE_BACKGROUND_IMAGE_RESIZABLE_WITH_SLICE

NODE_BACKGROUND_IMAGE_RESIZABLE_WITH_SLICE = 100

设置背景图在拉伸时可调整大小的属性,支持属性设置,属性重置和属性获取。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 19

参数:

参数项描述
.value[0].f32图片左部拉伸时,图片的像素值保持不变,单位为vp。
.value[1].f32图片顶部拉伸时,图片的像素值保持不变,单位为vp。
.value[2].f32图片右部拉伸时,图片的像素值保持不变,单位为vp。
.value[3].f32图片底部拉伸时,图片的像素值保持不变,单位为vp。

返回:

类型说明
.value[0].f32图片左部拉伸时,图片的像素值保持不变,单位为vp。
.value[1].f32图片顶部拉伸时,图片的像素值保持不变,单位为vp。
.value[2].f32图片右部拉伸时,图片的像素值保持不变,单位为vp。
.value[3].f32图片底部拉伸时,图片的像素值保持不变,单位为vp。

NODE_TRANSLATE_WITH_PERCENT

NODE_TRANSLATE_WITH_PERCENT = 103

设置组件平移,支持百分比形式的平移入参,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 20

参数:

参数项描述
.value[0].f32x轴移动距离,默认单位为百分比,除非value[3]存在且value[3]为0时单位为vp,默认值0。
.value[1].f32y轴移动距离,默认单位为百分比,除非value[4]存在且value[4]为0时单位为vp,默认值0。
.value[2].f32z轴移动距离,单位vp,默认值0。
.value[3]?.i32x轴移动距离是否为百分比形式指定,取值范围:0或1。为1时表示以百分比形式指定,例如value[0].f32=0.1且value[3].i32=1时表示x方向平移10%。默认值1。
.value[4]?.i32y轴移动距离是否为百分比形式指定,取值范围:0或1。为1时表示以百分比形式指定,例如value[1].f32=0.1且value[4].i32=1时表示y方向平移10%,默认值1。

返回:

类型说明
.value[0].f32x轴移动距离,单位取决于value[3]。
.value[1].f32y轴移动距离,单位取决于value[4]。
.value[2].f32z轴移动距离,单位vp。
.value[3].i32x轴移动距离的单位是否为百分比,当value[3].i32为0时x轴移动距离单位为vp,当value[3].i32为1时x轴移动距离单位为百分比。
.value[4].i32y轴移动距离的单位是否为百分比,当value[4].i32为0时y轴移动距离单位为vp,当value[4].i32为1时y轴移动距离单位为百分比。

NODE_ROTATE_ANGLE

NODE_ROTATE_ANGLE = 104

设置组件旋转,支持各轴旋转角属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 20

参数:

参数项描述
.value[0].f32x轴方向旋转角度,默认值0。
.value[1].f32y轴方向旋转角度,默认值0。
.value[2].f32z轴方向旋转角度,默认值0。
.value[3].f32视距,即视点到z=0平面的距离,单位px,默认值0。

返回:

类型说明
.value[0].f32x轴方向旋转角度,默认值0。
.value[1].f32y轴方向旋转角度,默认值0。
.value[2].f32z轴方向旋转角度,默认值0。
.value[3].f32视距,即视点到z=0平面的距离,单位px,默认值0。

NODE_PIXEL_ROUND

NODE_PIXEL_ROUND = 109

设置组件的像素取整策略,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 21

参数:

参数项描述
.object组件的像素取整策略;参数类型为ArkUI_PixelRoundPolicy

返回:

类型说明
.object组件的像素取整策略;参数类型为ArkUI_PixelRoundPolicy

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 arkts-apis-uicontext-contextmenucontroller

openharmony 鸿蒙 errorcode-canvas

openharmony 鸿蒙 capi-oh-nativexcomponent-native-xcomponent-oh-nativexcomponent

openharmony 鸿蒙 errorcode-bindSheet

openharmony 鸿蒙 js-apis-arkui-uiExtension-sys

openharmony 鸿蒙 capi-arkui-accessibility-arkui-accessibilityeventinfo

openharmony 鸿蒙 capi-arkui-rendernodeutils

openharmony 鸿蒙 capi-native-node-h-nodeattributetype-layoutcomponent

openharmony 鸿蒙 js-apis-arkui-node

openharmony 鸿蒙 capi-native-node-h

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/zUCor024