名词	核心作用维度	存储位置	作用对象	关键字前缀 / 宏
Style 样式	外观视觉：颜色、字体、圆角、间距	单独lv_style_t结构体 / 控件内置内联样式	控件某区域、某交互状态	lv_style_set_*
State 状态	交互动态：用户操作带来的临时状态（按下 / 勾选 / 禁用）	控件内部位标记，运行时动态变化	整个控件，搭配 Part 限定区域	LV_STATE_*
Part 部件	空间分区：一个控件内部多块独立图形区域	写在选择器selector 里，静态分区	控件内部局部区块	LV_PART_*
Flag 标志	控件全局固定开关：隐藏、可滚动、点击锁定等永久属性	控件头部位标记，长期生效	整个控件，不分区域、不分状态	LV_OBJ_FLAG_*

一个控件拆分出多个独立绘图区块，用来分别给不同区块设置外观(同一控件不同 PART 可以单独设置颜色、字体、圆角，互不干扰)

• 静态：控件创建后分区固定，不会随触摸变化；
• 仅用于样式匹配规则，不控制控件行为。

常用宏：LV_PART_MAIN（默认主体）、LV_PART_INDICATOR滑块填充、LV_PART_KNOB拖动圆钮、LV_PART_SCROLLBAR滚动条、LV_PART_SELECTED选中条目。

使用位置：和 State 做位或，拼成第三个 selector 参数

LV_STATE_PRESSED | LV_PART_KNOB

每个复杂控件内部由多个独立可视区块组成，LV_PART_* 用来指定「当前样式作用在控件的哪一块图形区域」。部件是静态固定的，控件创建后分区就不会改变，和用户触摸操作无关。

部件宏	含义	适用控件
LV_PART_MAIN	主体底板（默认值，省略 PART 自动用这个）	所有控件
LV_PART_INDICATOR	进度 / 开关高亮滑块、填充条	switch、slider、bar
LV_PART_KNOB	可拖动的圆形旋钮 / 滑块按钮	slider、switch
LV_PART_SCROLLBAR	垂直 / 水平滚动条	list、textarea、table
LV_PART_SELECTED	列表被选中的条目	list、table、roller
LV_PART_CURSOR	文本输入闪烁光标	textarea
LV_PART_HEADER	顶部标题栏	tabview、table

• LV_PART_MAIN：开关灰色底板长条
• LV_PART_INDICATOR：滑块滑动后填充的彩色进度
• LV_PART_KNOB：白色可拖动小圆钮

• LV_PART_MAIN：整条灰色轨道
• LV_PART_INDICATOR：滑过的蓝色进度条
• LV_PART_KNOB：轨道上圆形拖动按钮

1. 不写 PART 时，selector 默认等价 LV_PART_MAIN；

// 简写 lv_obj_set_style_bg_color(btn, lv_color_white(), LV_STATE_DEFAULT); // 完整等价 lv_obj_set_style_bg_color(btn, lv_color_white(), LV_STATE_DEFAULT | LV_PART_MAIN);

描述控件当前的交互临时状态，由触摸、点击、勾选切换，只影响样式渲染，不改变控件全局行为。常用宏：LV_STATE_DEFAULT默认、LV_STATE_PRESSED按下、LV_STATE_CHECKED勾选、LV_STATE_FOCUSED焦点、LV_STATE_DISABLED禁用。

特点：

1. 可叠加：LV_STATE_PRESSED | LV_STATE_CHECKED；
2. 只作用样式渲染，不能控制隐藏 / 滚动这类全局行为；
3. 配合 Part：限定「哪种状态下，哪个区块变样式」。

存放一套视觉属性：字体、背景色、文字颜色、圆角、边框、内边距等。两种存在形式：

1. 公共样式：独立lv_style_t，可多控件复用；
2. 内联样式：lv_obj_set_style_xxx()直接写在控件内部，仅当前控件生效。

绑定规则：样式不会自动生效，必须挂载时指定 State | Part 匹配条件：

