鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(鼠标事件)

鸿蒙Harmony应用开发—ArkTS声明式开发(通用属性:禁用控制) ArkTS声明式开发(通用属性:禁用控制) 阅读详情

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


鼠标事件

在鼠标的单个动作触发多个事件时,事件的顺序是固定的,鼠标事件默认透传。

说明

  • 从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
  • 目前仅支持通过外接鼠标触发。

onMouse

onMouse(event: (event: MouseEvent) => void)

当前组件被鼠标按键点击时或者鼠标在组件上悬浮移动时,触发该回调。

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

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

参数:

参数名类型必填说明
eventMouseEvent是返回触发事件时的时间戳、鼠标按键、动作、鼠标位置在整个屏幕上的坐标和相对于当前组件的坐标。

MouseEvent对象说明

继承于BaseEvent。

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

名称属性类型描述
xnumber

鼠标位置相对于当前组件左上角的x轴坐标。

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

ynumber

鼠标位置相对于当前组件左上角的y轴坐标。

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

buttonMouseButton

鼠标按键。

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

actionMouseAction

鼠标动作。

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

stopPropagation() => void

阻塞事件冒泡。

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

targetEventTarget

触发事件的元素对象显示区域。

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

windowX10+number

鼠标位置相对于应用窗口左上角的x轴坐标。

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

windowY10+number

鼠标位置相对于应用窗口左上角的y轴坐标。

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

displayX10+number

鼠标位置相对于应用屏幕左上角的x轴坐标。

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

displayY10+number

鼠标位置相对于应用屏幕左上角的y轴坐标。

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

screenX(deprecated)number

鼠标位置相对于应用窗口左上角的x轴坐标。

从API Version 10开始不再维护,建议使用windowX代替。

screenY(deprecated)number

鼠标位置相对于应用窗口左上角的y轴坐标。

从API Version 10开始不再维护,建议使用windowY代替。

示例

该示例通过按钮设置了鼠标事件,通过鼠标点击按钮可以触发onMouse事件,获取鼠标事件相关参数。

// xxx.ets
@Entry
@Component
struct MouseEventExample {
  @State hoverText: string = 'no hover';
  @State mouseText: string = '';
  @State action: string = '';
  @State mouseBtn: string = '';
  @State color: Color = Color.Blue;

  build() {
    Column({ space: 20 }) {
      Button(this.hoverText)
        .width(180).height(80)
        .backgroundColor(this.color)
        .onHover((isHover: boolean, event: HoverEvent) => {
          // 通过onHover事件动态修改按钮在是否有鼠标悬浮时的文本内容与背景颜色
          if (isHover) {
            this.hoverText = 'hover';
            this.color = Color.Pink;
          } else {
            this.hoverText = 'no hover';
            this.color = Color.Blue;
          }
        })
      Button('onMouse')
        .width(180).height(80)
        .onMouse((event: MouseEvent):void => {
          if(event){
            switch (event.button) {
              case MouseButton.None:
                this.mouseBtn = 'None';
                break;
              case MouseButton.Left:
                this.mouseBtn = 'Left';
                break;
              case MouseButton.Right:
                this.mouseBtn = 'Right';
                break;
              case MouseButton.Back:
                this.mouseBtn = 'Back';
                break;
              case MouseButton.Forward:
                this.mouseBtn = 'Forward';
                break;
              case MouseButton.Middle:
                this.mouseBtn = 'Middle';
                break;
            }
            switch (event.action) {
              case MouseAction.Hover:
                this.action = 'Hover';
                break;
              case MouseAction.Press:
                this.action = 'Press';
                break;
              case MouseAction.Move:
                this.action = 'Move';
                break;
              case MouseAction.Release:
                this.action = 'Release';
                break;
            }
            this.mouseText = 'onMouse:\nButton = ' + this.mouseBtn +
            '\nAction = ' + this.action + '\nXY=(' + event.x + ',' + event.y + ')' +
            '\nwindowXY=(' + event.windowX + ',' + event.windowY + ')';
          }
        })
      Text(this.mouseText)
    }.padding({ top: 30 }).width('100%')
  }
}

