鸿蒙5.0版开发：ArkTS组件通用属性（鼠标光标控制）

往期鸿蒙全套实战文章必看：

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

鼠标光标控制

控制鼠标光标的显示样式。

说明：

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

cursorControl

setCursor

setCursor(value: PointerStyle): void

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

方法语句中可使用的全局接口，调用此接口可以更改当前的鼠标光标样式。

参数：

名称	类型	必填	描述
value	PointerStyle	是	设置的鼠标样式。

restoreDefault

restoreDefault(): void

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

方法语句中可使用的全局接口，调用此接口可以将鼠标光标恢复成默认的箭头光标样式。

示例

// xxx.ets
import pointer from '@ohos.multimodalInput.pointer';

@Entry
@Component
struct CursorControlExample {
  @State text: string = ''
  controller: TextInputController = new TextInputController()

  build() {
    Column() {
      Row().height(200).width(200).backgroundColor(Color.Green).position({x: 150 ,y:70})
        .onHover((flag) => {
          if (flag) {
            cursorControl.setCursor(pointer.PointerStyle.EAST)
          } else {
            cursorControl.restoreDefault()
          }
        })
      Row().height(200).width(200).backgroundColor(Color.Blue).position({x: 220 ,y:120})
        .onHover((flag) => {
          if (flag) {
            cursorControl.setCursor(pointer.PointerStyle.WEST)
          } else {
            cursorControl.restoreDefault()
          }
        })
    }.width('100%')
  }
}

示意图：

当鼠标悬浮在蓝色区域时，显示：向西箭头光标

当鼠标悬浮在绿色区域时，显示：向东箭头光标

看完三件事❤️

• 如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
• 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
• 关注作者，不定期分享原创知识。
• 同时可以期待后续文章ing🚀。