ContextMenuView.h

Go to the documentation of this file.

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

struct ContextMenuItem {
    const char* label;
    void (*callback)();
};

class ContextMenuView : public ViewBase {
public:
    static constexpr uint8_t MAX_ITEMS = 8;
    static constexpr uint8_t VISIBLE_ITEMS = 4;

    void init(const char* title, const ContextMenuItem* items, uint8_t count);

    uint8_t getSelection() const { return selection_; }
 
    // IView implementation
    void render(bool partial) override;
    InputResult onKey(char key) override;
    void onTick(uint32_t nowMs) override;
    const char* getName() const override { return "ContextMenuView"; }
    const char* getFooterHint() const override { return nullptr; }
 
private:
    const char* title_ = nullptr;
    // Items are copied so callers can safely use stack arrays; the i18n
    // strings the labels point to are stable for the program lifetime.
    ContextMenuItem items_[MAX_ITEMS] = {};
    uint8_t itemCount_ = 0;
    uint8_t selection_ = 0;
    uint8_t scrollPos_ = 0;
    // Uptime (ms) of the last interaction; 0 until the first tick after show.
    // Used for the auto-dismiss inactivity timeout.
    uint32_t lastActivityMs_ = 0;
 
    void navigate(bool down);
    void select();
};
 
// ============================================================================
// Convenience Functions
// ============================================================================

ContextMenuView* showContextMenu(const char* title, const ContextMenuItem* items, uint8_t count);

void hideContextMenu();
 
} // namespace cdc::ui