智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
高级筛选
API version全部版本
设备全部
元服务API集不筛选
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
ArkUI_NodeAttributeType（XComponent组件相关属性）
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
更新时间: 2026-08-29 09:41
本文导读
收起
自动换行
深色代码主题
复制
- enum ArkUI_NodeAttributeType
概述
定义ArkUI在Native侧可以设置或获取的XComponent组件相关属性集合，包括组件ID、组件类型、Surface宽高、Surface显示区域以及是否支持图像分析等属性，适用于需要在Native侧对XComponent组件的渲染区域和行为进行自定义配置与获取的场景。
起始版本： 12
相关模块： ArkUI_NativeModule
所在头文件： native_node.h
NODE_XCOMPONENT_ID
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
收起
自动换行
深色代码主题
复制
- NODE_XCOMPONENT_ID = MAX_NODE_SCOPE_NUM * ARKUI_NODE_XCOMPONENT = 12000
XComponent组件的ID，支持属性设置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。
起始版本： 12
参数：
展开
| 参数项 | 描述 |
|---|---|
| .string | XComponent组件的ID内容，用于唯一标识该组件。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| .string | XComponent组件的ID内容，用于唯一标识该组件。 |
NODE_XCOMPONENT_TYPE
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
收起
自动换行
深色代码主题
复制
- NODE_XCOMPONENT_TYPE = 12001
XComponent组件的类型，仅支持属性获取接口。
XComponent组件的类型需要在组件创建时通过ArkUI_NodeType中的ARKUI_NODE_XCOMPONENT或者ARKUI_NODE_XCOMPONENT_TEXTURE明确，不允许后续修改。
使用setAttribute接口尝试修改XComponent组件的类型时会发生绘制内容异常。
作为属性获取方法返回值ArkUI_AttributeItem格式如下。
起始版本： 12
返回：
展开
| 类型 | 说明 |
|---|---|
| .value[0].i32 | XComponent组件的类型，参数类型为ArkUI_XComponentType，具体枚举值及其与数字的对应关系请参见该枚举定义。 |
NODE_XCOMPONENT_SURFACE_SIZE
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
收起
自动换行
深色代码主题
复制
- NODE_XCOMPONENT_SURFACE_SIZE = 12002
XComponent组件所持有的Surface的宽高，仅支持属性获取接口。
使用setAttribute接口尝试修改Surface的宽高时，该设置不会生效。
作为属性获取方法返回值ArkUI_AttributeItem格式如下。
起始版本： 12
返回：
展开
| 类型 | 说明 |
|---|---|
| .value[0].u32 | 宽度数值，单位为px。 |
| .value[1].u32 | 高度数值，单位为px。 |
NODE_XCOMPONENT_SURFACE_RECT
Phone18+PC/2in118+Tablet18+TV19+Wearable18+
收起
自动换行
深色代码主题
复制
- NODE_XCOMPONENT_SURFACE_RECT = 12003
XComponent组件所持有的Surface显示区域，支持属性设置和属性获取接口。适用于需要在XComponent组件内指定局部区域进行渲染的场景，例如视频画面裁剪显示、画中画局部渲染等。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。
起始版本： 18
参数：
展开
| 参数项 | 描述 |
|---|---|
| .value[0].i32 | Surface显示区域相对于XComponent组件左上角的x轴坐标，单位为px。 |
| .value[1].i32 | Surface显示区域相对于XComponent组件左上角的y轴坐标，单位为px。 |
| .value[2].i32 | Surface显示区域的宽度，单位为px，取值必须为正整数。传入0或负数时设置不生效。 |
| .value[3].i32 | Surface显示区域的高度，单位为px，取值必须为正整数。传入0或负数时设置不生效。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| .value[0].i32 | Surface显示区域相对于XComponent组件左上角的x轴坐标，单位为px。 |
| .value[1].i32 | Surface显示区域相对于XComponent组件左上角的y轴坐标，单位为px。 |
| .value[2].i32 | Surface显示区域的宽度，单位为px，取值应为非负整数。 |
| .value[3].i32 | Surface显示区域的高度，单位为px。 |
NODE_XCOMPONENT_ENABLE_ANALYZER
Phone18+PC/2in118+Tablet18+TV19+Wearable18+
收起
自动换行
深色代码主题
复制
- NODE_XCOMPONENT_ENABLE_ANALYZER = 12004
XComponent组件是否支持图像分析的属性，支持属性设置和属性获取接口。开启后可对组件中显示的图像进行内容识别分析，适用于相机预览实时识别、图像内容理解等场景。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。
起始版本： 18
参数：
展开
| 参数项 | 描述 |
|---|---|
| .value[0].i32 | 是否支持图像分析，1表示支持图像分析，0表示不支持图像分析，默认值：0。传入非0和非1的值时按0处理。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| .value[0].i32 | 是否支持图像分析，1表示支持图像分析，0表示不支持图像分析。 |
相关推荐
华为开发者联盟 版权所有 ©2026
在 API参考 中进行搜索
请输入您想要搜索的关键词