样式属性(Style properties)

样式属性

https://lvgl.100ask.net/8.1/overview/style-props.html#

一、尺寸与位置(Size and position)
控制对象的大小、位置、变换等基础布局属性。

属性名说明默认值继承性布局影响扩展绘制
width设置对象宽度,支持像素值、百分比(基于父对象内容区宽度)和 LV_SIZE_CONTENT(自适应内容)0
min_width设置最小宽度,支持像素值和百分比(基于父对象内容区宽度)0
max_width设置最大宽度,支持像素值和百分比(基于父对象内容区宽度)0
height设置对象高度,支持像素值、百分比(基于父对象内容区高度)和 LV_SIZE_CONTENT(自适应内容)0
min_height设置最小高度,支持像素值和百分比(基于父对象内容区高度)0
max_height设置最大高度,支持像素值和百分比(基于父对象内容区高度)0
x设置对象X坐标(需结合对齐方式),支持像素值和百分比(基于父对象内容区宽度)0
y设置对象Y坐标(需结合对齐方式),支持像素值和百分比(基于父对象内容区高度)0
align设置对齐方式(决定X/Y坐标参考点),可选值包括各类LV_ALIGN开头的对齐方式0
transform_width向两侧扩展宽度,支持像素值和百分比(基于对象自身宽度)0
transform_height向两侧扩展高度,支持像素值和百分比(基于对象自身高度)0
translate_x在X轴移动对象(布局后应用),支持像素值和百分比(基于对象自身宽度)0
translate_y在Y轴移动对象(布局后应用),支持像素值和百分比(基于对象自身高度)0
transform_zoom缩放图像类对象,256(LV_IMG_ZOOM_NONE)为原始大小,128为缩小50%,512为放大100%0
transform_angle旋转图像类对象,单位为0.1度(如450表示45度)0

二、内边距(Padding)
控制对象内容区与边界的间距,或子对象之间的间距。

属性名说明默认值继承性布局影响扩展绘制
pad_top顶部内边距(缩小内容区域顶部空间)0
pad_bottom底部内边距(缩小内容区域底部空间)0
pad_left左侧内边距(缩小内容区域左侧空间)0
pad_right右侧内边距(缩小内容区域右侧空间)0
pad_row行间距(控制子元素垂直间距的布局参数)0
pad_column列间距(控制子元素水平间距的布局参数)0

三、杂项(Miscellaneous)
其他通用样式属性。

属性名说明默认值继承性布局影响扩展绘制
radius设置圆角半径,支持像素值(≥0)或LV_RADIUS_CIRCLE(最大圆角)0
clip_corner是否裁剪圆角处溢出的内容(true/false)0
opa透明度设置:0(完全透明)~256(完全不透明),支持预定义值(如LV_OPA_10)0
color_filter_dsc为对象颜色添加滤镜效果0
color_filter_opa滤镜强度(透明度规则同opa)0
anim_time动画持续时间(毫秒),具体含义因组件而异0
anim_speed动画速度(像素/秒),具体含义因组件而异0
transition状态过渡动画描述(lv_style_transition_dsc_t结构体)0
blend_mode背景混合模式:
LV_BLEND_MODE_NORMAL(正常)
LV_BLEND_MODE_ADDITIVE(叠加)
LV_BLEND_MODE_SUBTRACTIVE(减淡)
0
layout设置对象布局方式,影响子对象排列0
base_dir文本方向:
LV_BIDI_DIR_LTR(左到右)
LV_BIDI_DIR_RTL(右到左)
LV_BIDI_DIR_AUTO(自动)
0

四、背景(Background)
控制对象背景的样式。

属性名说明默认值继承性布局影响扩展绘制
bg_color背景颜色设置0
bg_opa背景透明度设置(遵循标准透明度规则)0
bg_grad_color背景渐变色设置(仅在bg_grad_dir不为LV_GRAD_DIR_NONE时生效)0
bg_grad_dir背景渐变方向设置
可选值:
LV_GRAD_DIR_NONE(无渐变)
HOR(水平渐变)
VER(垂直渐变)
0
bg_main_stop背景色渐变起始点设置
(0表示左上角,255表示右下角,128表示中心)
0
bg_grad_stop渐变色渐变起始点设置
(0表示左上角,255表示右下角,128表示中心)
0
bg_img_src背景图片设置
支持:
lv_img_dsc_t指针
文件路径
LV_SYMBOL_xxx符号
0
bg_img_opa背景图片透明度设置(遵循标准透明度规则)0
bg_img_recolor背景图片重着色颜色设置0
bg_img_recolor_opa背景图片重着色强度设置(遵循标准透明度规则)0
bg_img_tiled背景图片平铺显示设置(布尔值:true/false)0

