SliderView.h

Go to the documentation of this file.

#pragma once
 
#include "cdc_ui/IView.h"
#include <cstdint>
 
namespace cdc::ui {

class SliderView : public ViewBase {
public:
    using SaveCallback = void(*)(uint16_t value);

    using ChangeCallback = void(*)(uint16_t value);

    using StepCallback = uint16_t(*)(uint16_t currentValue, bool increasing);

    using CancelCallback = void(*)();

    void init(const char* title, uint16_t minVal, uint16_t maxVal,
              uint16_t initial, uint16_t step, const char* unit = nullptr);

    void setOnSave(SaveCallback callback) { onSave_ = callback; }

    void setOnChange(ChangeCallback callback) { onChange_ = callback; }

    void setStepCallback(StepCallback callback) { stepCallback_ = callback; }

    void setOnCancel(CancelCallback callback) { onCancel_ = callback; }

    uint16_t getValue() const { return value_; }

    void setValue(uint16_t value);

    void setDisplayOffset(int16_t offset) { displayOffset_ = offset; }

    void setZeroLabel(const char* label) { zeroLabel_ = label; }
 
    // IView implementation
    void render(bool partial) override;
    InputResult onKey(char key) override;
    void onTick(uint32_t nowMs) override;
    const char* getName() const override { return "SliderView"; }
    const char* getFooterHint() const override;
 
private:
    const char* title_ = nullptr;
    const char* unit_ = nullptr;
    const char* zeroLabel_ = nullptr;
    uint16_t value_ = 0;
    uint16_t minValue_ = 0;
    uint16_t maxValue_ = 100;
    uint16_t step_ = 1;
    int16_t displayOffset_ = 0;
    SaveCallback onSave_ = nullptr;
    CancelCallback onCancel_ = nullptr;
    ChangeCallback onChange_ = nullptr;
    StepCallback stepCallback_ = nullptr;
    uint32_t repeatStartMs_ = 0;
    uint32_t lastRepeatMs_ = 0;
 
    void adjust(bool increase);
};
 
// ============================================================================
// Convenience Functions
// ============================================================================

SliderView* showSlider(const char* title, uint16_t minVal, uint16_t maxVal,
                       uint16_t initial, uint16_t step, const char* unit,
                       SliderView::SaveCallback onSave,
                       SliderView::ChangeCallback onChange = nullptr);
 
} // namespace cdc::ui