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

文章目录

    • 前言
    • 主体
      • [1. **控件概述**](#1. 控件概述)
      • [2. **控件的样式和组成部分**](#2. 控件的样式和组成部分)
      • [3. **使用控件**](#3. 使用控件)
      • [4. **事件处理**](#4. 事件处理)
      • [5. **按键支持**](#5. 按键支持)
      • [6. **示例代码**](#6. 示例代码)
    • 总结

前言

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 表示开启):

    c 复制代码
    bool is_checked = lv_obj_has_state(switch_obj, LV_STATE_CHECKED);
  • 开启开关 :

    使用以下函数手动开启开关:

    c 复制代码
    lv_obj_add_state(switch_obj, LV_STATE_CHECKED);
  • 关闭开关 :

    使用以下函数手动关闭开关:

    c 复制代码
    lv_obj_remove_state(switch_obj, LV_STATE_CHECKED);

4. 事件处理

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

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

示例代码:

c 复制代码
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. 示例代码

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

c 复制代码
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 中,为用户提供友好的交互体验。

相关推荐
国科安芯5 小时前
卫星控制板偶发复位:MCU供电、时钟、ECC与总线的联合定位——AS32S601ZIT2在星载控制单元中的FAE排查方法
单片机·嵌入式硬件·mcu·risc-v·抗辐射·通信芯片
我不会插花弄玉5 小时前
13.多路转接epoll【由浅入深-网络】
网络·c++·epoll
郝学胜-神的一滴7 小时前
Effective STL 条款03:容器中的对象复制要廉价且正确
开发语言·数据结构·c++·算法·rpc·stl
Zw-awa7 小时前
姿态是怎么算出来的:互补解算、四元数和欧拉角
stm32
西西弗Sisyphus8 小时前
C++ explicit 关键字工程实践
开发语言·c++
AIgorithmGEEK10 小时前
std::unordered_map 与 std::unordered_set:接口、算法技巧与权衡 (速查)
c++·算法·哈希表·负载因子·桶·unordered_map·unordered_set
一拳一个呆瓜12 小时前
【STL】头文件:<cmath>
c++·stl
草莓熊Lotso13 小时前
【C++ 基于微服务的即时通讯系统】ElasticSearch 用户数据管理实现
linux·数据库·c++·elasticsearch·微服务·架构
慧都产品智能化13 小时前
Qt 开发 CAD/CAM 工序表的隐性成本分析
c++·qt·qt5·qt6.3
eggwyw15 小时前
linux下的C\C++多进程多线程编程实例详解
开发语言·c++