ArkUI_NodeAttributeType（基础属性）

enum ArkUI_NodeAttributeType

概述

定义ArkUI在Native侧可以设置的基础属性集合，包含背景、背景图片样式和组件标识等属性设置。

起始版本： 12

相关模块： ArkUI_NativeModule

所在头文件： native_node.h

NODE_BACKGROUND_COLOR

NODE_BACKGROUND_COLOR = 2

背景色属性，支持属性设置，属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本： 12

参数：

参数项	描述
.value[0].u32	背景色数值，0xargb格式，形如 `0xFFFF0000` 表示红色。

返回：

类型	说明
.value[0].u32	背景色数值，0xargb格式，形如 `0xFFFF0000` 表示红色。

NODE_BACKGROUND_IMAGE

NODE_BACKGROUND_IMAGE = 3

背景色图片属性，支持属性设置，属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本： 12

参数：

参数项	描述
.string	图片地址。API version 22及之前版本，支持网络图片资源地址、本地图片资源地址、Base64和PixelMap资源，不支持svg图片、gif和webp等类型的动图。从API version 23开始，新增支持webp和gif类型的动图，显示动图第一帧，不支持其他类型的动图。
.value[0]?.i32	可选值，repeat参数，参数类型ArkUI_ImageRepeat，默认值为ARKUI_IMAGE_REPEAT_NONE。
.object	PixelMap图片数据，参数类型为ArkUI_DrawableDescriptor。`.object`参数和`.string`参数二选一，不可同时设置。

返回：

类型	说明
.string	图片地址。API version 22及之前版本，支持网络图片资源地址、本地图片资源地址、Base64和PixelMap资源，不支持svg图片、gif和webp等类型的动图。从API version 23开始，新增支持webp和gif类型的动图，显示动图第一帧，不支持其他类型的动图。
.value[0].i32	repeat参数，参数类型ArkUI_ImageRepeat。
.object	PixelMap图片数据，参数类型为ArkUI_DrawableDescriptor。

NODE_ID

NODE_ID = 5

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

起始版本： 12

参数：

参数项	描述
.string	ID的内容。

返回：

类型	说明
.string	ID的内容。

NODE_BACKGROUND_IMAGE_SIZE

NODE_BACKGROUND_IMAGE_SIZE = 30

背景图片的宽高属性，支持属性设置，属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本： 12

参数：

参数项	描述
.value[0].f32	图片的宽度值，取值范围`[0,+∞)`，单位为vp。
.value[1].f32	图片的高度值，取值范围`[0,+∞)`，单位为vp。

返回：

类型	说明
.value[0].f32	图片的宽度值，单位为vp。
.value[1].f32	图片的高度值，单位为vp。

NODE_BACKGROUND_IMAGE_SIZE_WITH_STYLE

NODE_BACKGROUND_IMAGE_SIZE_WITH_STYLE = 31

背景图片的宽高样式属性，支持属性设置，属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本： 12

参数：

参数项	描述
.value[0].i32	背景图片的宽高样式，取ArkUI_ImageSize枚举值。

返回：

类型	说明
.value[0].i32	背景图片的宽高样式，取ArkUI_ImageSize枚举值。

NODE_BACKGROUND_IMAGE_POSITION

NODE_BACKGROUND_IMAGE_POSITION = 56

背景图在组件中显示位置，即相对于组件左上角的坐标，支持属性设置，属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本： 12

参数：

参数项	描述
.value[0].f32	x轴位置，单位为px。
.value[1].f32	y轴位置，单位为px。
.value[2]?.i32	可选值，对齐方式，参数类型ArkUI_Alignment，默认值为ARKUI_ALIGNMENT_TOP_START。该参数从API version 21开始支持。
.value[3]?.i32	可选值，布局方向，参数类型ArkUI_Direction，默认值为ARKUI_DIRECTION_AUTO。多数场景下建议设置为AUTO，由系统自动处理布局方向；若需要固定方向，可设置为LTR或RTL。该参数从API version 21开始支持。

返回：

类型	说明
.value[0].f32	x轴位置，单位为px。
.value[1].f32	y轴位置，单位为px。
.value[2].i32	对齐方式，参数类型ArkUI_Alignment。该返回值从API version 21开始支持。
.value[3].i32	布局方向，参数类型ArkUI_Direction。该返回值从API version 21开始支持。

NODE_RENDER_GROUP

NODE_RENDER_GROUP = 80

设置当前组件和子组件是否先整体离屏渲染绘制后再与父控件融合绘制，支持属性设置，属性重置和属性获取。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本： 12

参数：

参数项	描述
.value[0].i32	参数类型为1表示当前组件与子组件需要先整体离屏渲染绘制后再与父控件融合绘制，参数类型为0表示不需要整体离屏渲染绘制后再与父控件融合绘制。默认值为0。

返回：

类型	说明
.value[0].i32	参数类型为1表示当前组件与子组件完成整体离屏渲染绘制，参数类型为0表示当前组件与子组件未完成整体离屏渲染绘制。