示意图:

鼠标点击时:

HarmonyOS NEXT实战(5.0 )ArkUI开发>键鼠输入事件 支持的鼠标事件包含通过外设鼠标、触控板触发的事件。 阅读详情

相关推荐

鸿蒙5.0版开发:ArkTS高级组件-@ohos.arkui.advanced.Counter (计数器组件)

Counter是用于精确调节数值的组件。

m0_69424697的博客 1150

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(菜单控制)

为组件绑定弹出式菜单,弹出式菜单以垂直列表形式显示菜单项,可通过长按、点击或鼠标右键触发。

Androidbye的博客 1193

鸿蒙Harmony应用开发—ArkTS声明式开发(通用属性:鼠标光标控制)

ArkTS声明式开发-通用属性:鼠标光标控制

m0_64420071的博客 1762

【鸿蒙next开发】ArkUI框架:ArkTS组件-鼠标事件

本文详细介绍了鸿蒙5.0开发中的鼠标事件处理机制,特别是onMouse回调函数的使用。

m0_73088370的博客 792

鸿蒙5.0版开发:ArkTS高级组件-@ohos.arkui.advanced.SelectionMenu (文本选择菜单)

文本选择菜单,适用于富文本组件通过bindSelectionMenu绑定自定义文本选择菜单.......

m0_69424697的博客 1219

鸿蒙5.0版开发:ArkTS组件-SelectionMenu

文本选择菜单,适用于富文本组件通过bindSelectionMenu绑定自定义文本选择菜单

m0_69424697的博客 969

【鸿蒙next开发】ArkUI框架:ArkTS组件-触摸事件

本文详细介绍了鸿蒙5.0开发中的触摸事件处理机制,包括onTouch回调的使用、TouchEvent和TouchObject对象的属性及方法。

m0_73088370的博客 946

鸿蒙5.0版开发:ArkTS组件-自定义手势判定

为组件提供自定义手势判定能力。开发者可根据需要,在手势识别期间,决定是否响应手势。

m0_69424697的博客 1016

【鸿蒙next开发】ArkUI框架:ArkTS组件-SelectionMenu

本文介绍了鸿蒙HarmonyOS 5.0中的SelectionMenu组件,用于为富文本组件提供自定义文本选择菜单功能。

m0_73088370的博客 721

鸿蒙Harmony应用开发—ArkTS声明式开发(通用属性:悬浮态效果)

ArkTS声明式开发(通用属性:悬浮态效果)

m0_64420071的博客 1854

鸿蒙Harmony应用开发—ArkTS-枚举说明

ArkTS-枚举说明

m0_64420071的博客 2692

【鸿蒙next开发】ArkUI框架:ArkTS组件-advanced.Counter

本文介绍了鸿蒙5.0中的Counter组件,这是一个用于精确调节数值的组件。

m0_73088370的博客 737

新版本大疆智图4.5 永久许可摄影测量建模软件

大疆智图支持常见格式的成果输出,包括 TIFF 正射影像和高程模型、LAS 格式点云,以及 B3DM、OSGB、OBJ 等六种常用格式的三维模型,还包括 DXF 和 SHP 等格式的等高线。大疆智图 DJI Terra是领先的三维重建软件,提供先进的技术和简单的操作,一站式解决方案,从航线规划到数据的获取,以及模型重建、数据分析等都提供独一无二的支持,优化项目工程,提供自动化优势,获得更有效智能的决策和行动,最终用户可以获得理想的结果,减轻工作压力,提高作业效率。质量报告和剖面查看功能有助于分析点云质量。

qq_62821232的博客 6928

【鸿蒙next开发】ArkUI框架:ArkTS组件-无障碍悬浮事件

本文介绍了鸿蒙5.0开发中的无障碍悬浮事件处理,重点讲解了onAccessibilityHover回调的使用方法。

m0_73088370的博客 1035

YOLOv8环境搭建+训练自己的数据详细项目

