diff --git a/zh-cn/native_sdk/arkui/ace_engine/native/native_node.h b/zh-cn/native_sdk/arkui/ace_engine/native/native_node.h index 295a7f9350b8afa8325007f8929221afb010a675..128f81f9fa002976f39451cb3418f037abcb5417 100644 --- a/zh-cn/native_sdk/arkui/ace_engine/native/native_node.h +++ b/zh-cn/native_sdk/arkui/ace_engine/native/native_node.h @@ -2248,19 +2248,30 @@ typedef enum { NODE_TEXT_OPTIMIZE_TRAILING_SPACE = 1032, /** - * @brief 设置文本颜色渐变效果,支持属性设置,属性重置和属性获取接口。 + * @brief 设置文本线性渐变效果,支持属性设置,属性重置和属性获取接口。 * * 属性设置方法参数{@link ArkUI_AttributeItem}格式: \n * .value[0].f32:线性渐变的起始角度。 * 当direction属性设置为ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM时,angle属性生效;否则,以direction属性为主要布局方式。 * 0点方向顺时针旋转为正向角度,默认值:180 \n - * .value[1].i32:线性渐变的方向。设置除ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM之外的线性渐变方向后,angle不生效。 - * 数据类型{@link ArkUI_LinearGradientDirection}。 \n - * .value[2].i32:为渐变的颜色重复着色,默认值:false \n + * .value[1].i32:线性渐变的方向{@link ArkUI_LinearGradientDirection}。 + * 设置除ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM之外的线性渐变方向后,angle不生效。 + * 默认值:ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT_BOTTOM \n + * .value[2].i32:为渐变的颜色重复着色,false表示不重复着色,true表示重复着色。默认值:false \n * .object: 参数类型为{@link ArkUI_ColorStop}。指定某百分比位置处的渐变色颜色,设置非法颜色直接跳过。 \n - * colors:渐变色颜色颜色。 \n - * stops:渐变位置。 \n - * size:颜色个数。 \n + * colors:渐变色颜色数组,数组元素为0xargb格式,形如0xFFFF0000表示红色。 \n + * stops:stops表示指定颜色所处位置的数组,数组元素取值范围为[0,1.0],0表示需要设置渐变色的容器的开始处,1.0表示容器的结尾处。 + * 想要实现多个颜色渐变效果时,数组元素建议递增设置,如后一个数组元素比前一个数组元素小的话,按照等于前一个数组元素的值处理。 \n + * size:颜色个数,若小于colors数组长度则仅生效前size个颜色,不建议设置大于colors数组长度或小于等于0的值以及异常值。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式: \n + * .value[0].f32:线性渐变的起始角度。当为ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM时,angle为设置值,其他情况均为默认值0。 \n + * .value[1].i32:线性渐变的方向{@link ArkUI_LinearGradientDirection}。 \n + * .value[2].i32:为渐变的颜色重复着色,0表示不重复着色,1表示重复着色。默认值:0 \n + * .object:参数类型为{@link ArkUI_ColorStop}。指定某百分比位置处的渐变色颜色,设置非法颜色直接跳过: \n + * colors:渐变色颜色数组,数组元素为0xargb格式,形如0xFFFF0000表示红色。 \n + * stops:stops表示指定颜色所处位置的数组,数组元素取值范围为[0,1.0],0表示需要设置渐变色的容器的开始处,1.0表示容器的结尾处。 \n + * size:生效后渐变色的颜色个数。 \n * * @since 20 */ @@ -2270,14 +2281,27 @@ typedef enum { * @brief 设置文本径向渐变渐变效果,支持属性设置,属性重置和属性获取接口。 * * 属性设置方法参数{@link ArkUI_AttributeItem}格式: \n - * .value[0]?.f32:为径向渐变的中心点,即相对于当前文本左上角的X轴坐标。 \n - * .value[1]?.f32:为径向渐变的中心点,即相对于当前文本左上角的Y轴坐标。 \n + * .value[0]?.f32:为径向渐变的中心点,即相对于当前文本框左上角的X轴坐标。 \n + * .value[1]?.f32:为径向渐变的中心点,即相对于当前文本框左上角的Y轴坐标。 + * 文本框左上角的坐标为[0,0]。\n * .value[2]?.f32:径向渐变的半径,默认值0。 \n - * .value[3]?.i32:为渐变的颜色重复着色,0表示不重复着色,1表示重复着色。 \n + * .value[3]?.i32:为渐变的颜色重复着色,false表示不重复着色,true表示重复着色。默认值:false \n * .object:参数类型为{@link ArkUI_ColorStop}。指定某百分比位置处的渐变色颜色,设置非法颜色直接跳过: \n - * colors:渐变色颜色颜色。 \n - * stops:渐变位置。 \n - * size:颜色个数。 \n + * colors:渐变色颜色数组,数组元素为0xargb格式,形如0xFFFF0000表示红色。 \n + * stops:stops表示指定颜色所处位置的数组,数组元素取值范围为[0,1.0],0表示需要设置渐变色的容器的开始处,1.0表示容器的结尾处。 + * 想要实现多个颜色渐变效果时,数组元素建议递增设置,如后一个数组元素比前一个数组元素小的话,按照等于前一个数组元素的值处理。 \n + * size:颜色个数,若小于colors数组长度则仅生效前size个颜色,不建议设置大于colors数组长度或小于等于0的值以及异常值。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式: \n + * .value[0]?.f32:为径向渐变的中心点,即相对于当前文本框左上角的X轴坐标。 \n + * .value[1]?.f32:为径向渐变的中心点,即相对于当前文本框左上角的Y轴坐标。 + * 文本框左上角的坐标为[0,0]。\n + * .value[2]?.f32:径向渐变的半径,默认值0。 \n + * .value[3]?.i32:为渐变的颜色重复着色,0表示不重复着色,1表示重复着色。默认值:0 \n + * .object:参数类型为{@link ArkUI_ColorStop}。指定某百分比位置处的渐变色颜色,设置非法颜色直接跳过: \n + * colors:渐变色颜色数组,数组元素为0xargb格式,形如0xFFFF0000表示红色。 \n + * stops:stops表示指定颜色所处位置的数组,数组元素取值范围为[0,1.0],0表示需要设置渐变色的容器的开始处,1.0表示容器的结尾处。 \n + * size:生效后渐变色的颜色个数。 \n * * @since 20 */