鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.arkui.componentUtils (componentUtils)

HarmonyOS NEXT实战开发:NDK接口接入ArkTS页面实例 使用NDK接口构建UI界面时,需要在ArkTS页面创建用于挂载NDK接口创建组件的占位组件。 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


@ohos.arkui.componentUtils (componentUtils)

提供获取组件绘制区域坐标和大小的能力。

说明

从API Version 10开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

本模块功能依赖UI的执行上下文,不可在UI上下文不明确的地方使用,参见UIContext说明。

从API version 10开始,可以通过使用UIContext中的getComponentUtils方法获取当前UI上下文关联的ComponentUtils对象。该接口需要在目标组件布局、完成以后获取目标组件区域大小信息,建议在@ohos.arkui.inspector(布局回调)接收到布局完成的通知以后使用该接口。

导入模块

import { componentUtils } from '@kit.ArkUI';

componentUtils.getRectangleById

getRectangleById(id: string): ComponentInfo

根据组件ID获取组件实例对象, 通过组件实例对象将获取的坐标位置和大小同步返回给开发者。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
idstring是指定组件id。

返回值:

类型说明
ComponentInfo组件大小、位置、平移缩放旋转及仿射矩阵属性信息。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
100001UI execution context not found.

示例:

import { componentUtils } from '@kit.ArkUI';
let modePosition:componentUtils.ComponentInfo = componentUtils.getRectangleById("onClick");

ComponentInfo

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
sizeSize是组件大小。
localOffsetOffset是组件相对于父组件信息。
windowOffsetOffset是组件相对于窗口信息。
screenOffsetOffset是组件相对于屏幕信息。
translateTranslateResult是组件平移信息。
scaleScaleResult是组件缩放信息。
rotateRotateResult是组件旋转信息。
transformMatrix4Result是仿射矩阵信息,根据入参创建的四阶矩阵对象。

Size

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
widthnumber是

组件宽度。

单位: px

heightnumber是

组件高度。

单位: px

Offset

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
xnumber是

x点坐标。

单位: px

ynumber是

y点坐标。

单位: px

TranslateResult

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
xnumber是

x轴平移距离。

单位: px

ynumber是

y轴平移距离。

单位: px

znumber是

z轴平移距离。

单位: px

ScaleResult

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
xnumber是

x轴缩放倍数。

单位: px

ynumber是

y轴缩放倍数。

单位: px

znumber是

z轴缩放倍数。

单位: px

centerXnumber是

变换中心点x轴坐标。

单位: px

centerYnumber是

变换中心点y轴坐标。

单位: px

RotateResult

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
xnumber是

旋转轴向量x坐标。

单位: px

ynumber是

旋转轴向量y坐标。

单位: px

znumber是

旋转轴向量z坐标。

单位: px

anglenumber是

旋转角度。

单位: px

centerXnumber是

变换中心点x轴坐标。

单位: px

centerYnumber是

变换中心点y轴坐标。

单位: px

Matrix4Result

type Matrix4Result = [number,number,number,number,number,number,number,number,number,number,number,number,number,number,number,number]

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

类型说明

[number,number,number,number,

number,number,number,number,

number,number,number,number,

number,number,number,number]

取值范围为长度为16(4*4)的number数组, 详情见四阶矩阵说明,单位: px

四阶矩阵说明:

参数名类型必填说明
m00number是x轴缩放值,单位矩阵默认为1。
m01number是第2个值,xyz轴旋转会影响这个值。
m02number是第3个值,xyz轴旋转会影响这个值。
m03number是无实际意义。
m10number是第5个值,xyz轴旋转会影响这个值。
m11number是y轴缩放值,单位矩阵默认为1。
m12number是第7个值,xyz轴旋转会影响这个值。
m13number是无实际意义。
m20number是第9个值,xyz轴旋转会影响这个值。
m21number是第10个值,xyz轴旋转会影响这个值。
m22number是z轴缩放值,单位矩阵默认为1。
m23number是无实际意义。
m30number是x轴平移值,单位px,单位矩阵默认为0。
m31number是y轴平移值,单位px,单位矩阵默认为0。
m32number是z轴平移值,单位px,单位矩阵默认为0。
m33number是齐次坐标下生效,产生透视投影效果。

示例:

说明