直接按照路径会有问题,找到自己 requirements.txt 文件路径,我这里是pip install -r D:\ultralytics-main\ultralytics-main\requirements.txt。首先去自己的anaconda的安装的envs(虚拟环境),在导航栏输入cmd,进入命令窗口。到官方网站下载yolo模型 ,下载好后解压,里面有个文件requirements.txt。然后安装ultralytics ,这是必须的。

m0_63172128的博客 2万+

数电实训:万年历

万年历

Lmyccq的博客 1万+

【鸿蒙next开发】ArkUI框架:ArkTS组件-菜单控制

本文详细介绍了鸿蒙5.0开发中的菜单控制功能,包括如何为组件绑定弹出式菜单、多级菜单的使用、以及不同API版本下的新增特性。

m0_73088370的博客 834

基于STM32的多模态智能风扇控制系统设计与实现

本文详细介绍了基于STM32单片机的多模态智能风扇控制系统的设计与实现。系统集成了红外遥控、蓝牙手机控制及人体感应等多模态交互方式,通过PWM技术实现无级调速,并设计了安全优先的控制逻辑。文章从硬件选型、核心原理、软件编程到系统调试,提供了完整的实战指南,适合嵌入式开发爱好者学习与实践。

weixin_28285943的博客 238

【鸿蒙next开发】ArkUI框架:ArkTS组件-Row

本文详细介绍了鸿蒙5.0开发中的Row组件,该组件用于水平方向布局,支持从API Version 7开始使用。

m0_73088370的博客 654

STM32 移植LwIP 实现网线插拔自动恢复

STM32 移植LwIP 之后,能正常联网通讯,但是发现2个问题, 1、上电初始化前,未插入网线,之后就无法获取到IP地址(DHCP) 2、正常通讯过程中,拔掉网线,然后插回去,不知道如何复位 先看一下LWIP初始化代码 /** * LwIP initialization function */ int MX_LWIP_Init() { /* Initilialize the LwIP stack with RTOS */ tcpip_init( NULL, NULL );

tiantangmoke的博客 8075

如何运用好DeepSeek为自己服务:智能增强的范式革命 || 目录

1.1 认知增强的三次浪潮1.2 DeepSeek认知增强模型1.3 人机认知耦合协议1.4 认知增强的数学基础。

𝓓𝓸𝓶𝓲𝓷𝓪𝓽𝓲𝓷𝓰 𝓐𝓵𝓵 𝓣𝓱𝓲𝓷𝓰𝓼 1226

【鸿蒙next开发】ArkUI框架:ArkTS组件-ListItem

本文详细介绍了鸿蒙5.0开发中的ListItem组件,包括其使用场景、接口、属性、事件及示例代码。

m0_73088370的博客 918

从MySQL到数据仓库:手把手教你用Airflow实现自动化ETL流水线

本文详细介绍了如何利用Airflow构建从MySQL到数据仓库的自动化ETL流水线,涵盖增量抽取策略、PySpark转换优化和数据质量监控等实战细节。特别适合中小规模企业构建高效数据仓库,提升数据处理效率和质量。

rnn9storyteller的博客 830

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(无障碍悬浮事件)

在开启无障碍模式后,Touch事件会转换为无障碍悬浮事件。

Androidbye的博客 766

华为OD机试真题 新系统2026-04-01 Python&JS 实现【空间占用计算】

员工A的磁盘空间经常被耗尽,他需要找到占用空间最大的目录或文件,然后决定如何清理文件释放空间。给定某一目录,请编写程序帮助他统计该目录内一级子目录和文件的占用空间,并返回目标目录一级子项(文件或子目录)中占用空间最大的项。

MISAYAONE的博客 1324

ET2012新版免狗免安装绿色软件

ET2012新版免狗免安祖昂绿色软件。,新界面,新视觉,

鸿蒙NEXT开发:ArkTS组件-通用事件(鼠标事件)

在鼠标的单个动作触发多个事件时,事件的顺序是固定的,鼠标事件默认透传。

ZPYQAQ的博客 816

迈瑞BS系列全自动生化分析仪LIS协议接口手册(内含HL7和ASTM)

迈瑞BS系列全自动生化分析仪LIS协议接口手册,内含HL7和ASTM)

上一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(焦点事件)
下一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(悬浮事件)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值