Scale (标尺)(lv_scale)
Overview(概述)
显示原文
Scale allows you to have a linear scale with ranges and sections with custom styling.
标尺允许您拥有具有自定义样式的范围和部分的线性标尺。
Parts and Styles(零件和样式)
显示原文
The scale widget is divided in the following three parts:
LV_PART_MAIN
Main line. See blue line in the example image.LV_PART_ITEMS
Minor ticks. See red minor ticks in the example image.LV_PART_INDICATOR
Major ticks and its labels (if enabled). See pink labels and green major ticks in the example image.
标尺控件分为以下三个部分:
LV_PART_MAIN
主线。请参阅示例图像中的蓝线。LV_PART_ITEMS
轻微的蜱虫。请参阅示例图像中的红色小刻度。LV_PART_INDICATOR
主要刻度及其标签(如果启用)。 在示例图像中查看粉红色标签和绿色主要刻度。

Usage(用法)
Set ranges(设置范围)
显示原文
The minor and major range (values of each tick) are configured with lv_scale_set_range(scale, minor_range, major_range).
次要范围和主要范围(每个刻度的值)配置为 lv_scale_set_range(scale, minor_range, major_range)。
Configure ticks(配置刻度线)
显示原文
Set the number of total ticks with lv_scale_set_total_tick_count(scale, total_tick_count) and then configure the major tick being every Nth ticks with lv_scale_set_major_tick_every(scale, nth_tick).
Labels on major ticks can be configured with lv_scale_set_label_show(scale, show_label),
set show_label to true if labels should be drawn, false to hide them.
If instead of a numerical value in the major ticks a text is required they can be set
with lv_scale_set_text_src(scale, custom_labels) using NULL
as the last element,
i.e. static char * custom_labels[3] = {"One", "Two", NULL};.
The length of the ticks can be configured with the length style property on the LV_PART_INDICATOR
for major ticks and LV_PART_ITEMS
for minor ticks, for example with local style:
lv_obj_set_style_length(scale, 5, LV_PART_INDICATOR); for major ticks
and lv_obj_set_style_length(scale, 5, LV_PART_ITEMS); for minor ticks.
使用 lv_scale_set_total_tick_count(scale, total_tick_count) 设置总刻度数。然后使用 lv_scale_set_major_tick_every(scale, nth_tick),将主要刻度线配置为每 N 个刻度线。
主要刻度上的标签可以配置lv_scale_set_label_show(刻度、show_label)、 如果应绘制标签,则将 show_label 设置为 true,如果应绘制标签,则将 设置为 true,将标签设置为隐藏标签。 如果需要在主要刻度中不需要数值,则可以设置文本 以 lv_scale_set_text_src(scale, custom_labels) 作为最后一个元素, 即静态字符 * custom_labels[3] = {“One”, “Two”, NULL};。
可以使用 lv_scale_set_label_show(scale, show_label) 配置主要刻度线的标签、 如果要绘制标签,则设置 show_label 为 true,如果要隐藏标签,则设置 false。如果需要在主要刻度线中使用文本而不是数值,可以使用 false 设置。使用 lv_scale_set_text_src(scale, custom_labels),将 NULL
作为最后一个元素、 即 static char * custom_labels[3] = {"One", "Two", NULL};。
刻度线的长度可通过 LV_PART_INDICATOR
上的 length 样式属性配置。和 LV_PART_ITEMS
上的长度样式属性配置主要刻度线和次要刻度线,例如使用本地样式: lv_obj_set_style_length(scale, 5, LV_PART_INDICATOR); 用于大刻度线 和 lv_obj_set_style_length(scale, 5, LV_PART_ITEMS); 用于小刻度线。
Sections(部分)
显示原文
A section is the space between a minor and a major range. They can be created with lv_scale_add_section(scale)
and it handles back an lv_scale_section_t
pointer.
The range of the section is configured with lv_scale_section_set_range(section, minor_range, major_range).
The style of each of the three parts of the scale section can be set with
lv_scale_section_set_style(section, PART, style_pointer), where PART can be
LV_PART_MAIN
, LV_PART_ITEMS
or LV_PART_INDICATOR
,
style_pointer should point to a global or static lv_style_t
variable.
For labels the following properties can be configured:
lv_style_set_text_font()
, lv_style_set_text_color()
,
lv_style_set_text_letter_space()
, lv_style_set_text_opa()
.
For lines (main line, major and minor ticks) the following properties can be configured:
lv_style_set_line_color()
, lv_style_set_line_width()
.
部分是小调和大调范围之间的空间。它们可以使用 lv_scale_add_section(scale) 创建,它会处理一个 lv_scale_section_t
指针。
该部分的范围配置为 lv_scale_section_set_range(section, minor_range, major_range) 。 标尺截面的三个部分中每个部分的样式都可以用 lv_scale_section_set_style(section, PART, style_pointer)`设置,其中 `PART 可以是 , 也可以是 LV_PART_MAIN
, LV_PART_ITEMS
或 LV_PART_INDICATOR
, style_pointer , lv_style_t
应该指向全局变量或静态变量。
对于标签,可以配置以下属性:lv_style_set_text_font()
, lv_style_set_text_color()
, lv_style_set_text_letter_space()
, lv_style_set_text_opa()
。
对于线(主线、主要和次要报价),可以配置以下属性:lv_style_set_line_color()
, lv_style_set_line_width()
。
Events(事件)
显示原文
No events supported by this widget.
此控件不支持任何事件。
Keys
显示原文
No keys supported by this widget.
此控件不支持任何按键。
Example
C code
View on GitHubC code
View on GitHubC code
View on GitHubC code
View on GitHubC code
View on GitHubAPI
lv_scale.h .. Autogenerated