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) 设置刻度上的最小值和最大值。

Tick drawing order（刻度绘制顺序）

显示原文

You can set the drawing of the ticks on top of the main line with lv_scale_set_draw_ticks_on_top(scale, true). The default drawing order is below the main line.

This is a scale with the ticks being drawn below of the main line (default):

This is an scale with the ticks being drawn at the top of the main line:

可以通过调用 lv_scale_set_draw_ticks_on_top(scale, true) 将刻度的绘制设置在主线之上。默认的绘制顺序是在主线之下。

这是一个将刻度绘制在主线之下的标尺（默认情况）：

这是一个将刻度绘制在主线之上的标尺：

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};.

<strong> NOTE: </strong> The major tick value is calculated with the lv_map API (when not setting the custom labels), this calculation takes into consideration the total tick number and the scale range, so the label drawn can present rounding errors when the calculated value is a float number.

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(scale, show_label) 进行配置、如果需要展示标签，则将 show_label 设置为 true，如果不想展示标签，则将设置为 false 。如果想修改主刻度标签的值，可以通过接口 lv_scale_set_text_src(scale, custom_labels) 设置，参数 custom_labels 必须是静态数组，并且使用 NULL 作为最后一个元素，例如： static char * custom_labels[3] = {"One", "Two", NULL}; 。

<strong>注意：</strong>主要刻度值是通过使用 lv_map (当未设置自定义标签时) 计算得出的，此计算会考虑总刻度数量和刻度范围，因此当计算值为浮点数时，绘制的标签可能会出现四舍五入的错误。

主刻度的长度可通过修改 LV_PART_INDICATOR 的 length 样式属性配置；次刻度的长度通过修改 LV_PART_ITEMS 的 length 样式属性配置。例如使用本地样式，修改主刻度线的长度： 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_... 接口进行操作。

可通过接口 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 是样式变量，必须是全局变量或静态变量。