推荐通过使用UIContext中的getComponentUtils方法获取当前UI上下文关联的ComponentUtils对象。

import { matrix4, componentUtils } from '@kit.ArkUI';

@Entry
@Component
struct Utils {
@State x: number = 120;
@State y: number = 10;
@State z: number = 100;
@State value: string = '';
private matrix1 = matrix4.identity().translate({ x: this.x, y: this.y, z: this.z });

build() {
  Column() {
    Image($r("app.media.img"))
      .transform(this.matrix1)
      .translate({ x: 20, y: 20, z: 20 })
      .scale({ x: 0.5, y: 0.5, z: 1 })
      .rotate({
        x: 1,
        y: 1,
        z: 1,
        centerX: '50%',
        centerY: '50%',
        angle: 300
      })
      .width(300)
      .height(100)
      .key("image_01")
    Button('getRectangleById')
    .onClick(() => {
      this.value = JSON.stringify(componentUtils.getRectangleById("image_01")) // 建议使用this.getUIContext().getComponentUtils()接口
    }).margin(10).id('onClick')
    Text(this.value)
      .margin(20)
      .width(300)
      .height(300)
      .borderWidth(2)
  }.margin({left: 50})
}
}

鸿蒙5.0版开发:UI界面-@ohos.arkui.componentUtils (componentUtils) 提供获取组件绘制区域坐标和大小的能力。 阅读详情

相关推荐

鸿蒙NEXT开发:ArkUI框架UI界面-@ohos.arkui.componentUtils (componentUtils)

提供获取组件绘制区域坐标和大小的能力。

ZPYQAQ的博客 931

HarmonyOS鸿蒙开发如何读取工程目录中的非图片资源文件(pdf,word,txt等等)的uri

而且文件必须保存在特定目录下,以yyyy.pdf为例。这些里面是找不到项目目录中的资源文件的。将文件写入沙盒路径获取uri。然后通过资源管理方式读取。

qq_15509071的博客 2549

鸿蒙NEXT开发:ArkUI框架UI界面-@ohos.arkui.uiExtension (uiExtension)

用于EmbeddedUIExtensionAbility(或UIExtensionAbility)中获取宿主应用的窗口信息或对应的EmbeddedComponent组件的信息。

ZPYQAQ的博客 1173

HarmonyOS实战开发:@ohos.arkui.UIContext (UIContext)

在Stage模型中,WindowStage/Window可以通过loadContent接口加载页面并创建UI的实例

2401_84194030的博客 2554

HarmonyOS实战开发:UI框架-ArkTS组件(自定义组件内置方法)

自定义组件内置方法是由ArkUI开发框架提供给应用开发者的,定义在自定义组件基类上的API。应用开发者可以在自定义组件的实例上调用对应的API以获取当前自定义组件实例相关的信息。例如,查询当前自定组件上下文的UIContext信息。

2401_84917132的博客 1596

鸿蒙NEXT开发【@ohos.arkui.StateManagement (状态管理)】 UI界面API

状态管理模块提供了应用程序的数据存储能力、持久化数据管理能力、UIAbility数据存储能力和应用程序需要的环境状态、工具。

CS9527DND的博客 1011

鸿蒙5.0版开发:ArkUI框架开发-嵌入ArkTS组件

ArkUI在Native侧提供的能力作为ArkTS的子集...........

m0_73088370的博客 1320

HarmonyOS开发(ArkUI简单使用)

