鸿蒙NEXT开发:ArkTS组件-手势处理(RotationGesture)

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


RotationGesture

用于触发旋转手势事件,触发旋转手势的最少手指为2指,最大为5指,最小改变度数为1度。该手势不支持通过触控板双指旋转操作触发。

说明

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

接口

RotationGesture(value?: { fingers?: number, angle?: number })

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

参数:

参数名称参数类型必填参数描述
fingersnumber

触发旋转的最少手指数, 最小为2指,最大为5指。

默认值:2

触发手势手指可以多于fingers数目,但只有先落下的两指参与手势计算。

anglenumber

触发旋转手势的最小改变度数,单位为deg。

默认值:1

说明:

当改变度数的值小于等于0或大于360时,会被转化为默认值。

事件

名称功能描述
onActionStart(event:(event: GestureEvent) => void)

Rotation手势识别成功回调。

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

onActionUpdate(event:(event: GestureEvent) => void)

Rotation手势移动过程中回调。

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

onActionEnd(event:(event: GestureEvent) => void)

Rotation手势识别成功,手指抬起后触发回调。

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

onActionCancel(event: () => void)

Rotation手势识别成功,接收到触摸取消事件触发回调。

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

属性

名称类型描述
tag11+string

设置Rotation手势标志,用于自定义手势判定时区分绑定的手势。

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

allowedTypes14+Array<SourceTool>

设置Rotation手势支持的事件输入源。

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

示例

该示例通过配置RotationGesture实现了双指旋转手势的识别。

// xxx.ets
@Entry
@Component
struct RotationGestureExample {
  @State angle: number = 0
  @State rotateValue: number = 0

  build() {
    Column() {
      Column() {
        Text('RotationGesture angle:' + this.angle)
      }
      .height(200)
      .width(300)
      .padding(20)
      .border({ width: 3 })
      .margin(80)
      .rotate({ angle: this.angle })
      // 双指旋转触发该手势事件
      .gesture(
      RotationGesture()
        .onActionStart((event: GestureEvent) => {
          console.info('Rotation start')
        })
        .onActionUpdate((event: GestureEvent) => {
          if (event) {
            this.angle = this.rotateValue + event.angle
          }
        })
        .onActionEnd((event: GestureEvent) => {
          this.rotateValue = this.angle
          console.info('Rotation end')
        })
      )
    }.width('100%')
  }
}

### 鸿蒙原生应用开发 ArkTS 快速入门教程 #### 了解 ArkTS 编程语言 ArkTS 是一种专门为鸿蒙操作系统设计的编程语言,旨在简化应用程序开发过程并提高效率。该语言融合了许多现代编程特性,使得开发者能够更轻松地构建高性能的应用程序[^2]。 #### 设置开发环境 为了开始使用 ArkTS 进行开发,首先需要安装合适的 IDE 和工具链。推荐使用的集成开发环境是 DevEco Studio,它提供了完整的项目创建向导和支持 ArkTS 的插件。通过访问官方网站下载最新版本,并按照说明完成设置。 #### 创建第一个 ArkTS 应用程序 一旦开发环境准备好之后就可以着手建立首个基于 ArkTS 构建的小型 demo app 来熟悉其语法结构: 1. 打开 DevEco Studio 并新建一个 HarmonyOS 工程; 2. 在工程配置阶段选择支持 TypeScript 或 JavaScript 类型的语言选项; 3. 添加必要的依赖库来增强功能实现; 下面是一个简单的 "Hello World!" 实现例子: ```typescript // HelloWorld.ts 文件内容如下所示 import { Text, Column } from '@ohos/arkui'; export default function App() { return ( <Column> <Text>Hello World!</Text> </Column> ); } ``` 这段代码定义了一个名为 `App` 的组件,在其中包含了用于显示文本消息 `<Text>` 组件以及布局容器 `<Column>` 。当运行此应用程序时将会看到屏幕上呈现 “Hello World!” 字样[^5]。 #### 学习更多高级特性和最佳实践 随着对基础概念掌握程度加深后还可以进一步探索诸如状态管理、路由导航等方面的知识点。此外,《鸿蒙之光HarmonyOS NEXT原生应用开发入门》这本书籍和技术文档也是很好的参考资料之一,书中不仅介绍了理论知识还涵盖了大量实际案例分析帮助读者更好地理解如何运用这些技巧到具体场景当中去[^4]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值