InfoView.h

Go to the documentation of this file.

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

class InfoView : public ViewBase {
public:
    static constexpr uint16_t MAX_TEXT_LEN = 2048;
    static constexpr uint8_t VISIBLE_LINES = 6;
    static constexpr uint8_t LINE_HEIGHT = 14;

    void init(const char* title, const char* text);

    void setHint(const char* hint) { customHint_ = hint; }

    using YesNoCallback = void(*)(void* userData);
    void setYesNoCallbacks(YesNoCallback onYes, YesNoCallback onNo, void* userData = nullptr) {
        onYes_ = onYes;
        onNo_ = onNo;
        callbackUserData_ = userData;
    }

    using MenuCallback = void(*)(void* userData);
    void setOnMenu(MenuCallback onMenu, void* userData = nullptr) {
        onMenu_ = onMenu;
        menuUserData_ = userData;
    }
 
    // IView implementation
    void render(bool partial) override;
    InputResult onKey(char key) override;
    InputResult onLongPress(char key) override;
    const char* getName() const override { return "InfoView"; }
    const char* getFooterHint() const override;
 
private:
    static constexpr uint16_t MAX_TITLE_LEN = 64;
 
    char titleBuf_[MAX_TITLE_LEN];
    // Body text lives in PSRAM (allocated lazily on first init); the buffer is
    // large and only touched from the main/UI task, so it must not sit in the
    // scarce internal heap.
    cdc::core::PsramUniquePtr<char> textBuf_;
    const char* customHint_ = nullptr;
    uint16_t scrollLine_ = 0;
    uint16_t totalLines_ = 0;
    YesNoCallback onYes_ = nullptr;
    YesNoCallback onNo_ = nullptr;
    void* callbackUserData_ = nullptr;
    MenuCallback onMenu_ = nullptr;
    void* menuUserData_ = nullptr;
 
    void scroll(bool down);
    uint16_t countLines() const;
};
 
// ============================================================================
// Convenience Functions
// ============================================================================

InfoView* showInfo(const char* title, const char* text, const char* hint = nullptr);
 
} // namespace cdc::ui