diff --git a/arkui/ace_engine/native/native_node.h b/arkui/ace_engine/native/native_node.h index 2db2d6ed073bb9b46044d7d36978ceb65c3584e0..dbfd7c430ac16a8c960987a3b755256382f68fe4 100644 --- a/arkui/ace_engine/native/native_node.h +++ b/arkui/ace_engine/native/native_node.h @@ -2365,6 +2365,71 @@ typedef enum { */ NODE_TEXT_LINE_COUNT = 1031, + /** + * @brief Sets a linear gradient effect for text. + * This attribute can be set, reset, and obtained as required through APIs. + * + * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n + * .value[0].f32: start angle of the linear gradient. + * The setting takes effect only when direction is set to ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM. + * A positive value indicates a clockwise rotation from the origin, (0, 0). The default value is 180. \n + * .value[1].i32: direction of the linear gradient. When a direction other than + * ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM is set, the angle property is ignored. + * The parameter type is {@link ArkUI_LinearGradientDirection}. \n + * .value[2].i32: whether the colors are repeated. The default value is false. + * .object: array of color stops, each of which consists of a color and its stop position. + * The parameter type is {@link ArkUI_ColorStop}. Invalid colors are automatically skipped. \n \n + * colors: colors of the color stops. \n + * stops: stop positions of the color stops. \n + * size: number of colors. \n + * \n + * Format of the return value {@link ArkUI_AttributeItem}:\n + * .value[0].f32: start angle of the linear gradient. + * When direction is set to ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM, angle at the set value; + * otherwise, it is at default value. \n + * .value[1].i32: direction of the linear gradient. \n + * .value[2].i32: whether the colors are repeated. \n + * .object: array of color stops, each of which consists of a color and its stop position. + * The parameter type is {@link ArkUI_ColorStop}. Invalid colors are automatically skipped. \n \n + * colors: colors of the color stops. \n + * stops: stop positions of the color stops. \n + * size: number of colors. \n + * + * @since 20 + */ + NODE_TEXT_LINEAR_GRADIENT = 1033, + + /** + * @brief Sets a radial gradient effect for text. This attribute can be set, reset, and obtained as required through APIs. + * + * Format of the {@link ArkUI_AttributeItem} parameter for setting the attribute:\n + * .value[0]?.f32: X-coordinate of the radial gradient center relative to the upper left corner of the text. \n + * .value[1]?.f32: Y-coordinate of the radial gradient center relative to the upper left corner of the text. \n + * .value[2]?.f32: radius of the radial gradient. The default value is 0. \n + * .value[3]?.i32: whether the colors are repeated. + * The value 1 means that the colors are repeated, and 0 means the opposite.\n \n + * .object: array of color stops, each of which consists of a color and its stop position. + * The parameter type is {@link ArkUI_ColorStop}. Invalid colors are automatically skipped. \n + * colors: colors of the color stops. \n + * stops: stop positions of the color stops. \n + * size: number of colors. \n + * \n + * Format of the return value {@link ArkUI_AttributeItem}:\n + * .value[0].f32: X-coordinate of the radial gradient center relative to the upper left corner of the text. \n + * .value[1].f32: Y-coordinate of the radial gradient center relative to the upper left corner of the text. \n + * .value[2].f32: radius of the radial gradient. The default value is 0. \n + * .value[3].i32: whether the colors are repeated. + * The value 1 means that the colors are repeated, and 0 means the opposite. \n + * .object: array of color stops, each of which consists of a color and its stop position. + * The parameter type is {@link ArkUI_ColorStop}. Invalid colors are automatically skipped. \n + * colors: colors of the color stops. \n + * stops: stop positions of the color stops. \n + * size: number of colors. \n + * + * @since 20 + */ + NODE_TEXT_RADIAL_GRADIENT = 1034, + /** * @brief Defines the text content attribute, which can be set, reset, and obtained as required through APIs. *