// 公共样式挂载 lv_obj_add_style(obj, &my_style, LV_STATE_DEFAULT | LV_PART_MAIN); // 内联样式直接绑定规则 lv_obj_set_style_bg_color(obj, lv_color_red(), LV_STATE_PRESSED | LV_PART_MAIN);

一句话：Style 是 “长啥样”，State+Part 是 “什么时候、哪块区域长这样”。

控制控件整体功能行为，作用于整个控件全部区域，不区分 Part、不区分 State，优先级高于样式。常用宏：

• LV_OBJ_FLAG_HIDDEN 隐藏控件（你切换页面核心用法）
• LV_OBJ_FLAG_SCROLLABLE 允许滚动
• LV_OBJ_FLAG_CLICKABLE 允许点击
• LV_OBJ_FLAG_DISABLED 全局禁用（和 STATE_DISABLED 区分）

API：

lv_obj_add_flag(obj, LV_OBJ_FLAG_HIDDEN); // 开启标志 lv_obj_clear_flag(obj, LV_OBJ_FLAG_HIDDEN); // 关闭标志 lv_obj_has_flag(obj, LV_OBJ_FLAG_HIDDEN); // 判断标志

1. LV_OBJ_FLAG_DISABLED：标志，全局锁死控件，完全无法交互，所有样式失效；
2. LV_STATE_DISABLED：仅样式标记，只是渲染灰色禁用外观，控件仍可响应触摸。

需求：

1. 页面默认隐藏（Flag）；
2. 开关底板常态灰色、按下浅蓝色（State+Part=MAIN，Style = 颜色）；
3. 滑块勾选时绿色（State+Part=INDICATOR，Style = 绿色）；
4. 拖动圆钮按下变红（State+Part=KNOB，Style = 红色）。

// 1. Flag：整个控件隐藏（全局行为，不分区域/状态） lv_obj_add_flag(sw, LV_OBJ_FLAG_HIDDEN); // 2. 主体底板：默认灰色 lv_obj_set_style_bg_color(sw, lv_grey(), LV_STATE_DEFAULT | LV_PART_MAIN); // 3. 主体底板：按下浅蓝色 lv_obj_set_style_bg_color(sw, lv_light_blue(), LV_STATE_PRESSED | LV_PART_MAIN); // 4. 填充滑块：勾选绿色 lv_obj_set_style_bg_color(sw, lv_green(), LV_STATE_CHECKED | LV_PART_INDICATOR); // 5. 拖动圆钮：按下红色 lv_obj_set_style_bg_color(sw, lv_red(), LV_STATE_PRESSED | LV_PART_KNOB);

1. Flag 和 State 区别

• Flag：控件全局功能开关（隐藏、滚动、能否点击），永久生效，不影响外观渲染逻辑；
• State：仅用于样式渲染，临时交互标记，不改变控件行为。

1. Part 和 State 区别

• Part：空间，分区块；
• State：交互，分操作； 二者通过|拼接，作为样式生效的筛选条件。

1. Style 和 另外三者 Style 是外观数据，State+Part 是这套外观的生效条件；Flag 是完全独立的控件行为开关，和样式渲染体系无关。

• Flag：管控件能不能看见、能不能点（全局行为）
• Part：管控件哪一块绘图（空间分区）
• State：管用户对控件做了什么操作（交互状态）
• Style：管这块区域在这个状态下长什么样子（视觉外观）

二、区分LVGL 标志 (FLAG)、状态 (STATE)

一、控件标志 FLAG（lv_obj_set_flag /lv_obj_clear_flag）

1. 标志是什么

2. 标志操作 API

3. 最常用 FLAG 清单（高频）

使用示例

二、状态 STATE（LV_STATE_XXX，样式选择器）

1. 状态是什么

2. 核心常用 STATE

使用示例（搭配样式）

三、FLAG（标志） 和 STATE（状态）核心区别

1. 本质属性不同

2. 作用对象不同

3. 生命周期对比

4. 操作方式对比

5. 能否位或组合

6. 直观对比表格

关键举例区分