五、边框(Border)
控制对象边框的样式。

属性名说明默认值继承性布局影响扩展绘制
bg_color背景颜色设置0
bg_opa背景透明度设置(遵循标准透明度规则)0
bg_grad_color背景渐变色设置(仅在bg_grad_dir不为LV_GRAD_DIR_NONE时生效)0
bg_grad_dir背景渐变方向设置
可选值:
LV_GRAD_DIR_NONE(无渐变)
HOR(水平渐变)
VER(垂直渐变)
0
bg_main_stop背景色渐变起始点设置
(0表示左上角,255表示右下角,128表示中心)
0
bg_grad_stop渐变色渐变起始点设置
(0表示左上角,255表示右下角,128表示中心)
0
bg_img_src背景图片设置
支持:
lv_img_dsc_t指针
文件路径
LV_SYMBOL_xxx符号
0
bg_img_opa背景图片透明度设置(遵循标准透明度规则)0
bg_img_recolor背景图片重着色颜色设置0
bg_img_recolor_opa背景图片重着色强度设置(遵循标准透明度规则)0
bg_img_tiled背景图片平铺显示设置(布尔值:true/false)0

六、文本(Text)
控制文本类组件的样式。

属性名说明默认值继承性布局影响扩展绘制
text_color文本颜色0
text_opa文本透明度(遵循与opa相同的透明度规则)0
text_font文本字体(lv_font_t指针)0
text_letter_space字符间距(单位:像素)0
text_line_space行间距(单位:像素)0
text_decor文本装饰。可选:LV_TEXT_DECOR_NONE(无)/UNDERLINE(下划线)/STRIKETHROUGH(删除线),可组合使用0
text_align文本行对齐方式(不影响对象本身对齐)。可选:LV_TEXT_ALIGN_LEFT/CENTER/RIGHT/AUTO(根据文本方向自动对齐)0

七、图像(Image)
控制图像类组件的样式。

属性名说明默认值继承性布局影响扩展绘制
img_opa设置图像透明度(遵循与opa相同的透明度规则)0
img_recolor为图像混合重着色0
img_recolor_opa设置图像重着色强度(遵循与opa相同的透明度规则)0

八、轮廓(Outline)
控制对象轮廓的样式(轮廓指对象外围的线条,与边框有所区别)。

属性名说明默认值继承性布局影响扩展绘制
outline_width轮廓宽度(单位:像素)0
outline_color轮廓颜色0
outline_opa轮廓透明度(遵循opa透明度规则)0
outline_pad轮廓与对象的间距(单位:像素)0

九、阴影(Shadow)
控制对象阴影的样式。

属性名说明默认值继承性布局影响扩展绘制
shadow_width阴影宽度(单位:像素,≥0)0
shadow_ofs_x阴影在X轴方向的偏移量(单位:像素)0
shadow_ofs_y阴影在Y轴方向的偏移量(单位:像素)0
shadow_spread阴影扩散范围(单位:像素,正值扩大,负值缩小)0
shadow_color阴影颜色0
shadow_opa阴影透明度(遵循opa透明度规则)0

十、线条(Line)
控制线条类组件的样式。

属性名说明默认值继承性布局影响扩展绘制
line_width线条宽度(单位:像素)0
line_dash_width虚线宽度(单位:像素,仅支持水平和垂直线)0
line_dash_gap虚线间距(单位:像素,仅支持水平和垂直线)0
line_rounded线条端点圆角效果(布尔值:true/false)0
line_color线条颜色0
line_opa线条透明度(遵循opa透明度规则)0

十一、圆弧(Arc)
控制圆弧类组件的样式(如仪表盘、进度环等)。

属性名说明默认值继承性布局影响扩展绘制
arc_width圆弧宽度(像素单位)0
arc_rounded圆弧端点样式:true=圆角,false=直角0
arc_color圆弧颜色设置0
arc_opa圆弧透明度设置(0=完全透明,256=完全不透明)0
arc_img_src圆弧遮罩图像源(支持 lv_img_dsc_t 指针或文件路径)0
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值