1# native_render.h 2<!--Kit: ArkUI--> 3<!--Subsystem: ArkUI--> 4<!--Owner: @xiang-shouxing--> 5<!--Designer: @xiang-shouxing--> 6<!--Tester: @sally__--> 7<!--Adviser: @HelloCrease--> 8 9## 概述 10 11提供NativeRender接口的类型定义。 12 13**引用文件：** <arkui/native_render.h> 14 15**库：** libace_ndk.z.so 16 17**系统能力：** SystemCapability.ArkUI.ArkUI.Full 18 19**起始版本：** 20 20 21**相关模块：** [ArkUI_NativeModule](capi-arkui-nativemodule.md) 22 23## 汇总 24 25### 结构体 26 27| 名称 | typedef关键字 | 描述 | 28|-----------------------------------------------------------------------------------------------|----------------------------------|-------------------| 29| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) | ArkUI_RenderNodeHandle | 渲染节点指针。 | 30| [ArkUI_RenderContentModifierHandle](./capi-arkui-nativemodule-arkui-rendercontentmodifierhandle.md) | ArkUI_RenderContentModifierHandle | 内容修改器指针。 | 31| [ArkUI_FloatPropertyHandle](./capi-arkui-nativemodule-arkui-floatpropertyhandle.md) | ArkUI_FloatPropertyHandle | 浮点数属性指针。 | 32| [ArkUI_Vector2PropertyHandle](./capi-arkui-nativemodule-arkui-vector2propertyhandle.md) | ArkUI_Vector2PropertyHandle | 二维向量属性指针。 | 33| [ArkUI_ColorPropertyHandle](./capi-arkui-nativemodule-arkui-colorpropertyhandle.md) | ArkUI_ColorPropertyHandle | 颜色属性指针。 | 34| [ArkUI_FloatAnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-floatanimatablepropertyhandle.md) | ArkUI_FloatAnimatablePropertyHandle | 可动画的浮点数属性指针。 | 35| [ArkUI_Vector2AnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-vector2animatablepropertyhandle.md) | ArkUI_Vector2AnimatablePropertyHandle | 可动画的二维向量属性指针。 | 36| [ArkUI_ColorAnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-coloranimatablepropertyhandle.md) | ArkUI_ColorAnimatablePropertyHandle | 可动画的颜色属性指针。 | 37| [ArkUI_RectShapeOption](./capi-arkui-nativemodule-arkui-rectshapeoption.md) | ArkUI_RectShapeOption | 范围形状结构体。 | 38| [ArkUI_NodeBorderStyleOption](./capi-arkui-nativemodule-arkui-nodeborderstyleoption.md) | ArkUI_NodeBorderStyleOption | 边框样式配置项。 | 39| [ArkUI_NodeBorderWidthOption](./capi-arkui-nativemodule-arkui-nodeborderwidthoption.md) | ArkUI_NodeBorderWidthOption | 边框宽度配置项。 | 40| [ArkUI_NodeBorderColorOption](./capi-arkui-nativemodule-arkui-nodebordercoloroption.md) | ArkUI_NodeBorderColorOption | 边框颜色配置项。 | 41| [ArkUI_NodeBorderRadiusOption](./capi-arkui-nativemodule-arkui-nodeborderradiusoption.md) | ArkUI_NodeBorderRadiusOption | 边框弧度配置项。 | 42| [ArkUI_CircleShapeOption](./capi-arkui-nativemodule-arkui-circleshapeoption.md) | ArkUI_CircleShapeOption | 圆形形状配置项。 | 43| [ArkUI_RoundRectShapeOption](./capi-arkui-nativemodule-arkui-roundrectshapeoption.md) | ArkUI_RoundRectShapeOption | 圆角矩形形状配置项。 | 44| [ArkUI_CommandPathOption](./capi-arkui-nativemodule-arkui-commandpathoption.md) | ArkUI_CommandPathOption | 自定义路径配置项。 | 45| [ArkUI_RenderNodeMaskOption](./capi-arkui-nativemodule-arkui-rendernodemaskoption.md) | ArkUI_RenderNodeMaskOption | 节点遮罩配置项。 | 46| [ArkUI_RenderNodeClipOption](./capi-arkui-nativemodule-arkui-rendernodeclipoption.md) | ArkUI_RenderNodeClipOption | 节点裁剪配置项。 | 47 48### 函数 49 50| 名称 | typedef关键字 | 描述 | 51| -- | -- | -- | 52| [int32_t OH_ArkUI_RenderNodeUtils_AddRenderNode(ArkUI_NodeHandle node, ArkUI_RenderNodeHandle child)](#oh_arkui_rendernodeutils_addrendernode) | - | 向父自定义节点添加子渲染节点。| 53| [int32_t OH_ArkUI_RenderNodeUtils_RemoveRenderNode(ArkUI_NodeHandle node, ArkUI_RenderNodeHandle child)](#oh_arkui_rendernodeutils_removerendernode) | - | 移除指定节点的所有子渲染节点。| 54| [int32_t OH_ArkUI_RenderNodeUtils_ClearRenderNodeChildren(ArkUI_NodeHandle node)](#oh_arkui_rendernodeutils_clearrendernodechildren) | - | 清除父节点内的子渲染节点。| 55| [int32_t OH_ArkUI_RenderNodeUtils_Invalidate(ArkUI_NodeHandle node)](#oh_arkui_rendernodeutils_invalidate) | - | 标脏目标自定义节点，使其子渲染节点重新渲染。| 56| [ArkUI_RenderNodeHandle OH_ArkUI_RenderNodeUtils_CreateNode()](#oh_arkui_rendernodeutils_createnode) | - | 创建渲染节点。| 57| [int32_t OH_ArkUI_RenderNodeUtils_DisposeNode(ArkUI_RenderNodeHandle node)](#oh_arkui_rendernodeutils_disposenode) | - | 销毁渲染节点。| 58| [int32_t OH_ArkUI_RenderNodeUtils_AddChild(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle child)](#oh_arkui_rendernodeutils_addchild) | - | 向目标父渲染节点上添加子节点。| 59| [int32_t OH_ArkUI_RenderNodeUtils_InsertChildAfter(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle child, ArkUI_RenderNodeHandle sibling)](#oh_arkui_rendernodeutils_insertchildafter) | - | 向父节点的目标子节点后添加子节点。| 60| [int32_t OH_ArkUI_RenderNodeUtils_RemoveChild(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle child)](#oh_arkui_rendernodeutils_removechild) | - | 从指定渲染节点中移除子节点。| 61| [int32_t OH_ArkUI_RenderNodeUtils_ClearChildren(ArkUI_RenderNodeHandle node)](#oh_arkui_rendernodeutils_clearchildren) | - | 清空指定渲染节点的所有子节点。| 62| [int32_t OH_ArkUI_RenderNodeUtils_GetChild(ArkUI_RenderNodeHandle node, int32_t index, ArkUI_RenderNodeHandle* child)](#oh_arkui_rendernodeutils_getchild) | - | 获取指定索引位置的子节点。| 63| [int32_t OH_ArkUI_RenderNodeUtils_GetFirstChild(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle* child)](#oh_arkui_rendernodeutils_getfirstchild) | - | 获取指定渲染节点的第一个子节点。| 64| [int32_t OH_ArkUI_RenderNodeUtils_GetNextSibling(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle* sibling)](#oh_arkui_rendernodeutils_getnextsibling) | - | 获取指定节点的下一个子节点。| 65| [int32_t OH_ArkUI_RenderNodeUtils_GetPreviousSibling(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle* sibling)](#oh_arkui_rendernodeutils_getprevioussibling) | - | 获取指定节点的上一个子节点。| 66| [int32_t OH_ArkUI_RenderNodeUtils_GetChildren(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle** children, int32_t* count)](#oh_arkui_rendernodeutils_getchildren) | - | 获取父渲染节点的所有子渲染节点。| 67| [int32_t OH_ArkUI_RenderNodeUtils_GetChildrenCount(ArkUI_RenderNodeHandle node, int32_t* count)](#oh_arkui_rendernodeutils_getchildrencount) | - | 获取指定渲染节点的子渲染节点数量。| 68| [int32_t OH_ArkUI_RenderNodeUtils_SetBackgroundColor(ArkUI_RenderNodeHandle node, uint32_t color)](#oh_arkui_rendernodeutils_setbackgroundcolor) | - | 为渲染节点设置背景颜色。| 69| [int32_t OH_ArkUI_RenderNodeUtils_GetBackgroundColor(ArkUI_RenderNodeHandle node, uint32_t* color)](#oh_arkui_rendernodeutils_getbackgroundcolor) | - | 获取渲染节点的背景颜色。| 70| [int32_t OH_ArkUI_RenderNodeUtils_SetClipToFrame(ArkUI_RenderNodeHandle node, int32_t clipToFrame)](#oh_arkui_rendernodeutils_setcliptoframe) | - | 设置是否对当前渲染节点裁剪。| 71| [int32_t OH_ArkUI_RenderNodeUtils_GetClipToFrame(ArkUI_RenderNodeHandle node, int32_t* clipToFrame)](#oh_arkui_rendernodeutils_getcliptoframe) | - | 获取是否对当前渲染节点裁剪。| 72| [int32_t OH_ArkUI_RenderNodeUtils_SetClipToBounds(ArkUI_RenderNodeHandle node, int32_t clipToBounds)](#oh_arkui_rendernodeutils_setcliptobounds) | - | 设置是否对当前渲染节点边界裁剪。| 73| [int32_t OH_ArkUI_RenderNodeUtils_GetClipToBounds(ArkUI_RenderNodeHandle node, int32_t* clipToBounds)](#oh_arkui_rendernodeutils_getcliptobounds) | - | 获取是否对当前渲染节点边界裁剪。| 74| [int32_t OH_ArkUI_RenderNodeUtils_SetOpacity(ArkUI_RenderNodeHandle node, float opacity)](#oh_arkui_rendernodeutils_setopacity) | - | 为渲染节点设置不透明度值。| 75| [int32_t OH_ArkUI_RenderNodeUtils_GetOpacity(ArkUI_RenderNodeHandle node, float* opacity)](#oh_arkui_rendernodeutils_getopacity) | - | 获取渲染节点的不透明度值。| 76| [int32_t OH_ArkUI_RenderNodeUtils_SetSize(ArkUI_RenderNodeHandle node, int32_t width, int32_t height)](#oh_arkui_rendernodeutils_setsize) | - | 为渲染节点设置尺寸。| 77| [int32_t OH_ArkUI_RenderNodeUtils_GetSize(ArkUI_RenderNodeHandle node, int32_t* width, int32_t* height)](#oh_arkui_rendernodeutils_getsize) | - | 获取渲染节点的尺寸。| 78| [int32_t OH_ArkUI_RenderNodeUtils_SetPosition(ArkUI_RenderNodeHandle node, int32_t x, int32_t y)](#oh_arkui_rendernodeutils_setposition) | - | 为渲染节点设置位置坐标。| 79| [int32_t OH_ArkUI_RenderNodeUtils_GetPosition(ArkUI_RenderNodeHandle node, int32_t* x, int32_t* y)](#oh_arkui_rendernodeutils_getposition) | - | 获取渲染节点的位置坐标。| 80| [int32_t OH_ArkUI_RenderNodeUtils_SetPivot(ArkUI_RenderNodeHandle node, float x, float y)](#oh_arkui_rendernodeutils_setpivot) | - | 为渲染节点的变换设置中心点。| 81| [int32_t OH_ArkUI_RenderNodeUtils_GetPivot(ArkUI_RenderNodeHandle node, float* x, float* y)](#oh_arkui_rendernodeutils_getpivot) | - | 获取渲染节点的中心点坐标。| 82| [int32_t OH_ArkUI_RenderNodeUtils_SetScale(ArkUI_RenderNodeHandle node, float x, float y)](#oh_arkui_rendernodeutils_setscale) | - | 为渲染节点设置缩放因子。| 83| [int32_t OH_ArkUI_RenderNodeUtils_GetScale(ArkUI_RenderNodeHandle node, float* x, float* y)](#oh_arkui_rendernodeutils_getscale) | - | 获取渲染节点的缩放因子。| 84| [int32_t OH_ArkUI_RenderNodeUtils_SetTranslation(ArkUI_RenderNodeHandle node, float x, float y)](#oh_arkui_rendernodeutils_settranslation) | - | 为渲染节点设置平移偏移量。| 85| [int32_t OH_ArkUI_RenderNodeUtils_GetTranslation(ArkUI_RenderNodeHandle node, float* x, float* y)](#oh_arkui_rendernodeutils_gettranslation) | - | 获取渲染节点的平移偏移量。| 86| [int32_t OH_ArkUI_RenderNodeUtils_SetRotation(ArkUI_RenderNodeHandle node, float x, float y, float z)](#oh_arkui_rendernodeutils_setrotation) | - | 为渲染节点设置旋转角度。| 87| [int32_t OH_ArkUI_RenderNodeUtils_GetRotation(ArkUI_RenderNodeHandle node, float* x, float* y, float* z)](#oh_arkui_rendernodeutils_getrotation) | - | 获取渲染节点的旋转角度。| 88| [int32_t OH_ArkUI_RenderNodeUtils_SetTransform(ArkUI_RenderNodeHandle node, float* matrix)](#oh_arkui_rendernodeutils_settransform) | - | 为渲染节点设置变换矩阵。| 89| [int32_t OH_ArkUI_RenderNodeUtils_SetShadowColor(ArkUI_RenderNodeHandle node, uint32_t color)](#oh_arkui_rendernodeutils_setshadowcolor) | - | 为渲染节点设置阴影颜色。| 90| [int32_t OH_ArkUI_RenderNodeUtils_GetShadowColor(ArkUI_RenderNodeHandle node, uint32_t* color)](#oh_arkui_rendernodeutils_getshadowcolor) | - | 获取渲染节点的阴影颜色。| 91| [int32_t OH_ArkUI_RenderNodeUtils_SetShadowOffset(ArkUI_RenderNodeHandle node, int32_t x, int32_t y)](#oh_arkui_rendernodeutils_setshadowoffset) | - | 为渲染节点设置阴影偏移量。| 92| [int32_t OH_ArkUI_RenderNodeUtils_GetShadowOffset(ArkUI_RenderNodeHandle node, int32_t* x, int32_t* y)](#oh_arkui_rendernodeutils_getshadowoffset) | - | 获取渲染节点的阴影偏移量。| 93| [int32_t OH_ArkUI_RenderNodeUtils_SetShadowAlpha(ArkUI_RenderNodeHandle node, float alpha)](#oh_arkui_rendernodeutils_setshadowalpha) | - | 为渲染节点设置阴影透明度。| 94| [int32_t OH_ArkUI_RenderNodeUtils_GetShadowAlpha(ArkUI_RenderNodeHandle node, float* alpha)](#oh_arkui_rendernodeutils_getshadowalpha) | - | 获取渲染节点的阴影透明度。| 95| [int32_t OH_ArkUI_RenderNodeUtils_SetShadowElevation(ArkUI_RenderNodeHandle node, float elevation)](#oh_arkui_rendernodeutils_setshadowelevation) | - | 为渲染节点设置阴影高度。| 96| [int32_t OH_ArkUI_RenderNodeUtils_GetShadowElevation(ArkUI_RenderNodeHandle node, float* elevation)](#oh_arkui_rendernodeutils_getshadowelevation) | - | 获取渲染节点的阴影高度。| 97| [int32_t OH_ArkUI_RenderNodeUtils_SetShadowRadius(ArkUI_RenderNodeHandle node, float radius)](#oh_arkui_rendernodeutils_setshadowradius) | - | 为渲染节点设置阴影半径。| 98| [int32_t OH_ArkUI_RenderNodeUtils_GetShadowRadius(ArkUI_RenderNodeHandle node, float* radius)](#oh_arkui_rendernodeutils_getshadowradius) | - | 获取渲染节点的阴影半径。| 99| [int32_t OH_ArkUI_RenderNodeUtils_SetBorderStyle(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderStyleOption* borderStyle)](#oh_arkui_rendernodeutils_setborderstyle) | - | 为渲染节点设置边框样式。| 100| [int32_t OH_ArkUI_RenderNodeUtils_GetBorderStyle(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderStyleOption** borderStyle)](#oh_arkui_rendernodeutils_getborderstyle) | - | 获取渲染节点的边框样式。| 101| [int32_t OH_ArkUI_RenderNodeUtils_SetBorderWidth(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderWidthOption* borderWidth)](#oh_arkui_rendernodeutils_setborderwidth) | - | 为渲染节点设置边框宽度。| 102| [int32_t OH_ArkUI_RenderNodeUtils_GetBorderWidth(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderWidthOption** borderWidth)](#oh_arkui_rendernodeutils_getborderwidth) | - | 获取渲染节点的边框宽度。| 103| [int32_t OH_ArkUI_RenderNodeUtils_SetBorderColor(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderColorOption* borderColor)](#oh_arkui_rendernodeutils_setbordercolor) | - | 为渲染节点设置边框颜色。| 104| [int32_t OH_ArkUI_RenderNodeUtils_GetBorderColor(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderColorOption** borderColor)](#oh_arkui_rendernodeutils_getbordercolor) | - | 获取渲染节点的边框颜色。| 105| [int32_t OH_ArkUI_RenderNodeUtils_SetBorderRadius(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderRadiusOption* borderRadius)](#oh_arkui_rendernodeutils_setborderradius) | - | 为渲染节点设置边框角半径。| 106| [int32_t OH_ArkUI_RenderNodeUtils_GetBorderRadius(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderRadiusOption** borderRadius)](#oh_arkui_rendernodeutils_getborderradius) | - | 获取渲染节点的边框角半径。| 107| [int32_t OH_ArkUI_RenderNodeUtils_SetMask(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeMaskOption* mask)](#oh_arkui_rendernodeutils_setmask) | - | 使用遮罩配置为渲染节点应用遮罩。| 108| [int32_t OH_ArkUI_RenderNodeUtils_SetClip(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeClipOption* clip)](#oh_arkui_rendernodeutils_setclip) | - | 使用裁剪配置为渲染节点应用裁剪。| 109| [int32_t OH_ArkUI_RenderNodeUtils_SetMarkNodeGroup(ArkUI_RenderNodeHandle node, bool markNodeGroup)](#oh_arkui_rendernodeutils_setmarknodegroup) | - | 标记是否优先绘制该节点及其子节点。| 110| [int32_t OH_ArkUI_RenderNodeUtils_SetBounds(ArkUI_RenderNodeHandle node, int32_t x, int32_t y, int32_t width, int32_t height)](#oh_arkui_rendernodeutils_setbounds) | - | 为渲染节点设置边界。| 111| [int32_t OH_ArkUI_RenderNodeUtils_GetBounds(ArkUI_RenderNodeHandle node, int32_t* x, int32_t* y, int32_t* width, int32_t* height)](#oh_arkui_rendernodeutils_getbounds) | - | 获取渲染节点的边界。| 112| [int32_t OH_ArkUI_RenderNodeUtils_SetDrawRegion(ArkUI_RenderNodeHandle node, float x, float y, float w, float h)](#oh_arkui_rendernodeutils_setdrawregion) | - | 为渲染节点设置绘制区域。| 113| [int32_t OH_ArkUI_RenderNodeUtils_AttachContentModifier(ArkUI_RenderNodeHandle node, ArkUI_RenderContentModifierHandle modifier)](#oh_arkui_rendernodeutils_attachcontentmodifier) | - | 为渲染节点添加内容修改器。| 114| [ArkUI_RenderContentModifierHandle OH_ArkUI_RenderNodeUtils_CreateContentModifier()](#oh_arkui_rendernodeutils_createcontentmodifier) | - | 创建内容修改器。| 115| [void OH_ArkUI_RenderNodeUtils_DisposeContentModifier(ArkUI_RenderContentModifierHandle modifier)](#oh_arkui_rendernodeutils_disposecontentmodifier) | - | 释放内容修改器。| 116| [int32_t OH_ArkUI_RenderNodeUtils_AttachFloatProperty(ArkUI_RenderContentModifierHandle modifier, ArkUI_FloatPropertyHandle property)](#oh_arkui_rendernodeutils_attachfloatproperty) | - | 为目标内容修改器附加浮点属性。| 117| [int32_t OH_ArkUI_RenderNodeUtils_AttachVector2Property(ArkUI_RenderContentModifierHandle modifier, ArkUI_Vector2PropertyHandle property)](#oh_arkui_rendernodeutils_attachvector2property) | - | 为目标内容修改器附加二维向量属性。| 118| [int32_t OH_ArkUI_RenderNodeUtils_AttachColorProperty(ArkUI_RenderContentModifierHandle modifier, ArkUI_ColorPropertyHandle property)](#oh_arkui_rendernodeutils_attachcolorproperty) | - | 为目标内容修改器附加颜色属性。| 119| [int32_t OH_ArkUI_RenderNodeUtils_AttachFloatAnimatableProperty(ArkUI_RenderContentModifierHandle modifier, ArkUI_FloatAnimatablePropertyHandle property)](#oh_arkui_rendernodeutils_attachfloatanimatableproperty) | - | 为目标内容修改器附加可动画的浮点属性。| 120| [int32_t OH_ArkUI_RenderNodeUtils_AttachVector2AnimatableProperty(ArkUI_RenderContentModifierHandle modifier, ArkUI_Vector2AnimatablePropertyHandle property)](#oh_arkui_rendernodeutils_attachvector2animatableproperty) | - | 为目标内容修改器附加可动画的二维向量属性。| 121| [int32_t OH_ArkUI_RenderNodeUtils_AttachColorAnimatableProperty(ArkUI_RenderContentModifierHandle modifier, ArkUI_ColorAnimatablePropertyHandle property)](#oh_arkui_rendernodeutils_attachcoloranimatableproperty) | - | 为目标内容修改器附加可动画的颜色属性。| 122| [ArkUI_FloatPropertyHandle OH_ArkUI_RenderNodeUtils_CreateFloatProperty(float value)](#oh_arkui_rendernodeutils_createfloatproperty) | - | 创建浮点属性。| 123| [int32_t OH_ArkUI_RenderNodeUtils_SetFloatPropertyValue(ArkUI_FloatPropertyHandle property, float value)](#oh_arkui_rendernodeutils_setfloatpropertyvalue) | - | 设置浮点属性的值。| 124| [int32_t OH_ArkUI_RenderNodeUtils_GetFloatPropertyValue(ArkUI_FloatPropertyHandle property, float* value)](#oh_arkui_rendernodeutils_getfloatpropertyvalue) | - | 获取浮点属性的值。| 125| [void OH_ArkUI_RenderNodeUtils_DisposeFloatProperty(ArkUI_FloatPropertyHandle property)](#oh_arkui_rendernodeutils_disposefloatproperty) | - | 释放浮点属性。| 126| [ArkUI_Vector2PropertyHandle OH_ArkUI_RenderNodeUtils_CreateVector2Property(float x, float y)](#oh_arkui_rendernodeutils_createvector2property) | - | 创建二维向量属性。| 127| [int32_t OH_ArkUI_RenderNodeUtils_SetVector2PropertyValue(ArkUI_Vector2PropertyHandle property, float x, float y)](#oh_arkui_rendernodeutils_setvector2propertyvalue) | - | 设置二维向量属性的值。| 128| [int32_t OH_ArkUI_RenderNodeUtils_GetVector2PropertyValue(ArkUI_Vector2PropertyHandle property, float* x, float* y)](#oh_arkui_rendernodeutils_getvector2propertyvalue) | - | 获取二维向量属性的值。| 129| [void OH_ArkUI_RenderNodeUtils_DisposeVector2Property(ArkUI_Vector2PropertyHandle property)](#oh_arkui_rendernodeutils_disposevector2property) | - | 释放二维向量属性。| 130| [ArkUI_ColorPropertyHandle OH_ArkUI_RenderNodeUtils_CreateColorProperty(uint32_t value)](#oh_arkui_rendernodeutils_createcolorproperty) | - | 创建颜色属性。| 131| [int32_t OH_ArkUI_RenderNodeUtils_SetColorPropertyValue(ArkUI_ColorPropertyHandle property, uint32_t value)](#oh_arkui_rendernodeutils_setcolorpropertyvalue) | - | 设置颜色属性的值。| 132| [int32_t OH_ArkUI_RenderNodeUtils_GetColorPropertyValue(ArkUI_ColorPropertyHandle property, uint32_t* value)](#oh_arkui_rendernodeutils_getcolorpropertyvalue) | - | 获取颜色属性的值。| 133| [void OH_ArkUI_RenderNodeUtils_DisposeColorProperty(ArkUI_ColorPropertyHandle property)](#oh_arkui_rendernodeutils_disposecolorproperty) | - | 释放颜色属性。| 134| [ArkUI_FloatAnimatablePropertyHandle OH_ArkUI_RenderNodeUtils_CreateFloatAnimatableProperty(float value)](#oh_arkui_rendernodeutils_createfloatanimatableproperty) | - | 创建可动画的浮点属性。| 135| [int32_t OH_ArkUI_RenderNodeUtils_SetFloatAnimatablePropertyValue(ArkUI_FloatAnimatablePropertyHandle property, float value)](#oh_arkui_rendernodeutils_setfloatanimatablepropertyvalue) | - | 设置可动画的浮点属性的值。| 136| [int32_t OH_ArkUI_RenderNodeUtils_GetFloatAnimatablePropertyValue(ArkUI_FloatAnimatablePropertyHandle property, float* value)](#oh_arkui_rendernodeutils_getfloatanimatablepropertyvalue) | - | 获取可动画的浮点属性的值。| 137| [void OH_ArkUI_RenderNodeUtils_DisposeFloatAnimatableProperty(ArkUI_FloatAnimatablePropertyHandle property)](#oh_arkui_rendernodeutils_disposefloatanimatableproperty) | - | 释放可动画的浮点属性。| 138| [ArkUI_Vector2AnimatablePropertyHandle OH_ArkUI_RenderNodeUtils_CreateVector2AnimatableProperty(float x, float y)](#oh_arkui_rendernodeutils_createvector2animatableproperty) | - | 创建可动画的二维向量属性。| 139| [int32_t OH_ArkUI_RenderNodeUtils_SetVector2AnimatablePropertyValue(ArkUI_Vector2AnimatablePropertyHandle property, float x, float y)](#oh_arkui_rendernodeutils_setvector2animatablepropertyvalue) | - | 设置可动画的二维向量属性的值。| 140| [int32_t OH_ArkUI_RenderNodeUtils_GetVector2AnimatablePropertyValue(ArkUI_Vector2AnimatablePropertyHandle property, float* x, float* y)](#oh_arkui_rendernodeutils_getvector2animatablepropertyvalue) | - | 获取可动画的二维向量属性的值。| 141| [void OH_ArkUI_RenderNodeUtils_DisposeVector2AnimatableProperty(ArkUI_Vector2AnimatablePropertyHandle property)](#oh_arkui_rendernodeutils_disposevector2animatableproperty) | - | 释放可动画的二维向量属性。| 142| [ArkUI_ColorAnimatablePropertyHandle OH_ArkUI_RenderNodeUtils_CreateColorAnimatableProperty(uint32_t value)](#oh_arkui_rendernodeutils_createcoloranimatableproperty) | - | 创建可动画的颜色属性。| 143| [int32_t OH_ArkUI_RenderNodeUtils_SetColorAnimatablePropertyValue(ArkUI_ColorAnimatablePropertyHandle property, uint32_t value)](#oh_arkui_rendernodeutils_setcoloranimatablepropertyvalue) | - | 设置可动画的颜色属性的值。| 144| [int32_t OH_ArkUI_RenderNodeUtils_GetColorAnimatablePropertyValue(ArkUI_ColorAnimatablePropertyHandle property, uint32_t* value)](#oh_arkui_rendernodeutils_getcoloranimatablepropertyvalue) | - | 获取可动画的颜色属性的值。| 145| [void OH_ArkUI_RenderNodeUtils_DisposeColorAnimatableProperty(ArkUI_ColorAnimatablePropertyHandle property)](#oh_arkui_rendernodeutils_disposecoloranimatableproperty) | - | 释放可动画的颜色属性。| 146| [int32_t OH_ArkUI_RenderNodeUtils_SetContentModifierOnDraw(ArkUI_RenderContentModifierHandle modifier, void* userData, void (*callback)(ArkUI_DrawContext context, void* userData))](#oh_arkui_rendernodeutils_setcontentmodifierondraw) | - | 设置内容修改器的 onDraw 函数。| 147| [ArkUI_RectShapeOption* OH_ArkUI_RenderNodeUtils_CreateRectShapeOption()](#oh_arkui_rendernodeutils_createrectshapeoption) | - | 创建矩形形状。| 148| [void OH_ArkUI_RenderNodeUtils_DisposeRectShapeOption(ArkUI_RectShapeOption* option)](#oh_arkui_rendernodeutils_disposerectshapeoption) | - | 释放矩形形状。| 149| [void OH_ArkUI_RenderNodeUtils_SetRectShapeOptionEdgeValue(ArkUI_RectShapeOption* option, float edgeValue, ArkUI_EdgeDirection direction)](#oh_arkui_rendernodeutils_setrectshapeoptionedgevalue) | - | 设置矩形形状的边缘值。| 150| [ArkUI_NodeBorderStyleOption* OH_ArkUI_RenderNodeUtils_CreateNodeBorderStyleOption()](#oh_arkui_rendernodeutils_createnodeborderstyleoption) | - | 创建节点边框样式。| 151| [void OH_ArkUI_RenderNodeUtils_DisposeNodeBorderStyleOption(ArkUI_NodeBorderStyleOption* option)](#oh_arkui_rendernodeutils_disposenodeborderstyleoption) | - | 释放节点边框样式。| 152| [void OH_ArkUI_RenderNodeUtils_SetNodeBorderStyleOptionEdgeStyle(ArkUI_NodeBorderStyleOption* option, ArkUI_BorderStyle edgeStyle, ArkUI_EdgeDirection direction)](#oh_arkui_rendernodeutils_setnodeborderstyleoptionedgestyle) | - | 设置节点边框样式的边缘值。| 153| [ArkUI_NodeBorderWidthOption* OH_ArkUI_RenderNodeUtils_CreateNodeBorderWidthOption()](#oh_arkui_rendernodeutils_createnodeborderwidthoption) | - | 创建节点边框宽度。| 154| [void OH_ArkUI_RenderNodeUtils_DisposeNodeBorderWidthOption(ArkUI_NodeBorderWidthOption* option)](#oh_arkui_rendernodeutils_disposenodeborderwidthoption) | - | 释放节点边框宽度。| 155| [void OH_ArkUI_RenderNodeUtils_SetNodeBorderWidthOptionEdgeWidth(ArkUI_NodeBorderWidthOption* option, float edgeWidth, ArkUI_EdgeDirection direction)](#oh_arkui_rendernodeutils_setnodeborderwidthoptionedgewidth) | - | 设置节点边框宽度的边缘值。| 156| [ArkUI_NodeBorderColorOption* OH_ArkUI_RenderNodeUtils_CreateNodeBorderColorOption()](#oh_arkui_rendernodeutils_createnodebordercoloroption) | - | 创建节点边框颜色。| 157| [void OH_ArkUI_RenderNodeUtils_DisposeNodeBorderColorOption(ArkUI_NodeBorderColorOption* option)](#oh_arkui_rendernodeutils_disposenodebordercoloroption) | - | 释放节点边框颜色。| 158| [void OH_ArkUI_RenderNodeUtils_SetNodeBorderColorOptionEdgeColor(ArkUI_NodeBorderColorOption* option, uint32_t edgeColor, ArkUI_EdgeDirection direction)](#oh_arkui_rendernodeutils_setnodebordercoloroptionedgecolor) | - | 设置节点边框颜色的边缘值。| 159| [ArkUI_NodeBorderRadiusOption* OH_ArkUI_RenderNodeUtils_CreateNodeBorderRadiusOption()](#oh_arkui_rendernodeutils_createnodeborderradiusoption) | - | 创建节点边框半径。| 160| [void OH_ArkUI_RenderNodeUtils_DisposeNodeBorderRadiusOption(ArkUI_NodeBorderRadiusOption* option)](#oh_arkui_rendernodeutils_disposenodeborderradiusoption) | - | 释放节点边框半径。| 161| [void OH_ArkUI_RenderNodeUtils_SetNodeBorderRadiusOptionCornerRadius(ArkUI_NodeBorderRadiusOption* option, uint32_t cornerRadius, ArkUI_CornerDirection direction)](#oh_arkui_rendernodeutils_setnodeborderradiusoptioncornerradius) | - | 设置节点边框半径的边缘值。| 162| [ArkUI_CircleShapeOption* OH_ArkUI_RenderNodeUtils_CreateCircleShapeOption()](#oh_arkui_rendernodeutils_createcircleshapeoption) | - | 创建圆形形状。| 163| [void OH_ArkUI_RenderNodeUtils_DisposeCircleShapeOption(ArkUI_CircleShapeOption* option)](#oh_arkui_rendernodeutils_disposecircleshapeoption) | - | 释放圆形形状。| 164| [void OH_ArkUI_RenderNodeUtils_SetCircleShapeOptionCenterX(ArkUI_CircleShapeOption* option, float centerX)](#oh_arkui_rendernodeutils_setcircleshapeoptioncenterx) | - | 设置圆形形状的圆心x轴坐标值。| 165| [void OH_ArkUI_RenderNodeUtils_SetCircleShapeOptionCenterY(ArkUI_CircleShapeOption* option, float centerY)](#oh_arkui_rendernodeutils_setcircleshapeoptioncentery) | - | 设置圆形形状的圆心y轴坐标值。| 166| [void OH_ArkUI_RenderNodeUtils_SetCircleShapeOptionRadius(ArkUI_CircleShapeOption* option, float radius)](#oh_arkui_rendernodeutils_setcircleshapeoptionradius) | - | 设置圆形形状的半径值。| 167| [ArkUI_RoundRectShapeOption* OH_ArkUI_RenderNodeUtils_CreateRoundRectShapeOption()](#oh_arkui_rendernodeutils_createroundrectshapeoption) | - | 创建圆角矩形形状。| 168| [void OH_ArkUI_RenderNodeUtils_DisposeRoundRectShapeOption(ArkUI_RoundRectShapeOption* option)](#oh_arkui_rendernodeutils_disposeroundrectshapeoption) | - | 释放圆角矩形形状。| 169| [void OH_ArkUI_RenderNodeUtils_SetRoundRectShapeOptionEdgeValue(ArkUI_RoundRectShapeOption* option, float edgeValue, ArkUI_EdgeDirection direction)](#oh_arkui_rendernodeutils_setroundrectshapeoptionedgevalue) | - | 设置圆角矩形形状的边缘值。| 170| [void OH_ArkUI_RenderNodeUtils_SetRoundRectShapeOptionCornerXY(ArkUI_RoundRectShapeOption* option, float x, float y, ArkUI_CornerDirection direction)](#oh_arkui_rendernodeutils_setroundrectshapeoptioncornerxy) | - | 设置目标角的坐标值。| 171| [ArkUI_CommandPathOption* OH_ArkUI_RenderNodeUtils_CreateCommandPathOption()](#oh_arkui_rendernodeutils_createcommandpathoption) | - | 创建自定义绘制路径。| 172| [void OH_ArkUI_RenderNodeUtils_DisposeCommandPathOption(ArkUI_CommandPathOption* option)](#oh_arkui_rendernodeutils_disposecommandpathoption) | - | 释放自定义绘制路径。| 173| [void OH_ArkUI_RenderNodeUtils_SetCommandPathOptionCommands(ArkUI_CommandPathOption* option, char* commands)](#oh_arkui_rendernodeutils_setcommandpathoptioncommands) | - | 设置自定义绘制路径的命令值。| 174| [ArkUI_RenderNodeMaskOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromRectShape(ArkUI_RectShapeOption* shape)](#oh_arkui_rendernodeutils_createrendernodemaskoptionfromrectshape) | - | 从矩形形状创建遮罩。| 175| [ArkUI_RenderNodeMaskOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromRoundRectShape(ArkUI_RoundRectShapeOption* shape)](#oh_arkui_rendernodeutils_createrendernodemaskoptionfromroundrectshape) | - | 从圆角矩形形状创建遮罩。| 176| [ArkUI_RenderNodeMaskOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromCircleShape(ArkUI_CircleShapeOption* shape)](#oh_arkui_rendernodeutils_createrendernodemaskoptionfromcircleshape) | - | 从圆形形状创建遮罩。| 177| [ArkUI_RenderNodeMaskOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromOvalShape(ArkUI_RectShapeOption* shape)](#oh_arkui_rendernodeutils_createrendernodemaskoptionfromovalshape) | - | 从椭圆形形状创建遮罩。| 178| [ArkUI_RenderNodeMaskOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromCommandPath(ArkUI_CommandPathOption* path)](#oh_arkui_rendernodeutils_createrendernodemaskoptionfromcommandpath) | - | 从自定义绘制路径创建遮罩。| 179| [void OH_ArkUI_RenderNodeUtils_DisposeRenderNodeMaskOption(ArkUI_RenderNodeMaskOption* option)](#oh_arkui_rendernodeutils_disposerendernodemaskoption) | - | 释放渲染节点遮罩。| 180| [void OH_ArkUI_RenderNodeUtils_SetRenderNodeMaskOptionFillColor(ArkUI_RenderNodeMaskOption* mask, uint32_t fillColor)](#oh_arkui_rendernodeutils_setrendernodemaskoptionfillcolor) | - | 设置渲染节点遮罩的填充颜色。| 181| [void OH_ArkUI_RenderNodeUtils_SetRenderNodeMaskOptionStrokeColor(ArkUI_RenderNodeMaskOption* mask, uint32_t strokeColor)](#oh_arkui_rendernodeutils_setrendernodemaskoptionstrokecolor) | - | 设置渲染节点遮罩的描边颜色。| 182| [void OH_ArkUI_RenderNodeUtils_SetRenderNodeMaskOptionStrokeWidth(ArkUI_RenderNodeMaskOption* mask, float strokeWidth)](#oh_arkui_rendernodeutils_setrendernodemaskoptionstrokewidth) | - | 设置渲染节点遮罩的描边宽度。| 183| [ArkUI_RenderNodeClipOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromRectShape(ArkUI_RectShapeOption* shape)](#oh_arkui_rendernodeutils_createrendernodeclipoptionfromrectshape) | - | 从矩形形状创建裁剪。| 184| [ArkUI_RenderNodeClipOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromRoundRectShape(ArkUI_RoundRectShapeOption* shape)](#oh_arkui_rendernodeutils_createrendernodeclipoptionfromroundrectshape) | - | 从圆角矩形形状创建裁剪。| 185| [ArkUI_RenderNodeClipOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromCircleShape(ArkUI_CircleShapeOption* shape)](#oh_arkui_rendernodeutils_createrendernodeclipoptionfromcircleshape) | - | 从圆形形状创建裁剪。| 186| [ArkUI_RenderNodeClipOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromOvalShape(ArkUI_RectShapeOption* shape)](#oh_arkui_rendernodeutils_createrendernodeclipoptionfromovalshape) | - | 从椭圆形形状创建裁剪。| 187| [ArkUI_RenderNodeClipOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromCommandPath(ArkUI_CommandPathOption* path)](#oh_arkui_rendernodeutils_createrendernodeclipoptionfromcommandpath) | - | 从自定义绘制路径创建裁剪。| 188| [void OH_ArkUI_RenderNodeUtils_DisposeRenderNodeClipOption(ArkUI_RenderNodeClipOption* option)](#oh_arkui_rendernodeutils_disposerendernodeclipoption) | - | 释放渲染节点裁剪。| 189 190 191## 函数说明 192 193### OH_ArkUI_RenderNodeUtils_AddRenderNode() 194 195``` 196int32_t OH_ArkUI_RenderNodeUtils_AddRenderNode(ArkUI_NodeHandle node, ArkUI_RenderNodeHandle child) 197``` 198 199**描述：** 200向父自定义节点添加子渲染节点。 201 </br>仅支持customNode类型的父节点。 202 </br>每个自定义节点只能挂载一个ArkUI_RenderNodeHandle。 203 </br>customNode无法挂载其他ArkUI_NodeHandle。 204 205**起始版本：** 20 206 207**参数：** 208 209| 参数项 | 描述 | 210| -- | -- | 211| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点。| 212| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) child | 目标渲染节点。 | 213 214**返回：** 215 216| 类型 | 说明 | 217| -- | -- | 218| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_NOT_CUSTOM_NODE](capi-native-type-h.md#arkui_errorcode) 目标节点非自定义节点。<br> [ARKUI_ERROR_CODE_CHILD_EXISTED](capi-native-type-h.md#arkui_errorcode) 目标节点已存在子节点。<br> [ARKUI_ERROR_CODE_RENDER_PARENT_EXISTED](capi-native-type-h.md#arkui_errorcode) 目标渲染节点存在父节点。 | 219 220### OH_ArkUI_RenderNodeUtils_RemoveRenderNode() 221 222``` 223int32_t OH_ArkUI_RenderNodeUtils_RemoveRenderNode(ArkUI_NodeHandle node, ArkUI_RenderNodeHandle child) 224``` 225 226**描述：** 227移除指定节点的子渲染节点。 228 229**起始版本：** 20 230 231**参数：** 232 233| 参数项 | 描述 | 234| -- | -- | 235| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点。 | 236| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) child | 目标渲染节点。 | 237 238**返回：** 239 240| 类型 | 说明 | 241| -- | -- | 242| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_NOT_CUSTOM_NODE](capi-native-type-h.md#arkui_errorcode) 目标节点非自定义节点。 243 244### OH_ArkUI_RenderNodeUtils_ClearRenderNodeChildren() 245 246``` 247int32_t OH_ArkUI_RenderNodeUtils_ClearRenderNodeChildren(ArkUI_NodeHandle node) 248``` 249 250**描述：** 251清除父节点内的子渲染节点。 252 253**起始版本：** 20 254 255**参数：** 256 257| 参数项 | 描述 | 258| -- | -- | 259| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点。 | 260 261**返回：** 262 263| 类型 | 说明 | 264| -- | -- | 265| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_NOT_CUSTOM_NODE](capi-native-type-h.md#arkui_errorcode) 目标节点非自定义节点。 266 267### OH_ArkUI_RenderNodeUtils_Invalidate() 268 269``` 270int32_t OH_ArkUI_RenderNodeUtils_Invalidate(ArkUI_NodeHandle node) 271``` 272 273**描述：** 274标脏目标自定义节点，使其子渲染节点重新渲染。 275 276**起始版本：** 20 277 278**参数：** 279 280| 参数项 | 描述 | 281| -- | -- | 282| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点。 | 283 284**返回：** 285 286| 类型 | 说明 | 287| -- | -- | 288| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 289 290### OH_ArkUI_RenderNodeUtils_CreateNode() 291 292``` 293ArkUI_RenderNodeHandle OH_ArkUI_RenderNodeUtils_CreateNode() 294``` 295 296**描述：** 297创建渲染节点。 298 299**起始版本：** 20 300 301**返回：** 302 303| 类型 | 说明 | 304| -- | -- | 305| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) | 目标渲染节点。 | 306 307### OH_ArkUI_RenderNodeUtils_DisposeNode() 308 309``` 310int32_t OH_ArkUI_RenderNodeUtils_DisposeNode(ArkUI_RenderNodeHandle node) 311``` 312 313**描述：** 314销毁渲染节点。 315 316**起始版本：** 20 317 318**参数：** 319 320| 参数项 | 描述 | 321| -- | -- | 322| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) | 目标渲染节点。 | 323 324**返回：** 325 326| 类型 | 说明 | 327| -- | -- | 328| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 329 330### OH_ArkUI_RenderNodeUtils_AddChild() 331 332``` 333int32_t OH_ArkUI_RenderNodeUtils_AddChild(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle child) 334``` 335 336**描述：** 337向目标父渲染节点上添加子节点。 338 339**起始版本：** 20 340 341**参数：** 342 343| 参数项 | 描述 | 344| -- | -- | 345| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node| 目标父渲染节点。 | 346| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) child| 目标添加子渲染节点。 | 347 348**返回：** 349 350| 类型 | 说明 | 351| -- | -- | 352| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 353 354### OH_ArkUI_RenderNodeUtils_InsertChildAfter() 355 356``` 357int32_t OH_ArkUI_RenderNodeUtils_InsertChildAfter(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle child, ArkUI_RenderNodeHandle sibling) 358``` 359 360**描述：** 361向父节点的目标子节点后添加子节点。 362 363**起始版本：** 20 364 365**参数：** 366 367| 参数项 | 描述 | 368| -- | -- | 369| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node| 目标父渲染节点。 | 370| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) child| 目标添加子渲染节点。 | 371| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) sibling| 目标子渲染节点。 | 372 373**返回：** 374 375| 类型 | 说明 | 376| -- | -- | 377| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 378 379### OH_ArkUI_RenderNodeUtils_RemoveChild() 380 381``` 382int32_t OH_ArkUI_RenderNodeUtils_RemoveChild(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle child) 383``` 384 385**描述：** 386从指定渲染节点中移除子节点。 387 388**起始版本：** 20 389 390**参数：** 391| 参数项 | 描述 | 392| -- | -- | 393| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标父渲染节点。 | 394| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) child | 目标被移除子渲染节点。 | 395 396**返回：** 397 398| 类型 | 说明 | 399| -- | -- | 400| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 401 402### OH_ArkUI_RenderNodeUtils_ClearChildren() 403 404``` 405int32_t OH_ArkUI_RenderNodeUtils_ClearChildren(ArkUI_RenderNodeHandle node) 406``` 407 408**描述：** 409清空指定渲染节点的所有子节点。 410 411**起始版本：** 20 412 413**参数：** 414| 参数项 | 描述 | 415| -- | -- | 416| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 417 418**返回：** 419| 类型 | 说明 | 420| -- | -- | 421| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 422 423### OH_ArkUI_RenderNodeUtils_GetChild() 424 425``` 426int32_t OH_ArkUI_RenderNodeUtils_GetChild(ArkUI_RenderNodeHandle node, int32_t index, ArkUI_RenderNodeHandle* child) 427``` 428 429**描述：** 430获取指定索引位置的子节点。 431 432**起始版本：** 20 433 434**参数：** 435| 参数项 | 描述 | 436| -- | -- | 437| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标父渲染节点。 | 438| int32_t index | 子节点的从零开始的索引。 | 439| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md)* child | 用于接收子节点的渲染节点指针。 | 440 441**返回：** 442| 类型 | 说明 | 443| -- | -- | 444| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_RENDER_CHILD_NOT_EXIST](capi-native-type-h.md#arkui_errorcode) 未找到对应的渲染子节点。 445 446### OH_ArkUI_RenderNodeUtils_GetFirstChild() 447 448``` 449int32_t OH_ArkUI_RenderNodeUtils_GetFirstChild(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle* child) 450``` 451 452**描述：** 453获取指定渲染节点的第一个子节点。 454 455**起始版本：** 20 456 457**参数：** 458| 参数项 | 描述 | 459| -- | -- | 460| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 461| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md)* child | 用于接收第一个子节点的渲染节点指针。 | 462 463**返回：** 464| 类型 | 说明 | 465| -- | -- | 466| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_RENDER_CHILD_NOT_EXIST](capi-native-type-h.md#arkui_errorcode) 未找到对应的渲染子节点。 467 468### OH_ArkUI_RenderNodeUtils_GetNextSibling() 469 470``` 471int32_t OH_ArkUI_RenderNodeUtils_GetNextSibling(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle* sibling) 472``` 473 474**描述：** 475获取指定节点的下一个子节点。 476 477**起始版本：** 20 478 479**参数：** 480| 参数项 | 描述 | 481| -- | -- | 482| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 483| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md)* sibling | 用于接收下一个子节点的渲染节点指针。 | 484 485**返回：** 486| 类型 | 说明 | 487| -- | -- | 488| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_RENDER_CHILD_NOT_EXIST](capi-native-type-h.md#arkui_errorcode) 未找到对应的渲染子节点。 489 490### OH_ArkUI_RenderNodeUtils_GetPreviousSibling() 491 492``` 493int32_t OH_ArkUI_RenderNodeUtils_GetPreviousSibling(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle* sibling) 494``` 495 496**描述：** 497获取指定节点的上一个子节点。 498 499**起始版本：** 20 500 501**参数：** 502| 参数项 | 描述 | 503| -- | -- | 504| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 参考节点。 | 505| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md)* sibling | 用于接收上一个子节点的渲染节点指针。 | 506 507**返回：** 508| 类型 | 说明 | 509| -- | -- | 510| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_RENDER_CHILD_NOT_EXIST](capi-native-type-h.md#arkui_errorcode) 未找到对应的渲染子节点。 511 512### OH_ArkUI_RenderNodeUtils_GetChildren() 513 514``` 515int32_t OH_ArkUI_RenderNodeUtils_GetChildren(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeHandle** children, int32_t* count) 516``` 517 518**描述：** 519获取父渲染节点的所有子渲染节点，调用者负责释放返回的子节点数组。 520 521**起始版本：** 20 522 523**参数：** 524| 参数项 | 描述 | 525| -- | -- | 526| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标父渲染节点。 | 527| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md)** children | 用于存储所有子渲染节点的指针数组。 | 528| int32_t* count | 用于存储获取到的子节点数量的指针。 | 529 530**返回：** 531| 类型 | 说明 | 532| -- | -- | 533| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 534 535### OH_ArkUI_RenderNodeUtils_GetChildrenCount() 536 537``` 538int32_t OH_ArkUI_RenderNodeUtils_GetChildrenCount(ArkUI_RenderNodeHandle node, int32_t* count) 539``` 540 541**描述：** 542获取指定渲染节点的子渲染节点数量。 543 544**起始版本：** 20 545 546**参数：** 547| 参数项 | 描述 | 548| -- | -- | 549| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标父渲染节点。 | 550| int32_t* count | 用于存储子节点数量的指针。 | 551 552**返回：** 553| 类型 | 说明 | 554| -- | -- | 555| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 556 557### OH_ArkUI_RenderNodeUtils_SetBackgroundColor() 558 559``` 560int32_t OH_ArkUI_RenderNodeUtils_SetBackgroundColor(ArkUI_RenderNodeHandle node, uint32_t color) 561``` 562 563**描述：** 564为渲染节点设置背景颜色。 565 566**起始版本：** 20 567 568**参数：** 569| 参数项 | 描述 | 570| -- | -- | 571| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 572| uint32_t color | ARGB 颜色值（32 位无符号整数）。<br/>默认值：0x00000000。<br>**颜色字节布局说明：**<br>- 位24-31：Alpha通道（0x00完全透明，0xFF完全不透明）。<br>- 位16-23：红色通道。<br>- 位8-15：绿色通道。<br>- 位0-7：蓝色通道。 | 573 574**返回：** 575| 类型 | 说明 | 576| -- | -- | 577| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 578 579### OH_ArkUI_RenderNodeUtils_GetBackgroundColor() 580 581``` 582int32_t OH_ArkUI_RenderNodeUtils_GetBackgroundColor(ArkUI_RenderNodeHandle node, uint32_t* color) 583``` 584 585**描述：** 586获取渲染节点的背景颜色。 587 588**起始版本：** 20 589 590**参数：** 591| 参数项 | 描述 | 592| -- | -- | 593| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 594| uint32_t* color | 用于存储获取到的 RGBA 颜色值的整数指针。<br/>默认值：0x00000000。<br>**颜色字节布局说明：**<br>- 位24-31：Alpha通道（0x00完全透明，0xFF完全不透明）。<br>- 位16-23：红色通道。<br>- 位8-15：绿色通道。<br>- 位0-7：蓝色通道。 | 595 596**返回：** 597| 类型 | 说明 | 598| -- | -- | 599| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 600 601### OH_ArkUI_RenderNodeUtils_SetClipToFrame() 602 603``` 604int32_t OH_ArkUI_RenderNodeUtils_SetClipToFrame(ArkUI_RenderNodeHandle node, int32_t clipToFrame) 605``` 606 607**描述：** 608设置是否对当前渲染节点裁剪。 609 610**起始版本：** 20 611 612**参数：** 613| 参数项 | 描述 | 614| -- | -- | 615| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 616| int32_t clipToFrame | 整数（1 = 裁剪到框架，0 = 不裁剪）。<br/>默认值：0。 | 617 618**返回：** 619| 类型 | 说明 | 620| -- | -- | 621| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_PARAM_OUT_OF_RANGE](capi-native-type-h.md#arkui_errorcode) 参数值超出范围。 622 623### OH_ArkUI_RenderNodeUtils_GetClipToFrame() 624 625``` 626int32_t OH_ArkUI_RenderNodeUtils_GetClipToFrame(ArkUI_RenderNodeHandle node, int32_t* clipToFrame) 627``` 628 629**描述：** 630获取是否对当前渲染节点裁剪。 631 632**起始版本：** 20 633 634**参数：** 635| 参数项 | 描述 | 636| -- | -- | 637| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 638| int32_t* clipToFrame | 用于接收裁剪状态（1 或 0）的整数指针。<br/>默认值：0。 | 639 640**返回：** 641| 类型 | 说明 | 642| -- | -- | 643| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 644 645### OH_ArkUI_RenderNodeUtils_SetClipToBounds() 646 647``` 648int32_t OH_ArkUI_RenderNodeUtils_SetClipToBounds(ArkUI_RenderNodeHandle node, int32_t clipToBounds) 649``` 650 651**描述：** 652设置是否对当前渲染节点边界裁剪。 653 654**起始版本：** 20 655 656**参数：** 657| 参数项 | 描述 | 658| -- | -- | 659| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 660| int32_t clipToBounds | 裁剪标志（1：裁剪到边界，0：不裁剪）。<br/>默认值：0。 | 661 662**返回：** 663| 类型 | 说明 | 664| -- | -- | 665| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_PARAM_OUT_OF_RANGE](capi-native-type-h.md#arkui_errorcode) 参数值超出范围。 666 667### OH_ArkUI_RenderNodeUtils_GetClipToBounds() 668 669``` 670int32_t OH_ArkUI_RenderNodeUtils_GetClipToBounds(ArkUI_RenderNodeHandle node, int32_t* clipToBounds) 671``` 672 673**描述：** 674获取是否对当前渲染节点边界裁剪。 675 676**起始版本：** 20 677 678**参数：** 679| 参数项 | 描述 | 680| -- | -- | 681| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 682| int32_t* clipToBounds | 整数指针（1 = 根据边界裁剪，0 = 不裁剪）。<br/>默认值：0。 | 683 684**返回：** 685| 类型 | 说明 | 686| -- | -- | 687| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 688 689### OH_ArkUI_RenderNodeUtils_SetOpacity() 690 691``` 692int32_t OH_ArkUI_RenderNodeUtils_SetOpacity(ArkUI_RenderNodeHandle node, float opacity) 693``` 694 695**描述：** 696为渲染节点设置不透明度值。 697 698**起始版本：** 20 699 700**参数：** 701| 参数项 | 描述 | 702| -- | -- | 703| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 704| float opacity | 不透明度值（0.0-1.0）。 <br/>默认值：1。| 705 706**返回：** 707| 类型 | 说明 | 708| -- | -- | 709| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_PARAM_OUT_OF_RANGE](capi-native-type-h.md#arkui_errorcode) 参数值超出范围。 710 711### OH_ArkUI_RenderNodeUtils_GetOpacity() 712 713``` 714int32_t OH_ArkUI_RenderNodeUtils_GetOpacity(ArkUI_RenderNodeHandle node, float* opacity) 715``` 716 717**描述：** 718获取渲染节点的不透明度值。 719 720**起始版本：** 20 721 722**参数：** 723| 参数项 | 描述 | 724| -- | -- | 725| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 726| float* opacity | 用于接收不透明度值（0.0-1.0）的指针。<br/>默认值：1。 | 727 728**返回：** 729| 类型 | 说明 | 730| -- | -- | 731| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 732 733### OH_ArkUI_RenderNodeUtils_SetSize() 734 735``` 736int32_t OH_ArkUI_RenderNodeUtils_SetSize(ArkUI_RenderNodeHandle node, int32_t width, int32_t height) 737``` 738 739**描述：** 740为渲染节点设置尺寸。 741 742**起始版本：** 20 743 744**参数：** 745| 参数项 | 描述 | 746| -- | -- | 747| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 748| int32_t width | 宽度值（以像素为单位）。<br/>默认值：0，单位：px。 | 749| int32_t height | 高度值（以像素为单位）。<br/>默认值：0，单位：px。 | 750 751**返回：** 752| 类型 | 说明 | 753| -- | -- | 754| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_PARAM_OUT_OF_RANGE](capi-native-type-h.md#arkui_errorcode) 参数值超出范围。 755 756### OH_ArkUI_RenderNodeUtils_GetSize() 757 758``` 759int32_t OH_ArkUI_RenderNodeUtils_GetSize(ArkUI_RenderNodeHandle node, int32_t* width, int32_t* height) 760``` 761 762**描述：** 763获取渲染节点的尺寸。 764 765**起始版本：** 20 766 767**参数：** 768| 参数项 | 描述 | 769| -- | -- | 770| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 771| int32_t* width | 用于接收宽度值（以像素为单位）的指针。<br/>默认值：0，单位：px。 | 772| int32_t* height | 用于接收高度值（以像素为单位）的指针。<br/>默认值：0，单位：px。 | 773 774**返回：** 775| 类型 | 说明 | 776| -- | -- | 777| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 778 779### OH_ArkUI_RenderNodeUtils_SetPosition() 780 781``` 782int32_t OH_ArkUI_RenderNodeUtils_SetPosition(ArkUI_RenderNodeHandle node, int32_t x, int32_t y) 783``` 784 785**描述：** 786为渲染节点设置位置坐标。 787 788**起始版本：** 20 789 790**参数：** 791| 参数项 | 描述 | 792| -- | -- | 793| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 794| int32_t x |X坐标值（以像素为单位）。<br/>默认值：0，单位：px。 | 795| int32_t y |Y坐标值（以像素为单位）。<br/>默认值：0，单位：px。 | 796 797**返回：** 798| 类型 | 说明 | 799| -- | -- | 800| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 801 802### OH_ArkUI_RenderNodeUtils_GetPosition() 803 804``` 805int32_t OH_ArkUI_RenderNodeUtils_GetPosition(ArkUI_RenderNodeHandle node, int32_t* x, int32_t* y) 806``` 807 808**描述：** 809获取渲染节点的位置坐标。 810 811**起始版本：** 20 812 813**参数：** 814| 参数项 | 描述 | 815| -- | -- | 816| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 817| int32_t* x | 用于接收X坐标值（以像素为单位）的指针。<br/>默认值：0，单位：px。 | 818| int32_t* y | 用于接收Y坐标值（以像素为单位）的指针。<br/>默认值：0，单位：px。 | 819 820**返回：** 821| 类型 | 说明 | 822| -- | -- | 823| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 824 825### OH_ArkUI_RenderNodeUtils_SetPivot() 826 827``` 828int32_t OH_ArkUI_RenderNodeUtils_SetPivot(ArkUI_RenderNodeHandle node, float x, float y) 829``` 830 831**描述：** 832为渲染节点的变换设置中心点。 833 834**起始版本：** 20 835 836**参数：** 837| 参数项 | 描述 | 838| -- | -- | 839| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 840| float x | 中心点的X坐标（标准取值范围：0.0-1.0）。<br/>默认值：0.5。 | 841| float y | 中心点的Y坐标（标准取值范围：0.0-1.0）。<br/>默认值：0.5。 | 842 843**返回：** 844| 类型 | 说明 | 845| -- | -- | 846| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 847 848### OH_ArkUI_RenderNodeUtils_GetPivot() 849 850``` 851int32_t OH_ArkUI_RenderNodeUtils_GetPivot(ArkUI_RenderNodeHandle node, float* x, float* y) 852``` 853 854**描述：** 855获取渲染节点的中心点坐标。 856 857**起始版本：** 20 858 859**参数：** 860| 参数项 | 描述 | 861| -- | -- | 862| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 863| float* x | 用于接收中心点X坐标的指针。<br/>默认值：0.5。 | 864| float* y | 用于接收中心点Y坐标的指针。<br/>默认值：0.5。 | 865 866**返回：** 867| 类型 | 说明 | 868| -- | -- | 869| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 870 871### OH_ArkUI_RenderNodeUtils_SetScale() 872 873``` 874int32_t OH_ArkUI_RenderNodeUtils_SetScale(ArkUI_RenderNodeHandle node, float x, float y) 875``` 876 877**描述：** 878为渲染节点设置缩放因子。 879 880**起始版本：** 20 881 882**参数：** 883| 参数项 | 描述 | 884| -- | -- | 885| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 886| float x | 水平缩放因子。<br/>默认值：1。 | 887| float y | 垂直缩放因子。<br/>默认值：1。 | 888 889**返回：** 890| 类型 | 说明 | 891| -- | -- | 892| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 893 894### OH_ArkUI_RenderNodeUtils_GetScale() 895 896``` 897int32_t OH_ArkUI_RenderNodeUtils_GetScale(ArkUI_RenderNodeHandle node, float* x, float* y) 898``` 899 900**描述：** 901获取渲染节点的缩放因子。 902 903**起始版本：** 20 904 905**参数：** 906| 参数项 | 描述 | 907| -- | -- | 908| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 909| float* x | 用于接收水平缩放因子的指针。<br/>默认值：1。 | 910| float* y | 用于接收垂直缩放因子的指针。<br/>默认值：1。 | 911 912**返回：** 913| 类型 | 说明 | 914| -- | -- | 915| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 916 917### OH_ArkUI_RenderNodeUtils_SetTranslation() 918 919``` 920int32_t OH_ArkUI_RenderNodeUtils_SetTranslation(ArkUI_RenderNodeHandle node, float x, float y) 921``` 922 923**描述：** 924为渲染节点设置平移偏移量。 925 926**起始版本：** 20 927 928**参数：** 929| 参数项 | 描述 | 930| -- | -- | 931| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 932| float x | 水平平移量（以像素为单位）。<br/>默认值：0。 | 933| float y | 垂直平移量（以像素为单位）。<br/>默认值：0。 | 934 935**返回：** 936| 类型 | 说明 | 937| -- | -- | 938| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 939 940### OH_ArkUI_RenderNodeUtils_GetTranslation() 941 942``` 943int32_t OH_ArkUI_RenderNodeUtils_GetTranslation(ArkUI_RenderNodeHandle node, float* x, float* y) 944``` 945 946**描述：** 947获取渲染节点的平移偏移量。 948 949**起始版本：** 20 950 951**参数：** 952| 参数项 | 描述 | 953| -- | -- | 954| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 955| float* x | 用于接收水平平移量的指针。<br/>默认值：0。 | 956| float* y | 用于接收垂直平移量的指针。<br/>默认值：0。 | 957 958**返回：** 959| 类型 | 说明 | 960| -- | -- | 961| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 962 963### OH_ArkUI_RenderNodeUtils_SetRotation() 964 965``` 966int32_t OH_ArkUI_RenderNodeUtils_SetRotation(ArkUI_RenderNodeHandle node, float x, float y, float z) 967``` 968 969**描述：** 970为渲染节点设置旋转角度。 971 972**起始版本：** 20 973 974**参数：** 975| 参数项 | 描述 | 976| -- | -- | 977| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 978| float x | 绕X轴的旋转角度（以度为单位）。<br/>默认值：0。 | 979| float y | 绕Y轴的旋转角度（以度为单位）。<br/>默认值：0。 | 980| float z | 绕Z轴的旋转角度（以度为单位）。<br/>默认值：0。 | 981 982**返回：** 983| 类型 | 说明 | 984| -- | -- | 985| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 986 987### OH_ArkUI_RenderNodeUtils_GetRotation() 988 989``` 990int32_t OH_ArkUI_RenderNodeUtils_GetRotation(ArkUI_RenderNodeHandle node, float* x, float* y, float* z) 991``` 992 993**描述：** 994获取渲染节点的旋转角度。 995 996**起始版本：** 20 997 998**参数：** 999| 参数项 | 描述 | 1000| -- | -- | 1001| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1002| float* x | 用于接收绕X轴旋转角度（以度为单位）的指针。<br/>默认值：0。 | 1003| float* y | 用于接收绕Y轴旋转角度（以度为单位）的指针。<br/>默认值：0。 | 1004| float* z | 用于接收绕Z轴旋转角度（以度为单位）的指针。<br/>默认值：0。 | 1005 1006**返回：** 1007| 类型 | 说明 | 1008| -- | -- | 1009| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1010 1011### OH_ArkUI_RenderNodeUtils_SetTransform() 1012 1013``` 1014int32_t OH_ArkUI_RenderNodeUtils_SetTransform(ArkUI_RenderNodeHandle node, float* matrix) 1015``` 1016 1017**描述：** 1018为渲染节点设置变换矩阵。 1019 1020**起始版本：** 20 1021 1022**参数：** 1023| 参数项 | 描述 | 1024| -- | -- | 1025| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1026| float* matrix | 4x4 变换矩阵的浮点数数组（16 个连续值）。| 1027 1028变换矩阵应作为 16 个连续的浮点值以行优先顺序提供：<br> 1029[m00, m01, m02, m03,<br> 1030m10, m11, m12, m13,<br> 1031m20, m21, m22, m23,<br> 1032m30, m31, m32, m33]<br> 1033其中矩阵表示为：<br> 1034| m00 m01 m02 m03 |<br> 1035| m10 m11 m12 m13 |<br> 1036| m20 m21 m22 m23 |<br> 1037| m30 m31 m32 m33 |<br> 1038矩阵组件： 1039| 矩阵单元 | 描述 | 1040| -- | -- | 1041| m00 | x轴的缩放值。单位矩阵的默认值为1。 | 1042| m01 | 第二个值，受 x、y、z 轴的旋转或倾斜影响。 | 1043| m02 | 第三个值，受 x、y、z 轴的旋转影响。 | 1044| m03 | 第四个值，受透视投影影响。 | 1045| m10 | 第五个值，受 x、y、z 轴的旋转或倾斜影响。 | 1046| m11 | y轴的缩放值。单位矩阵的默认值为1。 | 1047| m12 | 第七个值，受 x、y、z 轴的旋转影响。 | 1048| m13 | 第八个值，受透视投影影响。 | 1049| m20 | 第九个值，受 x、y、z 轴的旋转影响。 | 1050| m21 | 第十个值，受 x、y、z 轴的旋转影响。 | 1051| m22 | z轴的缩放值。单位矩阵的默认值为1。 | 1052| m23 | 第 12 个值，受透视投影影响。 | 1053| m30 | x轴的平移值（以 px 为单位）。单位矩阵的默认值为0。| 1054| m31 | y轴的平移值（以 px 为单位）。单位矩阵的默认值为0。| 1055| m32 | z轴的平移值（以 px 为单位）。单位矩阵的默认值为0。| 1056| m33 | 在齐次坐标中有效，呈现透视投影效果。 | | 1057 1058**返回：** 1059| 类型 | 说明 | 1060| -- | -- | 1061| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_PARAM_OUT_OF_RANGE](capi-native-type-h.md#arkui_errorcode) 参数超出范围。 1062 1063### OH_ArkUI_RenderNodeUtils_SetShadowColor() 1064 1065``` 1066int32_t OH_ArkUI_RenderNodeUtils_SetShadowColor(ArkUI_RenderNodeHandle node, uint32_t color) 1067``` 1068 1069**描述：** 1070为渲染节点设置阴影颜色。 1071 1072**起始版本：** 20 1073 1074**参数：** 1075| 参数项 | 描述 | 1076| -- | -- | 1077| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1078| uint32_t color | ARGB 颜色值（32位无符号整数）。<br/>默认值：0x00000000。<br>**颜色字节布局说明：**<br>- 位24-31：Alpha通道（0x00完全透明，0xFF完全不透明）。<br>- 位16-23：红色通道。<br>- 位8-15：绿色通道。<br>- 位0-7：蓝色通道。 | 1079 1080**返回：** 1081| 类型 | 说明 | 1082| -- | -- | 1083| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1084 1085### OH_ArkUI_RenderNodeUtils_GetShadowColor() 1086 1087``` 1088int32_t OH_ArkUI_RenderNodeUtils_GetShadowColor(ArkUI_RenderNodeHandle node, uint32_t* color) 1089``` 1090 1091**描述：** 1092获取渲染节点的阴影颜色。 1093 1094**起始版本：** 20 1095 1096**参数：** 1097| 参数项 | 描述 | 1098| -- | -- | 1099| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1100| uint32_t* color | 用于存储获取到的RGBA颜色值的整数指针。<br/>默认值：0xFF000000。<br>**颜色字节布局说明：**<br>- 位24-31：Alpha通道（0x00完全透明，0xFF完全不透明）。<br>- 位16-23：红色通道。<br>- 位8-15：绿色通道。<br>- 位0-7：蓝色通道。 | 1101 1102**返回：** 1103| 类型 | 说明 | 1104| -- | -- | 1105| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1106 1107### OH_ArkUI_RenderNodeUtils_SetShadowOffset() 1108 1109``` 1110int32_t OH_ArkUI_RenderNodeUtils_SetShadowOffset(ArkUI_RenderNodeHandle node, int32_t x, int32_t y) 1111``` 1112 1113**描述：** 1114为渲染节点设置阴影偏移量。 1115 1116**起始版本：** 20 1117 1118**参数：** 1119| 参数项 | 描述 | 1120| -- | -- | 1121| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1122| int32_t x | 水平偏移值（以像素为单位）。<br/>默认值：0。 | 1123| int32_t y | 垂直偏移值（以像素为单位）。<br/>默认值：0。 | 1124 1125**返回：** 1126| 类型 | 说明 | 1127| -- | -- | 1128| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1129 1130### OH_ArkUI_RenderNodeUtils_GetShadowOffset() 1131 1132``` 1133int32_t OH_ArkUI_RenderNodeUtils_GetShadowOffset(ArkUI_RenderNodeHandle node, int32_t* x, int32_t* y) 1134``` 1135 1136**描述：** 1137获取渲染节点的阴影偏移量。 1138 1139**起始版本：** 20 1140 1141**参数：** 1142| 参数项 | 描述 | 1143| -- | -- | 1144| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1145| int32_t* x | 用于接收水平偏移值的指针。<br/>默认值：0。 | 1146| int32_t* y | 用于接收垂直偏移值的指针。<br/>默认值：0。 | 1147 1148**返回：** 1149| 类型 | 说明 | 1150| -- | -- | 1151| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1152 1153### OH_ArkUI_RenderNodeUtils_SetShadowAlpha() 1154 1155``` 1156int32_t OH_ArkUI_RenderNodeUtils_SetShadowAlpha(ArkUI_RenderNodeHandle node, float alpha) 1157``` 1158 1159**描述：** 1160为渲染节点设置阴影透明度。 1161 1162**起始版本：** 20 1163 1164**参数：** 1165| 参数项 | 描述 | 1166| -- | -- | 1167| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1168| float alpha | 阴影 Alpha 值（0.0-1.0）。<br/>默认值：0。 | 1169 1170**返回：** 1171| 类型 | 说明 | 1172| -- | -- | 1173| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_PARAM_OUT_OF_RANGE](capi-native-type-h.md#arkui_errorcode) 参数超出范围。 1174 1175### OH_ArkUI_RenderNodeUtils_GetShadowAlpha() 1176 1177``` 1178int32_t OH_ArkUI_RenderNodeUtils_GetShadowAlpha(ArkUI_RenderNodeHandle node, float* alpha) 1179``` 1180 1181**描述：** 1182获取渲染节点的阴影透明度。 1183 1184**起始版本：** 20 1185 1186**参数：** 1187| 参数项 | 描述 | 1188| -- | -- | 1189| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1190| float* alpha | 用于接收阴影 Alpha 值的指针。<br/>默认值：1。 | 1191 1192**返回：** 1193| 类型 | 说明 | 1194| -- | -- | 1195| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1196 1197### OH_ArkUI_RenderNodeUtils_SetShadowElevation() 1198 1199``` 1200int32_t OH_ArkUI_RenderNodeUtils_SetShadowElevation(ArkUI_RenderNodeHandle node, float elevation) 1201``` 1202 1203**描述：** 1204为渲染节点设置阴影高度。 1205 1206**起始版本：** 20 1207 1208**参数：** 1209| 参数项 | 描述 | 1210| -- | -- | 1211| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1212| float elevation | 高度值。<br/>默认值：0。 | 1213 1214**返回：** 1215| 类型 | 说明 | 1216| -- | -- | 1217| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_PARAM_OUT_OF_RANGE](capi-native-type-h.md#arkui_errorcode) 参数超出范围。 1218 1219### OH_ArkUI_RenderNodeUtils_GetShadowElevation() 1220 1221``` 1222int32_t OH_ArkUI_RenderNodeUtils_GetShadowElevation(ArkUI_RenderNodeHandle node, float* elevation) 1223``` 1224 1225**描述：** 1226获取渲染节点的阴影高度。 1227 1228**起始版本：** 20 1229 1230**参数：** 1231| 参数项 | 描述 | 1232| -- | -- | 1233| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1234| float* elevation | 用于接收高度值的指针。<br/>默认值：0。 | 1235 1236**返回：** 1237| 类型 | 说明 | 1238| -- | -- | 1239| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1240 1241### OH_ArkUI_RenderNodeUtils_SetShadowRadius() 1242 1243``` 1244int32_t OH_ArkUI_RenderNodeUtils_SetShadowRadius(ArkUI_RenderNodeHandle node, float radius) 1245``` 1246 1247**描述：** 1248为渲染节点设置阴影半径。 1249 1250**起始版本：** 20 1251 1252**参数：** 1253| 参数项 | 描述 | 1254| -- | -- | 1255| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1256| float radius | 半径值。<br/>默认值：0。 | 1257 1258**返回：** 1259| 类型 | 说明 | 1260| -- | -- | 1261| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_PARAM_OUT_OF_RANGE](capi-native-type-h.md#arkui_errorcode) 参数超出范围。 1262 1263### OH_ArkUI_RenderNodeUtils_GetShadowRadius() 1264 1265``` 1266int32_t OH_ArkUI_RenderNodeUtils_GetShadowRadius(ArkUI_RenderNodeHandle node, float* radius) 1267``` 1268 1269**描述：** 1270获取渲染节点的阴影半径。 1271 1272**起始版本：** 20 1273 1274**参数：** 1275| 参数项 | 描述 | 1276| -- | -- | 1277| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1278| float* radius | 用于接收半径值的指针。<br/>默认值：0。 | 1279 1280**返回：** 1281| 类型 | 说明 | 1282| -- | -- | 1283| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1284 1285### OH_ArkUI_RenderNodeUtils_SetBorderStyle() 1286 1287``` 1288int32_t OH_ArkUI_RenderNodeUtils_SetBorderStyle(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderStyleOption* borderStyle) 1289``` 1290 1291**描述：** 1292为渲染节点设置边框样式。 1293 1294**起始版本：** 20 1295 1296**参数：** 1297| 参数项 | 描述 | 1298| -- | -- | 1299| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1300| [ArkUI_NodeBorderStyleOption](./capi-arkui-nativemodule-arkui-nodeborderstyleoption.md)* borderStyle | 边框样式的指针。<br/>结构体指针内默认值：[ARKUI_BORDER_STYLE_SOLID](capi-native-type-h.md#arkui_borderstyle)。 | 1301 1302**返回：** 1303| 类型 | 说明 | 1304| -- | -- | 1305| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1306 1307### OH_ArkUI_RenderNodeUtils_GetBorderStyle() 1308 1309``` 1310int32_t OH_ArkUI_RenderNodeUtils_GetBorderStyle(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderStyleOption** borderStyle) 1311``` 1312 1313**描述：** 1314获取渲染节点的边框样式。 1315 1316**起始版本：** 20 1317 1318**参数：** 1319| 参数项 | 描述 | 1320| -- | -- | 1321| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1322| [ArkUI_NodeBorderStyleOption](./capi-arkui-nativemodule-arkui-nodeborderstyleoption.md)** borderStyle | 用于接收边框样式的指针。<br/>结构体指针内默认值：[ARKUI_BORDER_STYLE_SOLID](capi-native-type-h.md#arkui_borderstyle)。 | 1323 1324**返回：** 1325| 类型 | 说明 | 1326| -- | -- | 1327| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1328 1329### OH_ArkUI_RenderNodeUtils_SetBorderWidth() 1330 1331``` 1332int32_t OH_ArkUI_RenderNodeUtils_SetBorderWidth(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderWidthOption* borderWidth) 1333``` 1334 1335**描述：** 1336为渲染节点设置边框宽度，边框宽度需小于节点尺寸。 1337 1338**起始版本：** 20 1339 1340**参数：** 1341| 参数项 | 描述 | 1342| -- | -- | 1343| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1344| [ArkUI_NodeBorderWidthOption](./capi-arkui-nativemodule-arkui-nodeborderwidthoption.md)* borderWidth | 边框宽度的指针。<br/>结构体指针内默认值：0。单位：px。 | 1345 1346**返回：** 1347| 类型 | 说明 | 1348| -- | -- | 1349| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1350 1351### OH_ArkUI_RenderNodeUtils_GetBorderWidth() 1352 1353``` 1354int32_t OH_ArkUI_RenderNodeUtils_GetBorderWidth(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderWidthOption** borderWidth) 1355``` 1356 1357**描述：** 1358获取渲染节点的边框宽度。 1359 1360**起始版本：** 20 1361 1362**参数：** 1363| 参数项 | 描述 | 1364| -- | -- | 1365| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1366| [ArkUI_NodeBorderWidthOption](./capi-arkui-nativemodule-arkui-nodeborderwidthoption.md)** borderWidth | 用于接收边框宽度的指针。<br/>结构体指针内默认值：0。单位：px。 | 1367 1368**返回：** 1369| 类型 | 说明 | 1370| -- | -- | 1371| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1372 1373### OH_ArkUI_RenderNodeUtils_SetBorderColor() 1374 1375``` 1376int32_t OH_ArkUI_RenderNodeUtils_SetBorderColor(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderColorOption* borderColor) 1377``` 1378 1379**描述：** 1380为渲染节点设置边框颜色。 1381 1382**起始版本：** 20 1383 1384**参数：** 1385| 参数项 | 描述 | 1386| -- | -- | 1387| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1388| [ArkUI_NodeBorderColorOption](./capi-arkui-nativemodule-arkui-nodebordercoloroption.md)* borderColor | 边框颜色的指针。<br/>结构体指针内默认值：0x00000000。 | 1389 1390**返回：** 1391| 类型 | 说明 | 1392| -- | -- | 1393| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1394 1395### OH_ArkUI_RenderNodeUtils_GetBorderColor() 1396 1397``` 1398int32_t OH_ArkUI_RenderNodeUtils_GetBorderColor(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderColorOption** borderColor) 1399``` 1400 1401**描述：** 1402获取渲染节点的边框颜色。 1403 1404**起始版本：** 20 1405 1406**参数：** 1407| 参数项 | 描述 | 1408| -- | -- | 1409| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1410| [ArkUI_NodeBorderColorOption](./capi-arkui-nativemodule-arkui-nodebordercoloroption.md)** borderColor | 用于接收边框颜色的指针。<br/>结构体指针内默认值：0x00000000。 | 1411 1412**返回：** 1413| 类型 | 说明 | 1414| -- | -- | 1415| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1416 1417### OH_ArkUI_RenderNodeUtils_SetBorderRadius() 1418 1419``` 1420int32_t OH_ArkUI_RenderNodeUtils_SetBorderRadius(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderRadiusOption* borderRadius) 1421``` 1422 1423**描述：** 1424为渲染节点设置边框角半径。 1425 1426**起始版本：** 20 1427 1428**参数：** 1429| 参数项 | 描述 | 1430| -- | -- | 1431| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1432| [ArkUI_NodeBorderRadiusOption](./capi-arkui-nativemodule-arkui-nodeborderradiusoption.md)* borderRadius | 边框半径的指针。<br/>结构体指针内默认值：0。 | 1433 1434**返回：** 1435| 类型 | 说明 | 1436| -- | -- | 1437| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1438 1439### OH_ArkUI_RenderNodeUtils_GetBorderRadius() 1440 1441``` 1442int32_t OH_ArkUI_RenderNodeUtils_GetBorderRadius(ArkUI_RenderNodeHandle node, ArkUI_NodeBorderRadiusOption** borderRadius) 1443``` 1444 1445**描述：** 1446获取渲染节点的边框角半径。 1447 1448**起始版本：** 20 1449 1450**参数：** 1451| 参数项 | 描述 | 1452| -- | -- | 1453| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1454| [ArkUI_NodeBorderRadiusOption](./capi-arkui-nativemodule-arkui-nodeborderradiusoption.md)** borderRadius | 用于接收边框半径的指针。<br/>结构体指针内默认值：0。 | 1455 1456**返回：** 1457| 类型 | 说明 | 1458| -- | -- | 1459| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1460 1461### OH_ArkUI_RenderNodeUtils_SetMask() 1462 1463``` 1464int32_t OH_ArkUI_RenderNodeUtils_SetMask(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeMaskOption* mask) 1465``` 1466 1467**描述：** 1468使用遮罩配置为渲染节点应用遮罩。<br> 遮罩创建方式如下：<br> 1.给遮罩图层增加亮度和线性颜色滤镜。<br> 2.在该滤镜下绘制遮罩图形。<br> 3. 1469将原节点图像作为源颜色，遮罩图形为目标颜色，通过[BlendMode.SRC_IN](../apis-arkgraphics2d/arkts-apis-graphics-drawing-e.md#blendmode)方式混合成Mask图像。 1470 1471**起始版本：** 20 1472 1473**参数：** 1474| 参数项 | 描述 | 1475| -- | -- | 1476| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1477| [ArkUI_RenderNodeMaskOption](./capi-arkui-nativemodule-arkui-rendernodemaskoption.md)* mask | 遮罩配置的指针。 | 1478 1479**返回：** 1480| 类型 | 说明 | 1481| -- | -- | 1482| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1483 1484### OH_ArkUI_RenderNodeUtils_SetClip() 1485 1486``` 1487int32_t OH_ArkUI_RenderNodeUtils_SetClip(ArkUI_RenderNodeHandle node, ArkUI_RenderNodeClipOption* clip) 1488``` 1489 1490**描述：** 1491使用裁剪配置为渲染节点应用裁剪。 1492 1493**起始版本：** 20 1494 1495**参数：** 1496| 参数项 | 描述 | 1497| -- | -- | 1498| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1499| [ArkUI_RenderNodeClipOption](./capi-arkui-nativemodule-arkui-rendernodeclipoption.md)* clip | 裁剪配置的指针。 | 1500 1501**返回：** 1502| 类型 | 说明 | 1503| -- | -- | 1504| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1505 1506### OH_ArkUI_RenderNodeUtils_SetMarkNodeGroup() 1507 1508``` 1509int32_t OH_ArkUI_RenderNodeUtils_SetMarkNodeGroup(ArkUI_RenderNodeHandle node, bool markNodeGroup) 1510``` 1511 1512**描述：** 1513标记是否优先绘制该节点及其子节点。 1514 1515**起始版本：** 20 1516 1517**参数：** 1518| 参数项 | 描述 | 1519| -- | -- | 1520| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1521| bool markNodeGroup | 布尔值，是否优先绘制该节点及其子节点。 | 1522 1523**返回：** 1524| 类型 | 说明 | 1525| -- | -- | 1526| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1527 1528### OH_ArkUI_RenderNodeUtils_SetBounds() 1529 1530``` 1531int32_t OH_ArkUI_RenderNodeUtils_SetBounds(ArkUI_RenderNodeHandle node, int32_t x, int32_t y, int32_t width, int32_t height) 1532``` 1533 1534**描述：** 1535为渲染节点设置边界。 1536 1537**起始版本：** 20 1538 1539**参数：** 1540| 参数项 | 描述 | 1541| -- | -- | 1542| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1543| int32_t x | 边界左上角的X坐标（以像素为单位）。<br/>默认值：0。 | 1544| int32_t y | 边界左上角的Y坐标（以像素为单位）。<br/>默认值：0。 | 1545| int32_t width | 边界的宽度（以像素为单位）。<br/>默认值：0。 | 1546| int32_t height | 边界的高度（以像素为单位）。<br/>默认值：0。 | 1547 1548**返回：** 1549| 类型 | 说明 | 1550| -- | -- | 1551| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。<br> [ARKUI_ERROR_CODE_PARAM_OUT_OF_RANGE](capi-native-type-h.md#arkui_errorcode) 参数超出范围。 1552 1553### OH_ArkUI_RenderNodeUtils_GetBounds() 1554 1555``` 1556int32_t OH_ArkUI_RenderNodeUtils_GetBounds(ArkUI_RenderNodeHandle node, int32_t* x, int32_t* y, int32_t* width, int32_t* height) 1557``` 1558 1559**描述：** 1560获取渲染节点的边界。 1561 1562**起始版本：** 20 1563 1564**参数：** 1565| 参数项 | 描述 | 1566| -- | -- | 1567| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1568| int32_t* x | 用于接收边界左上角X坐标（以像素为单位）的指针。<br/>默认值：0。 | 1569| int32_t* y | 用于接收边界左上角Y坐标（以像素为单位）的指针。<br/>默认值：0。 | 1570| int32_t* width | 用于接收边界宽度（以像素为单位）的指针。<br/>默认值：0。 | 1571| int32_t* height | 用于接收边界高度（以像素为单位）的指针。<br/>默认值：0。 | 1572 1573**返回：** 1574| 类型 | 说明 | 1575| -- | -- | 1576| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1577 1578### OH_ArkUI_RenderNodeUtils_SetDrawRegion() 1579 1580``` 1581int32_t OH_ArkUI_RenderNodeUtils_SetDrawRegion(ArkUI_RenderNodeHandle node, float x, float y, float w, float h) 1582``` 1583 1584**描述：** 1585为渲染节点设置绘制区域，该绘制区域主要用于超出边界导致的绘制问题，建议根据实际绘制范围设置大小。 1586 1587**起始版本：** 20 1588 1589**参数：** 1590| 参数项 | 描述 | 1591| -- | -- | 1592| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1593| float x | 边界左上角的X坐标（以像素为单位）。 | 1594| float y | 边界左上角的Y坐标（以像素为单位）。 | 1595| float w | 边界的宽度（以像素为单位）。 | 1596| float h | 边界的高度（以像素为单位）。 | 1597 1598**返回：** 1599| 类型 | 说明 | 1600| -- | -- | 1601| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1602 1603### OH_ArkUI_RenderNodeUtils_AttachContentModifier() 1604 1605``` 1606int32_t OH_ArkUI_RenderNodeUtils_AttachContentModifier(ArkUI_RenderNodeHandle node, ArkUI_RenderContentModifierHandle modifier) 1607``` 1608 1609**描述：** 1610为渲染节点添加内容修改器。 1611 1612**起始版本：** 20 1613 1614**参数：** 1615| 参数项 | 描述 | 1616| -- | -- | 1617| [ArkUI_RenderNodeHandle](./capi-arkui-nativemodule-arkui-rendernodehandle.md) node | 目标渲染节点。 | 1618| [ArkUI_RenderContentModifierHandle](./capi-arkui-nativemodule-arkui-rendercontentmodifierhandle.md) modifier | 内容修改器。 | 1619 1620**返回：** 1621| 类型 | 说明 | 1622| -- | -- | 1623| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1624 1625### OH_ArkUI_RenderNodeUtils_CreateContentModifier() 1626 1627``` 1628ArkUI_RenderContentModifierHandle OH_ArkUI_RenderNodeUtils_CreateContentModifier() 1629``` 1630 1631**描述：** 1632创建内容修改器。 1633 1634**起始版本：** 20 1635 1636**返回：** 1637| 类型 | 说明 | 1638| -- | -- | 1639| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1640 1641### OH_ArkUI_RenderNodeUtils_DisposeContentModifier() 1642 1643``` 1644void OH_ArkUI_RenderNodeUtils_DisposeContentModifier(ArkUI_RenderContentModifierHandle modifier) 1645``` 1646 1647**描述：** 1648释放内容修改器。 1649 1650**起始版本：** 20 1651 1652**参数：** 1653| 参数项 | 描述 | 1654| -- | -- | 1655| [ArkUI_RenderContentModifierHandle](./capi-arkui-nativemodule-arkui-rendercontentmodifierhandle.md) modifier | 内容修改器。 | 1656 1657### OH_ArkUI_RenderNodeUtils_AttachFloatProperty() 1658 1659``` 1660int32_t OH_ArkUI_RenderNodeUtils_AttachFloatProperty(ArkUI_RenderContentModifierHandle modifier, ArkUI_FloatPropertyHandle property) 1661``` 1662 1663**描述：** 1664为目标内容修改器附加浮点属性。 1665 1666**起始版本：** 20 1667 1668**参数：** 1669| 参数项 | 描述 | 1670| -- | -- | 1671| [ArkUI_RenderContentModifierHandle](./capi-arkui-nativemodule-arkui-rendercontentmodifierhandle.md) modifier | 为目标内容修改器设置浮点属性。 | 1672| ArkUI_FloatPropertyHandle property | 浮点属性。 | 1673 1674**返回：** 1675| 类型 | 说明 | 1676| -- | -- | 1677| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1678 1679### OH_ArkUI_RenderNodeUtils_AttachVector2Property() 1680 1681``` 1682int32_t OH_ArkUI_RenderNodeUtils_AttachVector2Property(ArkUI_RenderContentModifierHandle modifier, ArkUI_Vector2PropertyHandle property) 1683``` 1684 1685**描述：** 1686为目标内容修改器附加二维向量属性。 1687 1688**起始版本：** 20 1689 1690**参数：** 1691| 参数项 | 描述 | 1692| -- | -- | 1693| [ArkUI_RenderContentModifierHandle](./capi-arkui-nativemodule-arkui-rendercontentmodifierhandle.md) modifier | 为目标内容修改器设置二维向量属性。 | 1694| [ArkUI_Vector2PropertyHandle](./capi-arkui-nativemodule-arkui-vector2propertyhandle.md) property | 二维向量属性。 | 1695 1696**返回：** 1697| 类型 | 说明 | 1698| -- | -- | 1699| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1700 1701### OH_ArkUI_RenderNodeUtils_AttachColorProperty() 1702 1703``` 1704int32_t OH_ArkUI_RenderNodeUtils_AttachColorProperty(ArkUI_RenderContentModifierHandle modifier, ArkUI_ColorPropertyHandle property) 1705``` 1706 1707**描述：** 1708为目标内容修改器附加颜色属性。 1709 1710**起始版本：** 20 1711 1712**参数：** 1713| 参数项 | 描述 | 1714| -- | -- | 1715| [ArkUI_RenderContentModifierHandle](./capi-arkui-nativemodule-arkui-rendercontentmodifierhandle.md) modifier | 为目标内容修改器设置颜色属性。 | 1716| [ArkUI_ColorPropertyHandle](./capi-arkui-nativemodule-arkui-colorpropertyhandle.md) property | 颜色属性。 | 1717 1718**返回：** 1719| 类型 | 说明 | 1720| -- | -- | 1721| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1722 1723### OH_ArkUI_RenderNodeUtils_AttachFloatAnimatableProperty() 1724 1725``` 1726int32_t OH_ArkUI_RenderNodeUtils_AttachFloatAnimatableProperty(ArkUI_RenderContentModifierHandle modifier, ArkUI_FloatAnimatablePropertyHandle property) 1727``` 1728 1729**描述：** 1730为目标内容修改器附加可动画的浮点属性。 1731 1732**起始版本：** 20 1733 1734**参数：** 1735| 参数项 | 描述 | 1736| -- | -- | 1737| [ArkUI_RenderContentModifierHandle](./capi-arkui-nativemodule-arkui-rendercontentmodifierhandle.md) modifier | 为目标内容修改器设置可动画的浮点属性。 | 1738| [ArkUI_FloatAnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-floatanimatablepropertyhandle.md) property | 可动画的浮点属性。 | 1739 1740**返回：** 1741| 类型 | 说明 | 1742| -- | -- | 1743| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1744 1745### OH_ArkUI_RenderNodeUtils_AttachVector2AnimatableProperty() 1746 1747``` 1748int32_t OH_ArkUI_RenderNodeUtils_AttachVector2AnimatableProperty(ArkUI_RenderContentModifierHandle modifier, ArkUI_Vector2AnimatablePropertyHandle property) 1749``` 1750 1751**描述：** 1752为目标内容修改器附加可动画的二维向量属性。 1753 1754**起始版本：** 20 1755 1756**参数：** 1757| 参数项 | 描述 | 1758| -- | -- | 1759| [ArkUI_RenderContentModifierHandle](./capi-arkui-nativemodule-arkui-rendercontentmodifierhandle.md) modifier | 为目标内容修改器设置可动画的二维向量属性。 | 1760| [ArkUI_Vector2AnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-vector2animatablepropertyhandle.md) property | 可动画的二维向量属性。 | 1761 1762**返回：** 1763| 类型 | 说明 | 1764| -- | -- | 1765| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1766 1767### OH_ArkUI_RenderNodeUtils_AttachColorAnimatableProperty() 1768 1769``` 1770int32_t OH_ArkUI_RenderNodeUtils_AttachColorAnimatableProperty(ArkUI_RenderContentModifierHandle modifier, ArkUI_ColorAnimatablePropertyHandle property) 1771``` 1772 1773**描述：** 1774为目标内容修改器附加可动画的颜色属性。 1775 1776**起始版本：** 20 1777 1778**参数：** 1779| 参数项 | 描述 | 1780| -- | -- | 1781| [ArkUI_RenderContentModifierHandle](./capi-arkui-nativemodule-arkui-rendercontentmodifierhandle.md) modifier | 为目标内容修改器设置可动画的颜色属性。 | 1782| [ArkUI_ColorAnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-coloranimatablepropertyhandle.md) property | 可动画的颜色属性。 | 1783 1784**返回：** 1785| 类型 | 说明 | 1786| -- | -- | 1787| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1788 1789### OH_ArkUI_RenderNodeUtils_CreateFloatProperty() 1790 1791``` 1792ArkUI_FloatPropertyHandle OH_ArkUI_RenderNodeUtils_CreateFloatProperty(float value) 1793``` 1794 1795**描述：** 1796创建浮点属性。 1797 1798**起始版本：** 20 1799 1800**参数：** 1801| 参数项 | 描述 | 1802| -- | -- | 1803| float value | 属性值。 | 1804 1805**返回：** 1806| 类型 | 说明 | 1807| -- | -- | 1808| [ArkUI_FloatPropertyHandle](./capi-arkui-nativemodule-arkui-floatpropertyhandle.md) | 浮点属性。 1809 1810### OH_ArkUI_RenderNodeUtils_SetFloatPropertyValue() 1811 1812``` 1813int32_t OH_ArkUI_RenderNodeUtils_SetFloatPropertyValue(ArkUI_FloatPropertyHandle property, float value) 1814``` 1815 1816**描述：** 1817设置浮点属性的值。 1818 1819**起始版本：** 20 1820 1821**参数：** 1822| 参数项 | 描述 | 1823| -- | -- | 1824| [ArkUI_FloatPropertyHandle](./capi-arkui-nativemodule-arkui-floatpropertyhandle.md) property | 浮点属性。 | 1825| float value | 属性值。 | 1826 1827**返回：** 1828| 类型 | 说明 | 1829| -- | -- | 1830| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1831 1832### OH_ArkUI_RenderNodeUtils_GetFloatPropertyValue() 1833 1834``` 1835int32_t OH_ArkUI_RenderNodeUtils_GetFloatPropertyValue(ArkUI_FloatPropertyHandle property, float* value) 1836``` 1837 1838**描述：** 1839获取浮点属性的值。 1840 1841**起始版本：** 20 1842 1843**参数：** 1844| 参数项 | 描述 | 1845| -- | -- | 1846| [ArkUI_FloatPropertyHandle](./capi-arkui-nativemodule-arkui-floatpropertyhandle.md) property | 浮点属性。 | 1847| float* value | 用于接收属性值的指针。 | 1848 1849**返回：** 1850| 类型 | 说明 | 1851| -- | -- | 1852| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1853 1854### OH_ArkUI_RenderNodeUtils_DisposeFloatProperty() 1855 1856``` 1857void OH_ArkUI_RenderNodeUtils_DisposeFloatProperty(ArkUI_FloatPropertyHandle property) 1858``` 1859 1860**描述：** 1861释放浮点属性。 1862 1863**起始版本：** 20 1864 1865**参数：** 1866| 参数项 | 描述 | 1867| -- | -- | 1868| [ArkUI_FloatPropertyHandle](./capi-arkui-nativemodule-arkui-floatpropertyhandle.md) property | 浮点属性。 | 1869 1870### OH_ArkUI_RenderNodeUtils_CreateVector2Property() 1871 1872``` 1873ArkUI_Vector2PropertyHandle OH_ArkUI_RenderNodeUtils_CreateVector2Property(float x, float y) 1874``` 1875 1876**描述：** 1877创建二维向量属性。 1878 1879**起始版本：** 20 1880 1881**参数：** 1882| 参数项 | 描述 | 1883| -- | -- | 1884| float x | 属性的X坐标值。 | 1885| float y | 属性的Y坐标值。 | 1886 1887**返回：** 1888| 类型 | 说明 | 1889| -- | -- | 1890| [ArkUI_Vector2PropertyHandle](./capi-arkui-nativemodule-arkui-vector2propertyhandle.md) | 二维向量属性。 1891 1892### OH_ArkUI_RenderNodeUtils_SetVector2PropertyValue() 1893 1894``` 1895int32_t OH_ArkUI_RenderNodeUtils_SetVector2PropertyValue(ArkUI_Vector2PropertyHandle property, float x, float y) 1896``` 1897 1898**描述：** 1899设置二维向量属性的值。 1900 1901**起始版本：** 20 1902 1903**参数：** 1904| 参数项 | 描述 | 1905| -- | -- | 1906| [ArkUI_Vector2PropertyHandle](./capi-arkui-nativemodule-arkui-vector2propertyhandle.md) property | 二维向量属性。 | 1907| float x | 属性的X坐标值。 | 1908| float y | 属性的Y坐标值。 | 1909 1910**返回：** 1911| 类型 | 说明 | 1912| -- | -- | 1913| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1914 1915### OH_ArkUI_RenderNodeUtils_GetVector2PropertyValue() 1916 1917``` 1918int32_t OH_ArkUI_RenderNodeUtils_GetVector2PropertyValue(ArkUI_Vector2PropertyHandle property, float* x, float* y) 1919``` 1920 1921**描述：** 1922获取二维向量属性的值。 1923 1924**起始版本：** 20 1925 1926**参数：** 1927| 参数项 | 描述 | 1928| -- | -- | 1929| [ArkUI_Vector2PropertyHandle](./capi-arkui-nativemodule-arkui-vector2propertyhandle.md) property | 二维向量属性。 | 1930| float* x | 用于接收属性X坐标值的指针。 | 1931| float* y | 用于接收属性Y坐标值的指针。 | 1932 1933**返回：** 1934| 类型 | 说明 | 1935| -- | -- | 1936| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1937 1938### OH_ArkUI_RenderNodeUtils_DisposeVector2Property() 1939 1940``` 1941void OH_ArkUI_RenderNodeUtils_DisposeVector2Property(ArkUI_Vector2PropertyHandle property) 1942``` 1943 1944**描述：** 1945释放二维向量属性。 1946 1947**起始版本：** 20 1948 1949**参数：** 1950| 参数项 | 描述 | 1951| -- | -- | 1952| [ArkUI_Vector2PropertyHandle](./capi-arkui-nativemodule-arkui-vector2propertyhandle.md) property | 二维向量属性。 | 1953 1954### OH_ArkUI_RenderNodeUtils_CreateColorProperty() 1955 1956``` 1957ArkUI_ColorPropertyHandle OH_ArkUI_RenderNodeUtils_CreateColorProperty(uint32_t value) 1958``` 1959 1960**描述：** 1961创建颜色属性。 1962 1963**起始版本：** 20 1964 1965**参数：** 1966| 参数项 | 描述 | 1967| -- | -- | 1968| uint32_t value | 属性值。 | 1969 1970**返回：** 1971| 类型 | 说明 | 1972| -- | -- | 1973| [ArkUI_ColorPropertyHandle](./capi-arkui-nativemodule-arkui-colorpropertyhandle.md) | 颜色属性。 1974 1975### OH_ArkUI_RenderNodeUtils_SetColorPropertyValue() 1976 1977``` 1978int32_t OH_ArkUI_RenderNodeUtils_SetColorPropertyValue(ArkUI_ColorPropertyHandle property, uint32_t value) 1979``` 1980 1981**描述：** 1982设置颜色属性的值。 1983 1984**起始版本：** 20 1985 1986**参数：** 1987| 参数项 | 描述 | 1988| -- | -- | 1989| [ArkUI_ColorPropertyHandle](./capi-arkui-nativemodule-arkui-colorpropertyhandle.md) property | 颜色属性。 | 1990| uint32_t value | 属性值。 | 1991 1992**返回：** 1993| 类型 | 说明 | 1994| -- | -- | 1995| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 1996 1997### OH_ArkUI_RenderNodeUtils_GetColorPropertyValue() 1998 1999``` 2000int32_t OH_ArkUI_RenderNodeUtils_GetColorPropertyValue(ArkUI_ColorPropertyHandle property, uint32_t* value) 2001``` 2002 2003**描述：** 2004获取颜色属性的值。 2005 2006**起始版本：** 20 2007 2008**参数：** 2009| 参数项 | 描述 | 2010| -- | -- | 2011| [ArkUI_ColorPropertyHandle](./capi-arkui-nativemodule-arkui-colorpropertyhandle.md) property | 颜色属性。 | 2012| uint32_t* value | 用于接收属性值的指针。 | 2013 2014**返回：** 2015| 类型 | 说明 | 2016| -- | -- | 2017| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 2018 2019### OH_ArkUI_RenderNodeUtils_DisposeColorProperty() 2020 2021``` 2022void OH_ArkUI_RenderNodeUtils_DisposeColorProperty(ArkUI_ColorPropertyHandle property) 2023``` 2024 2025**描述：** 2026释放颜色属性。 2027 2028**起始版本：** 20 2029 2030**参数：** 2031| 参数项 | 描述 | 2032| -- | -- | 2033| [ArkUI_ColorPropertyHandle](./capi-arkui-nativemodule-arkui-colorpropertyhandle.md) property | 颜色属性。 | 2034 2035### OH_ArkUI_RenderNodeUtils_CreateFloatAnimatableProperty() 2036 2037``` 2038ArkUI_FloatAnimatablePropertyHandle OH_ArkUI_RenderNodeUtils_CreateFloatAnimatableProperty(float value) 2039``` 2040 2041**描述：** 2042创建可动画的浮点属性。 2043 2044**起始版本：** 20 2045 2046**参数：** 2047| 参数项 | 描述 | 2048| -- | -- | 2049| float value | 属性值。 | 2050 2051**返回：** 2052| 类型 | 说明 | 2053| -- | -- | 2054| [ArkUI_FloatAnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-floatanimatablepropertyhandle.md) | 可动画的浮点属性。 2055 2056### OH_ArkUI_RenderNodeUtils_SetFloatAnimatablePropertyValue() 2057 2058``` 2059int32_t OH_ArkUI_RenderNodeUtils_SetFloatAnimatablePropertyValue(ArkUI_FloatAnimatablePropertyHandle property, float value) 2060``` 2061 2062**描述：** 2063设置可动画的浮点属性的值。 2064 2065**起始版本：** 20 2066 2067**参数：** 2068| 参数项 | 描述 | 2069| -- | -- | 2070| [ArkUI_FloatAnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-floatanimatablepropertyhandle.md) property | 可动画的浮点属性。 | 2071| float value | 属性值。 | 2072 2073**返回：** 2074| 类型 | 说明 | 2075| -- | -- | 2076| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 2077 2078### OH_ArkUI_RenderNodeUtils_GetFloatAnimatablePropertyValue() 2079 2080``` 2081int32_t OH_ArkUI_RenderNodeUtils_GetFloatAnimatablePropertyValue(ArkUI_FloatAnimatablePropertyHandle property, float* value) 2082``` 2083 2084**描述：** 2085获取可动画的浮点属性的值。 2086 2087**起始版本：** 20 2088 2089**参数：** 2090| 参数项 | 描述 | 2091| -- | -- | 2092| [ArkUI_FloatAnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-floatanimatablepropertyhandle.md) property | 可动画的浮点属性。 | 2093| float* value | 用于接收属性值的指针。 | 2094 2095**返回：** 2096| 类型 | 说明 | 2097| -- | -- | 2098| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 2099 2100### OH_ArkUI_RenderNodeUtils_DisposeFloatAnimatableProperty() 2101 2102``` 2103void OH_ArkUI_RenderNodeUtils_DisposeFloatAnimatableProperty(ArkUI_FloatAnimatablePropertyHandle property) 2104``` 2105 2106**描述：** 2107释放可动画的浮点属性。 2108 2109**起始版本：** 20 2110 2111**参数：** 2112| 参数项 | 描述 | 2113| -- | -- | 2114| [ArkUI_FloatAnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-floatanimatablepropertyhandle.md) property | 可动画的浮点属性。 | 2115 2116### OH_ArkUI_RenderNodeUtils_CreateVector2AnimatableProperty() 2117 2118``` 2119ArkUI_Vector2AnimatablePropertyHandle OH_ArkUI_RenderNodeUtils_CreateVector2AnimatableProperty(float x, float y) 2120``` 2121 2122**描述：** 2123创建可动画的二维向量属性。 2124 2125**起始版本：** 20 2126 2127**参数：** 2128| 参数项 | 描述 | 2129| -- | -- | 2130| float x | 属性的X坐标值。 | 2131| float y | 属性的Y坐标值。 | 2132 2133**返回：** 2134| 类型 | 说明 | 2135| -- | -- | 2136| [ArkUI_Vector2AnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-vector2animatablepropertyhandle.md) | 可动画的二维向量属性。 2137 2138### OH_ArkUI_RenderNodeUtils_SetVector2AnimatablePropertyValue() 2139 2140``` 2141int32_t OH_ArkUI_RenderNodeUtils_SetVector2AnimatablePropertyValue(ArkUI_Vector2AnimatablePropertyHandle property, float x, float y) 2142``` 2143 2144**描述：** 2145设置可动画的二维向量属性的值。 2146 2147**起始版本：** 20 2148 2149**参数：** 2150| 参数项 | 描述 | 2151| -- | -- | 2152| [ArkUI_Vector2AnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-vector2animatablepropertyhandle.md) property | 可动画的二维向量属性。 | 2153| float x | 属性的X坐标值。 | 2154| float y | 属性的Y坐标值。 | 2155 2156**返回：** 2157| 类型 | 说明 | 2158| -- | -- | 2159| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 2160 2161### OH_ArkUI_RenderNodeUtils_GetVector2AnimatablePropertyValue() 2162 2163``` 2164int32_t OH_ArkUI_RenderNodeUtils_GetVector2AnimatablePropertyValue(ArkUI_Vector2AnimatablePropertyHandle property, float* x, float* y) 2165``` 2166 2167**描述：** 2168获取可动画的二维向量属性的值。 2169 2170**起始版本：** 20 2171 2172**参数：** 2173| 参数项 | 描述 | 2174| -- | -- | 2175| [ArkUI_Vector2AnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-vector2animatablepropertyhandle.md) property | 可动画的二维向量属性。 | 2176| float* x | 用于接收属性X坐标值的指针。 | 2177| float* y | 用于接收属性Y坐标值的指针。 | 2178 2179**返回：** 2180| 类型 | 说明 | 2181| -- | -- | 2182| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 2183 2184### OH_ArkUI_RenderNodeUtils_DisposeVector2AnimatableProperty() 2185 2186``` 2187void OH_ArkUI_RenderNodeUtils_DisposeVector2AnimatableProperty(ArkUI_Vector2AnimatablePropertyHandle property) 2188``` 2189 2190**描述：** 2191释放可动画的二维向量属性。 2192 2193**起始版本：** 20 2194 2195**参数：** 2196| 参数项 | 描述 | 2197| -- | -- | 2198| [ArkUI_Vector2AnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-vector2animatablepropertyhandle.md) property | 可动画的二维向量属性。 | 2199 2200### OH_ArkUI_RenderNodeUtils_CreateColorAnimatableProperty() 2201 2202``` 2203ArkUI_ColorAnimatablePropertyHandle OH_ArkUI_RenderNodeUtils_CreateColorAnimatableProperty(uint32_t value) 2204``` 2205 2206**描述：** 2207创建可动画的颜色属性。 2208 2209**起始版本：** 20 2210 2211**参数：** 2212| 参数项 | 描述 | 2213| -- | -- | 2214| uint32_t value | 属性值。 | 2215 2216**返回：** 2217| 类型 | 说明 | 2218| -- | -- | 2219| [ArkUI_ColorAnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-coloranimatablepropertyhandle.md) | 可动画的颜色属性。 2220 2221### OH_ArkUI_RenderNodeUtils_SetColorAnimatablePropertyValue() 2222 2223``` 2224int32_t OH_ArkUI_RenderNodeUtils_SetColorAnimatablePropertyValue(ArkUI_ColorAnimatablePropertyHandle property, uint32_t value) 2225``` 2226 2227**描述：** 2228设置可动画的颜色属性的值。 2229 2230**起始版本：** 20 2231 2232**参数：** 2233| 参数项 | 描述 | 2234| -- | -- | 2235| [ArkUI_ColorAnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-coloranimatablepropertyhandle.md) property | 可动画的颜色属性。 | 2236| uint32_t value | 属性值。 | 2237 2238**返回：** 2239| 类型 | 说明 | 2240| -- | -- | 2241| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 2242 2243### OH_ArkUI_RenderNodeUtils_GetColorAnimatablePropertyValue() 2244 2245``` 2246int32_t OH_ArkUI_RenderNodeUtils_GetColorAnimatablePropertyValue(ArkUI_ColorAnimatablePropertyHandle property, uint32_t* value) 2247``` 2248 2249**描述：** 2250获取可动画的颜色属性的值。 2251 2252**起始版本：** 20 2253 2254**参数：** 2255| 参数项 | 描述 | 2256| -- | -- | 2257| [ArkUI_ColorAnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-coloranimatablepropertyhandle.md) property | 可动画的颜色属性。 | 2258| uint32_t* value | 用于接收属性值的指针。 | 2259 2260**返回：** 2261| 类型 | 说明 | 2262| -- | -- | 2263| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 2264 2265### OH_ArkUI_RenderNodeUtils_DisposeColorAnimatableProperty() 2266 2267``` 2268void OH_ArkUI_RenderNodeUtils_DisposeColorAnimatableProperty(ArkUI_ColorAnimatablePropertyHandle property) 2269``` 2270 2271**描述：** 2272释放可动画的颜色属性。 2273 2274**起始版本：** 20 2275 2276**参数：** 2277| 参数项 | 描述 | 2278| -- | -- | 2279| [ArkUI_ColorAnimatablePropertyHandle](./capi-arkui-nativemodule-arkui-coloranimatablepropertyhandle.md) property | 可动画的颜色属性。 | 2280 2281### OH_ArkUI_RenderNodeUtils_SetContentModifierOnDraw() 2282 2283``` 2284int32_t OH_ArkUI_RenderNodeUtils_SetContentModifierOnDraw(ArkUI_RenderContentModifierHandle modifier, void* userData, void (*callback)(ArkUI_DrawContext context, void* userData)) 2285``` 2286 2287**描述：** 2288设置内容修改器的 onDraw 函数。 2289 2290**起始版本：** 20 2291 2292**参数：** 2293| 参数项 | 描述 | 2294| -- | -- | 2295| [ArkUI_RenderContentModifierHandle](./capi-arkui-nativemodule-arkui-rendercontentmodifierhandle.md) modifier | 目标内容修改器。 | 2296| void* userData | 要传递给回调的自定义数据。 | 2297| void (callback)(ArkUI_DrawContext context, void* userData) | 绘制事件接收回调。 | 2298 2299**返回：** 2300| 类型 | 说明 | 2301| -- | -- | 2302| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 2303 2304### OH_ArkUI_RenderNodeUtils_CreateRectShapeOption() 2305 2306``` 2307ArkUI_RectShapeOption* OH_ArkUI_RenderNodeUtils_CreateRectShapeOption() 2308``` 2309 2310**描述：** 2311创建矩形形状。 2312 2313**起始版本：** 20 2314 2315**返回：** 2316| 类型 | 说明 | 2317| -- | -- | 2318| [ArkUI_RectShapeOption](./capi-arkui-nativemodule-arkui-rectshapeoption.md)* | 指向矩形形状的指针。 2319 2320### OH_ArkUI_RenderNodeUtils_DisposeRectShapeOption() 2321 2322``` 2323void OH_ArkUI_RenderNodeUtils_DisposeRectShapeOption(ArkUI_RectShapeOption* option) 2324``` 2325 2326**描述：** 2327释放矩形形状。 2328 2329**起始版本：** 20 2330 2331**参数：** 2332| 参数项 | 描述 | 2333| -- | -- | 2334| [ArkUI_RectShapeOption](./capi-arkui-nativemodule-arkui-rectshapeoption.md)* option | 指向矩形形状的指针。 | 2335 2336### OH_ArkUI_RenderNodeUtils_SetRectShapeOptionEdgeValue() 2337 2338``` 2339void OH_ArkUI_RenderNodeUtils_SetRectShapeOptionEdgeValue(ArkUI_RectShapeOption* option, float edgeValue, ArkUI_EdgeDirection direction) 2340``` 2341 2342**描述：** 2343设置矩形形状的边缘值。当设置左边界和上边界为负数时，因显示涉及到图层叠加效果，会导致部分超出节点内容部分无法绘制。 2344 2345**起始版本：** 20 2346 2347**参数：** 2348| 参数项 | 描述 | 2349| -- | -- | 2350| [ArkUI_RectShapeOption](./capi-arkui-nativemodule-arkui-rectshapeoption.md)* option | 指向矩形形状的指针。 | 2351| float edgeValue | 矩形形状的边缘值。 | 2352| [ArkUI_EdgeDirection](capi-native-type-h.md#arkui_edgedirection) direction | 要设置边缘值的矩形方向。 | 2353 2354### OH_ArkUI_RenderNodeUtils_CreateNodeBorderStyleOption() 2355 2356``` 2357ArkUI_NodeBorderStyleOption* OH_ArkUI_RenderNodeUtils_CreateNodeBorderStyleOption() 2358``` 2359 2360**描述：** 2361创建节点边框样式。 2362 2363**起始版本：** 20 2364 2365**返回：** 2366| 类型 | 说明 | 2367| -- | -- | 2368| [ArkUI_NodeBorderStyleOption](./capi-arkui-nativemodule-arkui-nodeborderstyleoption.md)* | 指向节点边框样式的指针。 2369 2370### OH_ArkUI_RenderNodeUtils_DisposeNodeBorderStyleOption() 2371 2372``` 2373void OH_ArkUI_RenderNodeUtils_DisposeNodeBorderStyleOption(ArkUI_NodeBorderStyleOption* option) 2374``` 2375 2376**描述：** 2377释放节点边框样式。 2378 2379**起始版本：** 20 2380 2381**参数：** 2382| 参数项 | 描述 | 2383| -- | -- | 2384| [ArkUI_NodeBorderStyleOption](./capi-arkui-nativemodule-arkui-nodeborderstyleoption.md)* option | 指向节点边框样式的指针。 | 2385 2386### OH_ArkUI_RenderNodeUtils_SetNodeBorderStyleOptionEdgeStyle() 2387 2388``` 2389void OH_ArkUI_RenderNodeUtils_SetNodeBorderStyleOptionEdgeStyle(ArkUI_NodeBorderStyleOption* option, ArkUI_BorderStyle edgeStyle, ArkUI_EdgeDirection direction) 2390``` 2391 2392**描述：** 2393设置节点边框样式的边缘值。 2394 2395**起始版本：** 20 2396 2397**参数：** 2398| 参数项 | 描述 | 2399| -- | -- | 2400| [ArkUI_NodeBorderStyleOption](./capi-arkui-nativemodule-arkui-nodeborderstyleoption.md)* option | 指向节点边框样式的指针。 | 2401| [ArkUI_BorderStyle](capi-native-type-h.md#arkui_borderstyle) edgeStyle | 节点边框样式的边缘边框样式值。 | 2402| [ArkUI_EdgeDirection](capi-native-type-h.md#arkui_edgedirection) direction | 边缘的方向。 | 2403 2404### OH_ArkUI_RenderNodeUtils_CreateNodeBorderWidthOption() 2405 2406``` 2407ArkUI_NodeBorderWidthOption* OH_ArkUI_RenderNodeUtils_CreateNodeBorderWidthOption() 2408``` 2409 2410**描述：** 2411创建节点边框宽度。 2412 2413**起始版本：** 20 2414 2415**返回：** 2416| 类型 | 说明 | 2417| -- | -- | 2418| [ArkUI_NodeBorderWidthOption](./capi-arkui-nativemodule-arkui-nodeborderwidthoption.md)* | 指向节点边框宽度的指针。 2419 2420### OH_ArkUI_RenderNodeUtils_DisposeNodeBorderWidthOption() 2421 2422``` 2423void OH_ArkUI_RenderNodeUtils_DisposeNodeBorderWidthOption(ArkUI_NodeBorderWidthOption* option) 2424``` 2425 2426**描述：** 2427释放节点边框宽度。 2428 2429**起始版本：** 20 2430 2431**参数：** 2432| 参数项 | 描述 | 2433| -- | -- | 2434| [ArkUI_NodeBorderWidthOption](./capi-arkui-nativemodule-arkui-nodeborderwidthoption.md)* option | 指向节点边框宽度的指针。 | 2435 2436### OH_ArkUI_RenderNodeUtils_SetNodeBorderWidthOptionEdgeWidth() 2437 2438``` 2439void OH_ArkUI_RenderNodeUtils_SetNodeBorderWidthOptionEdgeWidth(ArkUI_NodeBorderWidthOption* option, float edgeWidth, ArkUI_EdgeDirection direction) 2440``` 2441 2442**描述：** 2443设置节点边框宽度的边缘值。 2444 2445**起始版本：** 20 2446 2447**参数：** 2448| 参数项 | 描述 | 2449| -- | -- | 2450| [ArkUI_NodeBorderWidthOption](./capi-arkui-nativemodule-arkui-nodeborderwidthoption.md)* option | 指向节点边框宽度的指针。 | 2451| float edgeWidth | 节点边框宽度的边缘宽度值。<br>取值范围：[0, +∞) | 2452| [ArkUI_EdgeDirection](capi-native-type-h.md#arkui_edgedirection) direction | 边缘的方向。 | 2453 2454### OH_ArkUI_RenderNodeUtils_CreateNodeBorderColorOption() 2455 2456``` 2457ArkUI_NodeBorderColorOption* OH_ArkUI_RenderNodeUtils_CreateNodeBorderColorOption() 2458``` 2459 2460**描述：** 2461创建节点边框颜色。 2462 2463**起始版本：** 20 2464 2465**返回：** 2466| 类型 | 说明 | 2467| -- | -- | 2468| [ArkUI_NodeBorderColorOption](./capi-arkui-nativemodule-arkui-nodebordercoloroption.md)* | 指向节点边框颜色的指针。 2469 2470### OH_ArkUI_RenderNodeUtils_DisposeNodeBorderColorOption() 2471 2472``` 2473void OH_ArkUI_RenderNodeUtils_DisposeNodeBorderColorOption(ArkUI_NodeBorderColorOption* option) 2474``` 2475 2476**描述：** 2477释放节点边框颜色。 2478 2479**起始版本：** 20 2480 2481**参数：** 2482| 参数项 | 描述 | 2483| -- | -- | 2484| [ArkUI_NodeBorderColorOption](./capi-arkui-nativemodule-arkui-nodebordercoloroption.md)* option | 指向节点边框颜色的指针。 | 2485 2486### OH_ArkUI_RenderNodeUtils_SetNodeBorderColorOptionEdgeColor() 2487 2488``` 2489void OH_ArkUI_RenderNodeUtils_SetNodeBorderColorOptionEdgeColor(ArkUI_NodeBorderColorOption* option, uint32_t edgeColor, ArkUI_EdgeDirection direction) 2490``` 2491 2492**描述：** 2493设置节点边框颜色的边缘值。 2494 2495**起始版本：** 20 2496 2497**参数：** 2498| 参数项 | 描述 | 2499| -- | -- | 2500| [ArkUI_NodeBorderColorOption](./capi-arkui-nativemodule-arkui-nodebordercoloroption.md)* option | 指向节点边框颜色的指针。 | 2501| uint32_t edgeColor | 节点边框颜色的边缘颜色值。 | 2502| [ArkUI_EdgeDirection](capi-native-type-h.md#arkui_edgedirection) direction | 边缘的方向。 | 2503 2504### OH_ArkUI_RenderNodeUtils_CreateNodeBorderRadiusOption() 2505 2506``` 2507ArkUI_NodeBorderRadiusOption* OH_ArkUI_RenderNodeUtils_CreateNodeBorderRadiusOption() 2508``` 2509 2510**描述：** 2511创建节点边框半径。 2512 2513**起始版本：** 20 2514 2515**返回：** 2516| 类型 | 说明 | 2517| -- | -- | 2518| [ArkUI_NodeBorderRadiusOption](./capi-arkui-nativemodule-arkui-nodeborderradiusoption.md)* | 指向节点边框半径的指针。 2519 2520### OH_ArkUI_RenderNodeUtils_DisposeNodeBorderRadiusOption() 2521 2522``` 2523void OH_ArkUI_RenderNodeUtils_DisposeNodeBorderRadiusOption(ArkUI_NodeBorderRadiusOption* option) 2524``` 2525 2526**描述：** 2527释放节点边框半径。 2528 2529**起始版本：** 20 2530 2531**参数：** 2532| 参数项 | 描述 | 2533| -- | -- | 2534| [ArkUI_NodeBorderRadiusOption](./capi-arkui-nativemodule-arkui-nodeborderradiusoption.md)* option | 指向节点边框半径的指针。 | 2535 2536### OH_ArkUI_RenderNodeUtils_SetNodeBorderRadiusOptionCornerRadius() 2537 2538``` 2539void OH_ArkUI_RenderNodeUtils_SetNodeBorderRadiusOptionCornerRadius(ArkUI_NodeBorderRadiusOption* option, uint32_t cornerRadius, ArkUI_CornerDirection direction) 2540``` 2541 2542**描述：** 2543设置节点边框半径的边缘值。请注意，入参cornerRadius为uint32_t，仅支持传入正整数。 2544 2545**起始版本：** 20 2546 2547**参数：** 2548| 参数项 | 描述 | 2549| -- | -- | 2550| [ArkUI_NodeBorderRadiusOption](./capi-arkui-nativemodule-arkui-nodeborderradiusoption.md)* option | 指向节点边框半径的指针。 | 2551| uint32_t cornerRadius | 节点边框半径的边缘半径值。 | 2552| [ArkUI_CornerDirection](capi-native-type-h.md#arkui_cornerdirection) direction | 边缘的方向。 | 2553 2554### OH_ArkUI_RenderNodeUtils_CreateCircleShapeOption() 2555 2556``` 2557ArkUI_CircleShapeOption* OH_ArkUI_RenderNodeUtils_CreateCircleShapeOption() 2558``` 2559 2560**描述：** 2561创建圆形形状。 2562 2563**起始版本：** 20 2564 2565**返回：** 2566| 类型 | 说明 | 2567| -- | -- | 2568| [ArkUI_CircleShapeOption](./capi-arkui-nativemodule-arkui-circleshapeoption.md)* | 指向圆形形状的指针。 2569 2570### OH_ArkUI_RenderNodeUtils_DisposeCircleShapeOption() 2571 2572``` 2573void OH_ArkUI_RenderNodeUtils_DisposeCircleShapeOption(ArkUI_CircleShapeOption* option) 2574``` 2575 2576**描述：** 2577释放圆形形状。 2578 2579**起始版本：** 20 2580 2581**参数：** 2582| 参数项 | 描述 | 2583| -- | -- | 2584| [ArkUI_CircleShapeOption](./capi-arkui-nativemodule-arkui-circleshapeoption.md)* option | 指向圆形形状的指针。 | 2585 2586### OH_ArkUI_RenderNodeUtils_SetCircleShapeOptionCenterX() 2587 2588``` 2589void OH_ArkUI_RenderNodeUtils_SetCircleShapeOptionCenterX(ArkUI_CircleShapeOption* option, float centerX) 2590``` 2591 2592**描述：** 2593设置圆形形状的圆心x轴坐标值。 2594 2595**起始版本：** 20 2596 2597**参数：** 2598| 参数项 | 描述 | 2599| -- | -- | 2600| [ArkUI_CircleShapeOption](./capi-arkui-nativemodule-arkui-circleshapeoption.md)* option | 指向圆形形状的指针。 | 2601| float centerX | 圆心x轴坐标值。 | 2602 2603### OH_ArkUI_RenderNodeUtils_SetCircleShapeOptionCenterY() 2604 2605``` 2606void OH_ArkUI_RenderNodeUtils_SetCircleShapeOptionCenterY(ArkUI_CircleShapeOption* option, float centerY) 2607``` 2608 2609**描述：** 2610设置圆形形状的圆心y轴坐标值。 2611 2612**起始版本：** 20 2613 2614**参数：** 2615| 参数项 | 描述 | 2616| -- | -- | 2617| [ArkUI_CircleShapeOption](./capi-arkui-nativemodule-arkui-circleshapeoption.md)* option | 指向圆形形状的指针。 | 2618| float centerY | 圆心y轴坐标值。 | 2619 2620### OH_ArkUI_RenderNodeUtils_SetCircleShapeOptionRadius() 2621 2622``` 2623void OH_ArkUI_RenderNodeUtils_SetCircleShapeOptionRadius(ArkUI_CircleShapeOption* option, float radius) 2624``` 2625 2626**描述：** 2627设置圆形形状的半径值。 2628 2629**起始版本：** 20 2630 2631**参数：** 2632| 参数项 | 描述 | 2633| -- | -- | 2634| [ArkUI_CircleShapeOption](./capi-arkui-nativemodule-arkui-circleshapeoption.md)* option | 指向圆形形状的指针。 | 2635| float radius | 半径值（以像素为单位）。 | 2636 2637### OH_ArkUI_RenderNodeUtils_CreateRoundRectShapeOption() 2638 2639``` 2640ArkUI_RoundRectShapeOption* OH_ArkUI_RenderNodeUtils_CreateRoundRectShapeOption() 2641``` 2642 2643**描述：** 2644创建圆角矩形形状。 2645 2646**起始版本：** 20 2647 2648**返回：** 2649| 类型 | 说明 | 2650| -- | -- | 2651| [ArkUI_RoundRectShapeOption](./capi-arkui-nativemodule-arkui-roundrectshapeoption.md)* | 指向圆角矩形形状的指针。 2652 2653### OH_ArkUI_RenderNodeUtils_DisposeRoundRectShapeOption() 2654 2655``` 2656void OH_ArkUI_RenderNodeUtils_DisposeRoundRectShapeOption(ArkUI_RoundRectShapeOption* option) 2657``` 2658 2659**描述：** 2660释放圆角矩形形状。 2661 2662**起始版本：** 20 2663 2664**参数：** 2665| 参数项 | 描述 | 2666| -- | -- | 2667| [ArkUI_RoundRectShapeOption](./capi-arkui-nativemodule-arkui-roundrectshapeoption.md)* option | 指向圆角矩形形状的指针。 | 2668 2669### OH_ArkUI_RenderNodeUtils_SetRoundRectShapeOptionEdgeValue() 2670 2671``` 2672void OH_ArkUI_RenderNodeUtils_SetRoundRectShapeOptionEdgeValue(ArkUI_RoundRectShapeOption* option, float edgeValue, ArkUI_EdgeDirection direction) 2673``` 2674 2675**描述：** 2676设置圆角矩形形状的边缘值。 2677 2678**起始版本：** 20 2679 2680**参数：** 2681| 参数项 | 描述 | 2682| -- | -- | 2683| [ArkUI_RoundRectShapeOption](./capi-arkui-nativemodule-arkui-roundrectshapeoption.md)* option | 指向圆角矩形形状的指针。 | 2684| float edgeValue | 圆角矩形形状的边缘值。 | 2685| [ArkUI_EdgeDirection](capi-native-type-h.md#arkui_edgedirection) direction | 要设置边缘值的矩形方向。 | 2686 2687### OH_ArkUI_RenderNodeUtils_SetRoundRectShapeOptionCornerXY() 2688 2689``` 2690void OH_ArkUI_RenderNodeUtils_SetRoundRectShapeOptionCornerXY(ArkUI_RoundRectShapeOption* option, float x, float y, ArkUI_CornerDirection direction) 2691``` 2692 2693**描述：** 2694设置目标角的坐标值。 2695 2696**起始版本：** 20 2697 2698**参数：** 2699| 参数项 | 描述 | 2700| -- | -- | 2701| [ArkUI_RoundRectShapeOption](./capi-arkui-nativemodule-arkui-roundrectshapeoption.md)* option | 指向圆角矩形形状的指针。 | 2702| float x | 目标角的X坐标（以像素为单位）。 | 2703| float y | 目标角的Y坐标（以像素为单位）。 | 2704| ArkUI_CornerDirection direction | 角的方向。 | 2705 2706### OH_ArkUI_RenderNodeUtils_CreateCommandPathOption() 2707 2708``` 2709ArkUI_CommandPathOption* OH_ArkUI_RenderNodeUtils_CreateCommandPathOption() 2710``` 2711 2712**描述：** 2713创建自定义绘制路径。 2714 2715**起始版本：** 20 2716 2717**返回：** 2718| 类型 | 说明 | 2719| -- | -- | 2720| [ArkUI_CommandPathOption](./capi-arkui-nativemodule-arkui-commandpathoption.md)* | 指向自定义绘制路径的指针。 2721 2722### OH_ArkUI_RenderNodeUtils_DisposeCommandPathOption() 2723 2724``` 2725void OH_ArkUI_RenderNodeUtils_DisposeCommandPathOption(ArkUI_CommandPathOption* option) 2726``` 2727 2728**描述：** 2729释放自定义绘制路径。 2730 2731**起始版本：** 20 2732 2733**参数：** 2734| 参数项 | 描述 | 2735| -- | -- | 2736| [ArkUI_CommandPathOption](./capi-arkui-nativemodule-arkui-commandpathoption.md)* option | 指向自定义绘制路径的指针。 | 2737 2738### OH_ArkUI_RenderNodeUtils_SetCommandPathOptionCommands() 2739 2740``` 2741void OH_ArkUI_RenderNodeUtils_SetCommandPathOptionCommands(ArkUI_CommandPathOption* option, char* commands) 2742``` 2743 2744**描述：** 2745设置自定义绘制路径的命令值。 2746 2747**起始版本：** 20 2748 2749**参数：** 2750| 参数项 | 描述 | 2751| -- | -- | 2752| [ArkUI_CommandPathOption](./capi-arkui-nativemodule-arkui-commandpathoption.md)* option | 指向自定义绘制路径的指针。 | 2753| char* commands | 命令值。 | 2754 2755### OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromRectShape() 2756 2757``` 2758ArkUI_RenderNodeMaskOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromRectShape(ArkUI_RectShapeOption* shape) 2759``` 2760 2761**描述：** 2762从矩形形状创建遮罩。 2763 2764**起始版本：** 20 2765 2766**参数：** 2767| 参数项 | 描述 | 2768| -- | -- | 2769| [ArkUI_RectShapeOption](./capi-arkui-nativemodule-arkui-rectshapeoption.md) shape | 指向矩形形状的指针。 | 2770 2771**返回：** 2772| 类型 | 说明 | 2773| -- | -- | 2774| [ArkUI_RenderNodeMaskOption](./capi-arkui-nativemodule-arkui-rendernodemaskoption.md) | 指向渲染节点遮罩的指针。 2775 2776### OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromRoundRectShape() 2777 2778``` 2779ArkUI_RenderNodeMaskOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromRoundRectShape(ArkUI_RoundRectShapeOption* shape) 2780``` 2781 2782**描述：** 2783从圆角矩形形状创建遮罩。 2784 2785**起始版本：** 20 2786 2787**参数：** 2788| 参数项 | 描述 | 2789| -- | -- | 2790| [ArkUI_RoundRectShapeOption](./capi-arkui-nativemodule-arkui-roundrectshapeoption.md) shape | 指向圆角矩形形状的指针。 | 2791 2792**返回：** 2793| 类型 | 说明 | 2794| -- | -- | 2795| [ArkUI_RenderNodeMaskOption](./capi-arkui-nativemodule-arkui-rendernodemaskoption.md) | 指向渲染节点遮罩的指针。 2796 2797### OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromCircleShape() 2798 2799``` 2800ArkUI_RenderNodeMaskOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromCircleShape(ArkUI_CircleShapeOption* shape) 2801``` 2802 2803**描述：** 2804从圆形形状创建遮罩。 2805 2806**起始版本：** 20 2807 2808**参数：** 2809| 参数项 | 描述 | 2810| -- | -- | 2811| [ArkUI_CircleShapeOption](./capi-arkui-nativemodule-arkui-circleshapeoption.md) shape | 指向圆形形状的指针。 | 2812 2813**返回：** 2814| 类型 | 说明 | 2815| -- | -- | 2816| [ArkUI_RenderNodeMaskOption](./capi-arkui-nativemodule-arkui-rendernodemaskoption.md) | 指向渲染节点遮罩的指针。 2817 2818### OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromOvalShape() 2819 2820``` 2821ArkUI_RenderNodeMaskOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromOvalShape(ArkUI_RectShapeOption* shape) 2822``` 2823 2824**描述：** 2825从椭圆形形状创建遮罩。 2826 2827**起始版本：** 20 2828 2829**参数：** 2830| 参数项 | 描述 | 2831| -- | -- | 2832| [ArkUI_RectShapeOption](./capi-arkui-nativemodule-arkui-rectshapeoption.md) shape | 指向椭圆形形状的指针。 | 2833 2834**返回：** 2835| 类型 | 说明 | 2836| -- | -- | 2837| [ArkUI_RenderNodeMaskOption](./capi-arkui-nativemodule-arkui-rendernodemaskoption.md) | 指向渲染节点遮罩的指针。 2838 2839### OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromCommandPath() 2840 2841``` 2842ArkUI_RenderNodeMaskOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeMaskOptionFromCommandPath(ArkUI_CommandPathOption* path) 2843``` 2844 2845**描述：** 2846从自定义绘制路径创建遮罩。 2847 2848**起始版本：** 20 2849 2850**参数：** 2851| 参数项 | 描述 | 2852| -- | -- | 2853| [ArkUI_CommandPathOption](./capi-arkui-nativemodule-arkui-commandpathoption.md) path | 指向自定义绘制路径的指针。 | 2854 2855**返回：** 2856| 类型 | 说明 | 2857| -- | -- | 2858| [ArkUI_RenderNodeMaskOption](./capi-arkui-nativemodule-arkui-rendernodemaskoption.md) | 指向渲染节点遮罩的指针。 2859 2860### OH_ArkUI_RenderNodeUtils_DisposeRenderNodeMaskOption() 2861 2862``` 2863void OH_ArkUI_RenderNodeUtils_DisposeRenderNodeMaskOption(ArkUI_RenderNodeMaskOption* option) 2864``` 2865 2866**描述：** 2867释放渲染节点遮罩。 2868 2869**起始版本：** 20 2870 2871**参数：** 2872| 参数项 | 描述 | 2873| -- | -- | 2874| [ArkUI_RenderNodeMaskOption](./capi-arkui-nativemodule-arkui-rendernodemaskoption.md) option | 指向渲染节点遮罩的指针。 | 2875 2876### OH_ArkUI_RenderNodeUtils_SetRenderNodeMaskOptionFillColor() 2877 2878``` 2879void OH_ArkUI_RenderNodeUtils_SetRenderNodeMaskOptionFillColor(ArkUI_RenderNodeMaskOption* mask, uint32_t fillColor) 2880``` 2881 2882**描述：** 2883设置渲染节点遮罩的填充颜色。 2884 2885**起始版本：** 20 2886 2887**参数：** 2888| 参数项 | 描述 | 2889| -- | -- | 2890| [ArkUI_RenderNodeMaskOption](./capi-arkui-nativemodule-arkui-rendernodemaskoption.md)* mask | 指向渲染节点遮罩的指针。 | 2891| uint32_t fillColor | 遮罩的填充颜色。 | 2892 2893**返回：** 2894| 类型 | 说明 | 2895| -- | -- | 2896| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 2897 2898### OH_ArkUI_RenderNodeUtils_SetRenderNodeMaskOptionStrokeColor() 2899 2900``` 2901void OH_ArkUI_RenderNodeUtils_SetRenderNodeMaskOptionStrokeColor(ArkUI_RenderNodeMaskOption* mask, uint32_t strokeColor) 2902``` 2903 2904**描述：** 2905设置渲染节点遮罩的描边颜色。 2906 2907**起始版本：** 20 2908 2909**参数：** 2910| 参数项 | 描述 | 2911| -- | -- | 2912| [ArkUI_RenderNodeMaskOption](./capi-arkui-nativemodule-arkui-rendernodemaskoption.md)* mask | 指向渲染节点遮罩的指针。 | 2913| uint32_t strokeColor | 遮罩的描边颜色。 | 2914 2915**返回：** 2916| 类型 | 说明 | 2917| -- | -- | 2918| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 2919 2920### OH_ArkUI_RenderNodeUtils_SetRenderNodeMaskOptionStrokeWidth() 2921 2922``` 2923void OH_ArkUI_RenderNodeUtils_SetRenderNodeMaskOptionStrokeWidth(ArkUI_RenderNodeMaskOption* mask, float strokeWidth) 2924``` 2925 2926**描述：** 2927设置渲染节点遮罩的描边宽度。以边框路径为中心进行相应宽度的绘制。 2928 2929**起始版本：** 20 2930 2931**参数：** 2932| 参数项 | 描述 | 2933| -- | -- | 2934| [ArkUI_RenderNodeMaskOption](./capi-arkui-nativemodule-arkui-rendernodemaskoption.md)* mask | 指向渲染节点遮罩的指针。 | 2935| float strokeWidth | 遮罩的描边宽度。<br>取值范围：(0, +∞)，当取值为负数或0时，绘制时会被设定成1像素。 | 2936 2937**返回：** 2938| 类型 | 说明 | 2939| -- | -- | 2940| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化失败。 2941 2942### OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromRectShape() 2943 2944``` 2945ArkUI_RenderNodeClipOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromRectShape(ArkUI_RectShapeOption* shape) 2946``` 2947 2948**描述：** 2949从矩形形状创建裁剪。 2950 2951**起始版本：** 20 2952 2953**参数：** 2954| 参数项 | 描述 | 2955| -- | -- | 2956| [ArkUI_RectShapeOption](./capi-arkui-nativemodule-arkui-rectshapeoption.md)* shape | 指向矩形形状的指针。 | 2957 2958**返回：** 2959| 类型 | 说明 | 2960| -- | -- | 2961| [ArkUI_RenderNodeClipOption](./capi-arkui-nativemodule-arkui-rendernodeclipoption.md)* | 指向渲染节点裁剪的指针。 2962 2963### OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromRoundRectShape() 2964 2965``` 2966ArkUI_RenderNodeClipOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromRoundRectShape(ArkUI_RoundRectShapeOption* shape) 2967``` 2968 2969**描述：** 2970从圆角矩形形状创建裁剪。 2971 2972**起始版本：** 20 2973 2974**参数：** 2975| 参数项 | 描述 | 2976| -- | -- | 2977| [ArkUI_RoundRectShapeOption](./capi-arkui-nativemodule-arkui-roundrectshapeoption.md)* shape | 指向圆角矩形形状的指针。 | 2978 2979**返回：** 2980| 类型 | 说明 | 2981| -- | -- | 2982| [ArkUI_RenderNodeClipOption](./capi-arkui-nativemodule-arkui-rendernodeclipoption.md)* | 指向渲染节点裁剪的指针。 2983 2984### OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromCircleShape() 2985 2986``` 2987ArkUI_RenderNodeClipOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromCircleShape(ArkUI_CircleShapeOption* shape) 2988``` 2989 2990**描述：** 2991从圆形形状创建裁剪。 2992 2993**起始版本：** 20 2994 2995**参数：** 2996| 参数项 | 描述 | 2997| -- | -- | 2998| [ArkUI_CircleShapeOption](./capi-arkui-nativemodule-arkui-circleshapeoption.md)* shape | 指向圆形形状的指针。 | 2999 3000**返回：** 3001| 类型 | 说明 | 3002| -- | -- | 3003| [ArkUI_RenderNodeClipOption](./capi-arkui-nativemodule-arkui-rendernodeclipoption.md)* | 指向渲染节点裁剪的指针。 3004 3005### OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromOvalShape() 3006 3007``` 3008ArkUI_RenderNodeClipOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromOvalShape(ArkUI_RectShapeOption* shape) 3009``` 3010 3011**描述：** 3012从椭圆形形状创建裁剪。 3013 3014**起始版本：** 20 3015 3016**参数：** 3017| 参数项 | 描述 | 3018| -- | -- | 3019| [ArkUI_RectShapeOption](./capi-arkui-nativemodule-arkui-rectshapeoption.md)* shape | 指向椭圆形形状的指针。 | 3020 3021**返回：** 3022| 类型 | 说明 | 3023| -- | -- | 3024| [ArkUI_RenderNodeClipOption](./capi-arkui-nativemodule-arkui-rendernodeclipoption.md)* | 指向渲染节点裁剪的指针。 3025 3026### OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromCommandPath() 3027 3028``` 3029ArkUI_RenderNodeClipOption* OH_ArkUI_RenderNodeUtils_CreateRenderNodeClipOptionFromCommandPath(ArkUI_CommandPathOption* path) 3030``` 3031 3032**描述：** 3033从自定义绘制路径创建裁剪。 3034 3035**起始版本：** 20 3036 3037**参数：** 3038| 参数项 | 描述 | 3039| -- | -- | 3040| [ArkUI_CommandPathOption](./capi-arkui-nativemodule-arkui-commandpathoption.md)* path | 指向自定义绘制路径的指针。 | 3041 3042**返回：** 3043| 类型 | 说明 | 3044| -- | -- | 3045| [ArkUI_RenderNodeClipOption](./capi-arkui-nativemodule-arkui-rendernodeclipoption.md)* | 指向渲染节点裁剪的指针。 3046 3047### OH_ArkUI_RenderNodeUtils_DisposeRenderNodeClipOption() 3048 3049``` 3050void OH_ArkUI_RenderNodeUtils_DisposeRenderNodeClipOption(ArkUI_RenderNodeClipOption* option) 3051``` 3052 3053**描述：** 3054释放渲染节点裁剪。 3055 3056**起始版本：** 20 3057 3058**参数：** 3059| 参数项 | 描述 | 3060| -- | -- | 3061| [ArkUI_RenderNodeClipOption](./capi-arkui-nativemodule-arkui-rendernodeclipoption.md)* option | 指向渲染节点裁剪的指针。 |