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 d8179748eee8331792c5afb67e78c8403cad4c24..b725c052bb3fbe9bbedec66b119961962d435343 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 @@ -2826,124 +2826,124 @@ typedef enum { */ NODE_TEXT_INPUT_TEXT_SELECTION, /** - * @brief 开启下划线时,支持配置下划线颜色。 - * - * 主题配置的默认下划线颜色为'0x33182431'。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].u32:typing,必填,键入时下划线颜色,0xargb类型;\n - * .value[1].u32:normal,必填,非特殊状态时下划线颜色,0xargb类型;\n - * .value[2].u32:error,必填,错误时下划线颜色,0xargb类型;\n - * .value[3].u32:disable,必填,禁用时下划线颜色,0xargb类型;\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].u32:typing,键入时下划线颜色,0xargb类型;\n - * .value[1].u32:normal,非特殊状态时下划线颜色,0xargb类型;\n - * .value[2].u32:error,错误时下划线颜色,0xargb类型;\n - * .value[3].u32:disable,禁用时下划线颜色,0xargb类型;\n - * - */ + * @brief 开启下划线时,支持配置下划线颜色。 + * + * 主题配置的默认下划线颜色为'0x33182431'。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].u32:typing,必填,键入时下划线颜色,0xargb类型;\n + * .value[1].u32:normal,必填,非特殊状态时下划线颜色,0xargb类型;\n + * .value[2].u32:error,必填,错误时下划线颜色,0xargb类型;\n + * .value[3].u32:disable,必填,禁用时下划线颜色,0xargb类型;\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].u32:typing,键入时下划线颜色,0xargb类型;\n + * .value[1].u32:normal,非特殊状态时下划线颜色,0xargb类型;\n + * .value[2].u32:error,错误时下划线颜色,0xargb类型;\n + * .value[3].u32:disable,禁用时下划线颜色,0xargb类型;\n + * + */ NODE_TEXT_INPUT_UNDERLINE_COLOR, /** - * @brief 设置是否启用自动填充。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 是否启用自动填充,默认值true。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 是否启用自动填充。\n - * - */ + * @brief 设置是否启用自动填充。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 是否启用自动填充,默认值true。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 是否启用自动填充。\n + * + */ NODE_TEXT_INPUT_ENABLE_AUTO_FILL, /** - * @brief 自动填充类型。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 参数类型{@link ArkUI_TextInputContentType}。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 参数类型{@link ArkUI_TextInputContentType}。\n - * - */ + * @brief 自动填充类型。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 参数类型{@link ArkUI_TextInputContentType}。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 参数类型{@link ArkUI_TextInputContentType}。\n + * + */ NODE_TEXT_INPUT_CONTENT_TYPE, /** - * @brief 定义生成密码的规则。在触发自动填充时,所设置的密码规则会透传给密码保险箱,用于新密码的生成。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .string: 定义生成密码的规则。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .string: 定义生成密码的规则。\n - * - */ + * @brief 定义生成密码的规则。在触发自动填充时,所设置的密码规则会透传给密码保险箱,用于新密码的生成。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .string: 定义生成密码的规则。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .string: 定义生成密码的规则。\n + * + */ NODE_TEXT_INPUT_PASSWORD_RULES, /** - * @brief 设置当初始状态,是否全选文本。不支持内联模式。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 是否全选文本,默认值:false。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 是否全选文本。\n - * - */ + * @brief 设置当初始状态,是否全选文本。不支持内联模式。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 是否全选文本,默认值:false。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 是否全选文本。\n + * + */ NODE_TEXT_INPUT_SELECT_ALL, /** - * @brief 通过正则表达式设置输入过滤器。匹配表达式的输入允许显示,不匹配的输入将被过滤。仅支持单个字符匹配,不支持字符串匹配。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .string: 正则表达式。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .string: 正则表达式。\n - * - */ + * @brief 通过正则表达式设置输入过滤器。匹配表达式的输入允许显示,不匹配的输入将被过滤。仅支持单个字符匹配,不支持字符串匹配。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .string: 正则表达式。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .string: 正则表达式。\n + * + */ NODE_TEXT_INPUT_INPUT_FILTER, /** - * @brief 设置输入框为默认风格或内联输入风格。 - * - * 内联输入风格只支持InputType.Normal类型。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 参数类型{@link ArkUI_TextInputStyle}。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 参数类型{@link ArkUI_TextInputStyle}。\n - * - */ + * @brief 设置输入框为默认风格或内联输入风格。 + * + * 内联输入风格只支持InputType.Normal类型。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 参数类型{@link ArkUI_TextInputStyle}。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 参数类型{@link ArkUI_TextInputStyle}。\n + * + */ NODE_TEXT_INPUT_STYLE, /** - * @brief 设置或获取光标所在位置信息。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * 设置输入光标的位置。 - * .value[0].i32: 从字符串开始到光标所在位置的字符长度。\n - * - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * 返回当前光标所在位置信息。在当前帧更新光标位置同时调用该接口,该接口不生效。 - * value[0].i32:光标所在位置的索引值。\n - * value[1].f32:光标相对输入框的x坐标位值。\n - * value[2].f32:光标相对输入框的y坐标位值。\n - */ + * @brief 设置或获取光标所在位置信息。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * 设置输入光标的位置。 + * .value[0].i32: 从字符串开始到光标所在位置的字符长度。\n + * + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * 返回当前光标所在位置信息。在当前帧更新光标位置同时调用该接口,该接口不生效。 + * value[0].i32:光标所在位置的索引值。\n + * value[1].f32:光标相对输入框的x坐标位值。\n + * value[2].f32:光标相对输入框的y坐标位值。\n + */ NODE_TEXT_INPUT_CARET_OFFSET, /** - * @brief 获取已编辑文本内容区域相对组件的位置和大小。 - * - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * value[0].f32:水平方向横坐标。\n - * value[1].f32:竖直方向纵坐标。\n - * value[2].f32:内容宽度大小。\n - * value[3].f32:内容高度大小。\n - * - */ + * @brief 获取已编辑文本内容区域相对组件的位置和大小。 + * + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * value[0].f32:水平方向横坐标。\n + * value[1].f32:竖直方向纵坐标。\n + * value[2].f32:内容宽度大小。\n + * value[3].f32:内容高度大小。\n + * + */ NODE_TEXT_INPUT_CONTENT_RECT, /** - * @brief 获取已编辑文本内容的行数。 - * - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * value[0].i32:已编辑文本内容行数。\n - * - */ + * @brief 获取已编辑文本内容的行数。 + * + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * value[0].i32:已编辑文本内容行数。\n + * + */ NODE_TEXT_INPUT_CONTENT_LINE_COUNT, /** @@ -3046,16 +3046,16 @@ typedef enum { NODE_TEXT_INPUT_HALF_LEADING = 7034, /** - * @brief 设置输入框拉起的键盘样式。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32:键盘样式,参数类型{@link ArkUI_KeyboardAppearance}。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32:键盘样式,参数类型{@link ArkUI_KeyboardAppearance}。\n - * - * @since 15 - */ + * @brief 设置输入框拉起的键盘样式。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:键盘样式,参数类型{@link ArkUI_KeyboardAppearance}。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:键盘样式,参数类型{@link ArkUI_KeyboardAppearance}。\n + * + * @since 15 + */ NODE_TEXT_INPUT_KEYBOARD_APPEARANCE = 7035, /** @@ -3072,15 +3072,15 @@ typedef enum { NODE_TEXT_INPUT_ENABLE_FILL_ANIMATION = 7036, /** - * @brief 设置输入框获取焦点时是否弹出键盘,支持属性设置,属性重置和属性获取接口。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 是否弹出键盘。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 是否弹出键盘。\n - * - */ + * @brief 设置输入框获取焦点时是否弹出键盘,支持属性设置,属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 是否弹出键盘。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 是否弹出键盘。\n + * + */ NODE_TEXT_INPUT_SHOW_KEYBOARD_ON_FOCUS, /** @@ -3229,15 +3229,15 @@ typedef enum { */ NODE_TEXT_AREA_BLUR_ON_SUBMIT, /** - * @brief 通过正则表达式设置输入过滤器。匹配表达式的输入允许显示,不匹配的输入将被过滤。仅支持单个字符匹配,不支持字符串匹配。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .string: 正则表达式。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .string: 正则表达式。\n - * - */ + * @brief 通过正则表达式设置输入过滤器。匹配表达式的输入允许显示,不匹配的输入将被过滤。仅支持单个字符匹配,不支持字符串匹配。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .string: 正则表达式。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .string: 正则表达式。\n + * + */ NODE_TEXT_AREA_INPUT_FILTER, /** * @brief 设置文本选中底板颜色,支持属性设置,属性重置和属性获取接口。 @@ -3273,37 +3273,37 @@ typedef enum { */ NODE_TEXT_AREA_ENABLE_KEYBOARD_ON_FOCUS, /** - * @brief 设置或获取光标所在位置信息。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * 设置输入光标的位置。 - * .value[0].i32: 从字符串开始到光标所在位置的字符长度。\n - * - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * 返回当前光标所在位置信息。在当前帧更新光标位置同时调用该接口,该接口不生效。 - * value[0].i32:光标所在位置的索引值。\n - * value[1].f32:光标相对输入框的x坐标位值。\n - * value[2].f32:光标相对输入框的y坐标位值。\n - */ + * @brief 设置或获取光标所在位置信息。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * 设置输入光标的位置。 + * .value[0].i32: 从字符串开始到光标所在位置的字符长度。\n + * + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * 返回当前光标所在位置信息。在当前帧更新光标位置同时调用该接口,该接口不生效。 + * value[0].i32:光标所在位置的索引值。\n + * value[1].f32:光标相对输入框的x坐标位值。\n + * value[2].f32:光标相对输入框的y坐标位值。\n + */ NODE_TEXT_AREA_CARET_OFFSET, /** - * @brief 获取已编辑文本内容区域相对组件的位置和大小。 - * - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * value[0].f32:水平方向横坐标。\n - * value[1].f32:竖直方向纵坐标。\n - * value[2].f32:内容宽度大小。\n - * value[3].f32:内容高度大小。\n - * - */ + * @brief 获取已编辑文本内容区域相对组件的位置和大小。 + * + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * value[0].f32:水平方向横坐标。\n + * value[1].f32:竖直方向纵坐标。\n + * value[2].f32:内容宽度大小。\n + * value[3].f32:内容高度大小。\n + * + */ NODE_TEXT_AREA_CONTENT_RECT, /** - * @brief 获取已编辑文本内容的行数。 - * - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * value[0].i32:已编辑文本内容行数。\n - * - */ + * @brief 获取已编辑文本内容的行数。 + * + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * value[0].i32:已编辑文本内容行数。\n + * + */ NODE_TEXT_AREA_CONTENT_LINE_COUNT, /** * @brief 组件在获焦状态下,调用该接口设置文本选择区域并高亮显示,且只有在selectionStart小于selectionEnd时,文字才会被选取、高亮显示。 @@ -3319,26 +3319,26 @@ typedef enum { */ NODE_TEXT_AREA_TEXT_SELECTION, /** - * @brief 设置是否启用自动填充。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 是否启用自动填充,默认值true。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 是否启用自动填充。\n - * - */ + * @brief 设置是否启用自动填充。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 是否启用自动填充,默认值true。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 是否启用自动填充。\n + * + */ NODE_TEXT_AREA_ENABLE_AUTO_FILL, /** - * @brief 自动填充类型。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 参数类型{@link ArkUI_TextInputContentType}。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 参数类型{@link ArkUI_TextInputContentType}。\n - * - */ + * @brief 自动填充类型。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 参数类型{@link ArkUI_TextInputContentType}。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 参数类型{@link ArkUI_TextInputContentType}。\n + * + */ NODE_TEXT_AREA_CONTENT_TYPE, /** * @brief 设置该属性后,通过该属性计算textArea组件的高度。 @@ -3394,81 +3394,81 @@ typedef enum { NODE_TEXT_AREA_HALF_LEADING = 8025, /** - * @brief 设置输入框拉起的键盘样式。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32:键盘样式,参数类型{@link ArkUI_KeyboardAppearance}。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32:键盘样式,参数类型{@link ArkUI_KeyboardAppearance}。\n - * - * @since 15 - */ + * @brief 设置输入框拉起的键盘样式。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:键盘样式,参数类型{@link ArkUI_KeyboardAppearance}。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:键盘样式,参数类型{@link ArkUI_KeyboardAppearance}。\n + * + * @since 15 + */ NODE_TEXT_AREA_KEYBOARD_APPEARANCE = 8026, /** - * @brief 设置输入框内联模式编辑态时文本可显示的最大行数,支持属性设置,属性重置和属性获取接口。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32:内联输入风格编辑态时文本可显示的最大行数。内联模式下,默认值是3,\n - * 非内联模式下,默认值是+∞,不限制最大行数。设置为undefined时,最大行数设置为5。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32:最大行数的数字。\n - * - * @since 20 - */ + * @brief 设置输入框内联模式编辑态时文本可显示的最大行数,支持属性设置,属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:内联输入风格编辑态时文本可显示的最大行数。内联模式下,默认值是3,\n + * 非内联模式下,默认值是+∞,不限制最大行数。设置为undefined时,最大行数设置为5。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:最大行数的数字。\n + * + * @since 20 + */ NODE_TEXT_AREA_MAX_LINES = 8027, /** - * @brief 设置输入框文本的行间距,支持属性设置,属性重置和属性获取接口。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32:文本的行间距的数字。默认值是0。设置为undefined时,行间距设置为5。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32:文本的行间距的数字。\n - * - * @since 20 - */ + * @brief 设置输入框文本的行间距,支持属性设置,属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:文本的行间距的数字。默认值是0。设置为undefined时,行间距设置为5。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:文本的行间距的数字。\n + * + * @since 20 + */ NODE_TEXT_AREA_LINE_SPACING = 8028, /** - * @brief 设置节点的最小行数。支持属性设置、属性重置和属性获取接口。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32:最小行数的数字。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32:最小行数的数字。\n - * - * @since 20 - */ + * @brief 设置节点的最小行数。支持属性设置、属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:最小行数的数字。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:最小行数的数字。\n + * + * @since 20 + */ NODE_TEXT_AREA_MIN_LINES = 8029, /** - * @brief 设置支持滚动时节点的最大行数。支持属性设置、属性重置和属性获取接口。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32:支持滚动时的最大行数的数字。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32:支持滚动时的最大行数的数字。\n - * - * @since 20 - */ + * @brief 设置支持滚动时节点的最大行数。支持属性设置、属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:支持滚动时的最大行数的数字。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:支持滚动时的最大行数的数字。\n + * + * @since 20 + */ NODE_TEXT_AREA_MAX_LINES_WITH_SCROLL = 8030, /** - * @brief 设置输入框获取焦点时是否弹出键盘,支持属性设置,属性重置和属性获取接口。 - * - * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 是否弹出键盘。\n - * \n - * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n - * .value[0].i32: 是否弹出键盘。\n - * - */ + * @brief 设置输入框获取焦点时是否弹出键盘,支持属性设置,属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 是否弹出键盘。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32: 是否弹出键盘。\n + * + */ NODE_TEXT_AREA_SHOW_KEYBOARD_ON_FOCUS, /**