Spinbox （微调框）(lv_spinbox)

Overview（概述）

显示原文

The Spinbox contains a number as text which can be increased or decreased by Keys or API functions. Under the hood the Spinbox is a modified Text area.

Spinbox（微调框）包含了一串数字文本，可以通过 Keys 或 API 函数来 “增加” 或 “减少” 数字大小。本质上微调框只是覆盖在文本框控件上面。

Parts and Styles（部分和样式）

显示原文

The parts of the Spinbox are identical to the Text area.

微调框的各个部分与文本框控件相同。

Value, range and step（值、范围和步长）

显示原文

lv_spinbox_set_value(spinbox, 1234) sets a new value on the Spinbox.
lv_spinbox_increment(spinbox) and

increments/decrements the value of the Spinbox according to the currently selected digit. - lv_spinbox_set_range(spinbox, -1000, 2500) sets a range. If the value is changed by lv_spinbox_set_value(), by Keys,lv_spinbox_increment/decrement this range will be respected. - lv_spinbox_set_step(spinbox, 100) sets which digits to change on increment/decrement. Only multiples of ten can be set, and not for example 3. - lv_spinbox_set_cursor_pos(spinbox, 1) sets the cursor to a specific digit to change on increment/decrement. For example position '0' sets the cursor to the least significant digit.

If an encoder is used as input device, the selected digit is shifted to the right by default whenever the encoder button is clicked. To change this behaviour to shifting to the left, the lv_spinbox_set_digit_step_direction(spinbox, LV_DIR_LEFT) can be used

lv_spinbox_set_value(spinbox, 1234) 在微调框上设置一个新值。
lv_spinbox_increment(spinbox) 和 lv_spinbox_decrement(spinbox) 根据当前选择的数字递增/递减微调框的值。
lv_spinbox_set_range(spinbox, -1000, 2500) 设置范围。如果值由 lv_spinbox_set_value()， Keys,lv_spinbox_increment/decrement 键更改，则将遵循此范围。
lv_spinbox_set_step(spinbox, 100) 设置要更改的数字递增/递减。只能设置 10 的倍数，不能像这样设置，比如设置为 3。
lv_spinbox_set_cursor_pos(spinbox, 1) 将光标设置为特定的数字在 increment/decrement 递增/递减时更改。例如，位置“0”将光标设置为最低有效数字。

如果将编码器用作输入设备，则所选数字将移至默认情况下，每当单击编码器按钮时，该键都是右键。将此行为更改为转移在左侧，可以使用函数 lv_spinbox_set_digit_step_direction(spinbox, LV_DIR_LEFT) 设置

Format（格式）

显示原文

lv_spinbox_set_digit_format(spinbox, digit_count, separator_position) sets the number format. digit_count is the number of digits excluding the decimal separator and the sign. is the number of digits before the decimal point. If 0, no decimal point is displayed.

lv_spinbox_set_digit_format(spinbox, digit_count, separator_position) 设置数字格式。 digit_count 是不包括小数分隔符和符号的位数，也就是小数点之前的位数。如果为0，则不显示小数点。

Rollover（翻转）

显示原文

lv_spinbox_set_rollover(spinbox, true / false) enables/disabled rollover mode. If either the minimum or maximum value is reached with rollover enabled, the value will change to the other limit. If rollover is disabled the value will remain at the minimum or maximum value.

lv_spinbox_set_rollover(spinbox, true / false) 启用/禁用翻转模式。如果在启用翻转的情况下达到最小值或最大值，则该值将更改为其他限制。如果禁用了翻转，则该值将保持在最小值或最大值。

Events（事件）

显示原文

LV_EVENT_VALUE_CHANGED Sent when the value has changed.

See the events of the Text area too.

Learn more about Events（事件）.

LV_EVENT_VALUE_CHANGED 在值更改时发送。

另请参阅文本区域的事件。

详细了解更多 Events（事件）。

Keys（按键）

显示原文

LV_KEY_LEFT/RIGHT With Keypad move the cursor left/right. With Encoder decrement/increment the selected digit.
LV_KEY_UP/DOWN With Keypad and Encoder increment/decrement the value.
LV_KEY_ENTER With Encoder got the net digit. Jump to the first after the last.

LV_KEY_LEFT/RIGHT 使用键盘向左/向右移动光标。使用编码器递减/递增所选数字。
LV_KEY_UP/DOWN 带键盘和 编码器 递增/递减值。
LV_KEY_ENTER 用 编码器 得到净数字。跳转到第一个之后在最后一个。

Example

[English]

Simple Spinbox

#include "../../lv_examples.h"
#if LV_USE_SPINBOX && LV_BUILD_EXAMPLES

static lv_obj_t * spinbox;

static void lv_spinbox_increment_event_cb(lv_event_t * e)
{
    lv_event_code_t code = lv_event_get_code(e);
    if(code == LV_EVENT_SHORT_CLICKED || code  == LV_EVENT_LONG_PRESSED_REPEAT) {
        lv_spinbox_increment(spinbox);
    }
}

static void lv_spinbox_decrement_event_cb(lv_event_t * e)
{
    lv_event_code_t code = lv_event_get_code(e);
    if(code == LV_EVENT_SHORT_CLICKED || code == LV_EVENT_LONG_PRESSED_REPEAT) {
        lv_spinbox_decrement(spinbox);
    }
}

void lv_example_spinbox_1(void)
{
    spinbox = lv_spinbox_create(lv_screen_active());
    lv_spinbox_set_range(spinbox, -1000, 25000);
    lv_spinbox_set_digit_format(spinbox, 5, 2);
    lv_spinbox_step_prev(spinbox);
    lv_obj_set_width(spinbox, 100);
    lv_obj_center(spinbox);

    int32_t h = lv_obj_get_height(spinbox);

    lv_obj_t * btn = lv_button_create(lv_screen_active());
    lv_obj_set_size(btn, h, h);
    lv_obj_align_to(btn, spinbox, LV_ALIGN_OUT_RIGHT_MID, 5, 0);
    lv_obj_set_style_bg_image_src(btn, LV_SYMBOL_PLUS, 0);
    lv_obj_add_event_cb(btn, lv_spinbox_increment_event_cb, LV_EVENT_ALL,  NULL);

    btn = lv_button_create(lv_screen_active());
    lv_obj_set_size(btn, h, h);
    lv_obj_align_to(btn, spinbox, LV_ALIGN_OUT_LEFT_MID, -5, 0);
    lv_obj_set_style_bg_image_src(btn, LV_SYMBOL_MINUS, 0);
    lv_obj_add_event_cb(btn, lv_spinbox_decrement_event_cb, LV_EVENT_ALL, NULL);
}

#endif

API

lv_types.h

lv_spinbox.h