LVGL9.2 鼠标悬停处理

2025/2/25 12:37:03 来源：https://blog.csdn.net/m0_62599305/article/details/144459070 浏览: 次关键词：LVGL9.2 鼠标悬停处理

文章目录

前言
- - 鼠标悬停处理功能简介
  - 使用场景
  - - 1. **按钮悬停效果**
    - 2. **图标高亮**
    - 3. **动态工具提示**
  - 实现原理
  - 使用方法
  - - 1. 设置控件样式
    - 2. 监听悬停事件
  - 功能亮点
  - 注意事项
  - 总结

前言

在 v9.2 版本中，新增了许多功能，其中鼠标悬停处理（Mouse Hovering）是一个非常重要的更新。这个功能通过新增的 LV_STATE_HOVERED 状态，显著提升了用户界面对鼠标事件的响应能力和灵活性。

鼠标悬停处理功能简介

LV_STATE_HOVERED 是一个用于表示控件被鼠标悬停时的状态标志。其具体数值为 0x0010。通过这个状态，开发者可以轻松定义控件在鼠标悬停时的行为和视觉效果，例如改变颜色、显示阴影等。

使用场景

1. 按钮悬停效果

当鼠标指针悬停在按钮上时，按钮可以自动改变背景颜色或显示一个提示。

2. 图标高亮

在列表或菜单中，用户悬停某个图标时，该图标可以放大或高亮显示，帮助用户更直观地进行交互。

3. 动态工具提示

鼠标悬停特定控件时，可以显示上下文相关的工具提示或帮助信息。

实现原理

LV_STATE_HOVERED 的工作机制：

当鼠标指针进入某个控件区域时，该控件会被自动赋予 LV_STATE_HOVERED 状态。
当鼠标离开该控件时，状态会被清除。

控件的状态改变会触发事件或重新绘制，开发者可以在控件样式中对该状态进行设置。

使用方法

1. 设置控件样式

// 创建控件并设置默认样式
lv_obj_t * btn = lv_btn_create(lv_scr_act());
lv_obj_set_size(btn, 100, 50);
lv_obj_center(btn);// 定义悬停状态的样式
lv_style_t hover_style;
lv_style_init(&hover_style);
lv_style_set_bg_color(&hover_style, lv_color_hex(0xff0000));  // 设置悬停时背景为红色// 绑定样式到控件
lv_obj_add_style(btn, &hover_style, LV_STATE_HOVERED);

2. 监听悬停事件

通过事件回调函数处理鼠标悬停：

void hover_event_cb(lv_event_t * e) {lv_event_code_t code = lv_event_get_code(e);lv_obj_t * obj = lv_event_get_target(e);if (code == LV_EVENT_HOVERED) {lv_obj_set_style_bg_color(obj, lv_color_hex(0x00ff00), LV_PART_MAIN);  // 悬停时变绿} else if (code == LV_EVENT_LEAVE) {lv_obj_set_style_bg_color(obj, lv_color_hex(0x0000ff), LV_PART_MAIN);  // 离开时变蓝}
}// 绑定事件回调
lv_obj_add_event_cb(btn, hover_event_cb, LV_EVENT_HOVERED | LV_EVENT_LEAVE, NULL);