Componentbuild(){//组件UI描述@Componentbuild(){//使用组件Com({title:'标题'})//UI描述@Componentbuild(){@Component//UI描述build(){

2301_79568779的博客 2260

鸿蒙5.0版开发:ArkUI框架开发-自定义占位节点

ArkUI提供了ArkTS原生组件作为自定义节点的占位节点。

m0_73088370的博客 609

鸿蒙NEXT开发【@ohos.arkui.drawableDescriptor (DrawableDescriptor)】 UI界面API

本模块提供获取pixelMap的能力,包括前景、背景、蒙版和分层图标。

CS9527DND的博客 1101

HarmonyOS Next开发学习手册——动画曲线

动画曲线是属性关于时间的变化函数,决定属性变化时产生动画的运动轨迹。某一时刻下动画曲线的斜率代表动画的速度,对应属性变化的快慢。一条优秀的动画曲线具备连续光滑、符合用户意图、符合物理世界客观规律的特点。开发者可结合用户的使用场景和意图,为动效选取合适的动画曲线。根据动画曲线是否符合物理世界客观规律,可将其分为物理曲线(ArkUI当前提供了多种物理弹簧曲线)和传统曲线两种类型。相比于传统曲线,物理曲线产生的运动轨迹更加符合用户认知,有助于创造自然生动的动画效果,建议开发者优先使用物理曲线。

maniuT的博客 939

OpenHarmony应用开发—ArkUI组件集合

使用全局组件ShowToast,TitleBar,IntroductionTitle实现按钮,时间选择器,单选按钮,选择菜单,滑动条,切换按钮,勾选框,文本选择器,时间选择器,计数器,评分条组件功能。使用全局组件TitleBar,AttributeModificationTool实现二维码,进度条,跑马灯,文字计时器,文字时钟,仪表盘,数据面板组件功能。若不存在三级导航,则跳转至详情页面。使用全局组件TitleBar实现标记,滚动条,下拉刷新,弹出面板,字母索引条组件功能。

OpenHarmony_dev的博客 1121

鸿蒙NEXT开发ArkUI【BuilderNode】 UI界面

节点渲染类型枚举。

CS9527DND的博客 916

鸿蒙Harmony应用开发—ArkTS-高级组件:@ohos.arkui.advanced.ComposeTitleBar(头像和单双行文本标题栏)

一种普通标题栏,支持设置标题、头像(可选)和副标题(可选),可用于一级页面、二级及其以上界面配置返回键。

m0_64420071的博客 1670

鸿蒙HarmonyOS开发:构建ArkUI应用级和页面级主题设置

针对应用,构建ArkUI应用级和页面级主题设置能力,并提供局部深浅色模式设置、动态换肤等功能。

2401_84917132的博客 1481

鸿蒙HarmonyOS开发:嵌入ArkTS组件

ArkUI在Native侧提供的能力作为ArkTS的子集,部分能力不会在Native侧提供,如声明式UI语法,自定义struct组件,UI高级组件。

2401_84917132的博客 1106

鸿蒙 @ohos.arkui.componentUtils (componentUtils)

获取组件的绘制区域坐标和大小:通过方法,可以获取指定组件的大小、位置、平移、缩放、旋转及仿射矩阵等信息。模块为鸿蒙开发提供了强大的功能,用于获取组件的绘制区域坐标和大小信息。通过方法,开发者可以轻松获取组件的详细信息,从而实现动态布局、交互效果以及用户界面测试等复杂功能。希望本文能帮助你更好地理解和使用模块。如果有任何问题或需要进一步讨论,欢迎随时交流!

小淼淼的博客 2225

CrackerXI+脱壳实战:解决iOS应用逆向中的加密文件问题

本文详细介绍了如何使用CrackerXI+工具对iOS应用进行脱壳,解决App Store应用因FairPlay DRM加密而无法进行静态分析的难题。通过图形化界面一键操作,CrackerXI+能高效获取解密后的可执行文件,为逆向工程奠定基础。文章涵盖工具选型、实战步骤及常见问题排查,是iOS逆向入门与进阶的实用指南。

seed的博客 261

HarmonyOS实战开发:@ohos.arkui.componentUtils (componentUtils)

提供获取组件绘制区域坐标和大小的能力。

2401_84194030的博客 1580

SAP 财务BAPI_ACC_DOCUMENT_POST批导的税务tax

最近遇到了关于SAP财务凭证批导要bapi:BAPI_ACC_DOCUMENT_POST增加税的功能要求,查阅了一众文献发现都不尽如人意,所以想着自己写一个趟过的雷吧。 一般前台sap的凭证是有自动计算税码的勾选框的,但是bapi却并没有这个字段。 实际操作过程中1.可以定义一个税额的结构,参考bapiactx09 2.在会计分录上传如果需要增加税码的时候,譬如总账gl,需要对应tax_code 3.通过CALCULATE_TAX_FROM_GROSSAMOUNT 计算出税额和acct_k...

qq_35640448的博客 3189
上一篇: 鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.arkui.componentSnapshot (组件截图)
下一篇: 鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.arkui.dragController (DragController)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值