LVGL9 开关控件 (lv_switch) 使用指南

---

前言

lv_switch 是 LittlevGL 提供的一个开关控件，外观类似一个小型滑块，常用于实现开关功能，用来开启或关闭某项功能。通过其灵活的样式和交互特性，lv_switch 在 UI 开发中非常实用。

---

主体

1. 控件概述

lv_switch 是一种交互控件，通常表示一个二元状态：开启或关闭。它的外观基于滑块设计，用户可以通过拖动或点击控件来改变其状态。

---

2. 控件的样式和组成部分

lv_switch 的样式分为以下部分：

• LV_PART_MAIN：控件的背景区域。支持所有典型的背景样式属性，如颜色、圆角和边框。padding 属性可以调整背景区域的大小。

• LV_PART_INDICATOR：指示当前状态的滑块条。支持背景样式属性，例如改变颜色以表示“开启”或“关闭”状态。

• LV_PART_KNOB：滑块的圆形或矩形按钮，位于滑块条的左侧或右侧。支持背景样式属性，包括大小、形状和边距。默认情况下，旋钮的尺寸与滑块的较小一侧相等，可以通过 padding 调整其大小和位置。

开发者可以通过这些样式自定义控件的外观，例如改变滑块的颜色或按钮的形状。

---

3. 使用控件

改变开关状态

lv_switch 使用标准的 LV_STATE_CHECKED 状态来表示开关的开启状态。以下是状态的相关操作：

• 获取当前状态：
  使用以下函数检查开关是否开启（true 表示开启）：

  bool is_checked = lv_obj_has_state(switch_obj, LV_STATE_CHECKED);
  

• 开启开关：
  使用以下函数手动开启开关：

  lv_obj_add_state(switch_obj, LV_STATE_CHECKED);
  

• 关闭开关：
  使用以下函数手动关闭开关：

  lv_obj_remove_state(switch_obj, LV_STATE_CHECKED);
  

---

4. 事件处理

lv_switch 提供了一个事件来响应状态变化：

• LV_EVENT_VALUE_CHANGED：当开关的状态改变时触发该事件。可以通过事件回调函数获取状态变化信息。

示例代码：

void switch_event_cb(lv_event_t * e) {lv_obj_t * obj = lv_event_get_target(e);bool is_on = lv_obj_has_state(obj, LV_STATE_CHECKED);if (is_on) {printf("Switch is ON\n");} else {printf("Switch is OFF\n");}
}// 注册事件
lv_obj_add_event_cb(switch_obj, switch_event_cb, LV_EVENT_VALUE_CHANGED, NULL);

---

5. 按键支持

lv_switch 提供以下按键操作：

• LV_KEY_UP/RIGHT：开启开关。
• LV_KEY_DOWN/LEFT：关闭开关。
• LV_KEY_ENTER：切换开关状态（开启或关闭）。

---

6. 示例代码

以下示例展示了如何创建一个开关控件并监听其状态变化：

void create_switch_example() {// 创建一个开关控件lv_obj_t * switch_obj = lv_switch_create(lv_scr_act());// 设置开关的位置lv_obj_align(switch_obj, LV_ALIGN_CENTER, 0, 0);// 添加状态改变事件回调lv_obj_add_event_cb(switch_obj, switch_event_cb, LV_EVENT_VALUE_CHANGED, NULL);
}void switch_event_cb(lv_event_t * e) {lv_obj_t * obj = lv_event_get_target(e);if (lv_obj_has_state(obj, LV_STATE_CHECKED)) {printf("Switch is ON\n");} else {printf("Switch is OFF\n");}
}

---

总结

lv_switch 是一个直观且功能强大的开关控件，适用于需要二元状态切换的场景。通过灵活的样式和简单的事件处理，开发者可以轻松地将其集成到 UI 中，为用户提供友好的交互体验。