103 lines
2.6 KiB
C++
103 lines
2.6 KiB
C++
/**
|
|
* @file menuControl.h
|
|
* @author Alexander Klein (alex@kleiax.de)
|
|
* @brief Contains a abstract class for Menu
|
|
* @version 0.1
|
|
* @date 2022-01-19
|
|
*
|
|
* @copyright Copyright (c) 2022
|
|
*
|
|
*/
|
|
|
|
#ifndef MENU_CONTROLL_H
|
|
#define MENU_CONTROLL_H
|
|
|
|
#include <Arduino.h>
|
|
#include <iostream>
|
|
#include "displayWrapper.h"
|
|
|
|
/**
|
|
* @brief Baseclass to build Menus
|
|
*
|
|
* This class have to be inherited by other classes which want to be
|
|
* act as a menu, because the menu structure uses polymorphism.
|
|
*
|
|
*/
|
|
class MenuControl {
|
|
public:
|
|
virtual ~MenuControl() {};
|
|
|
|
/** @name UserInputs
|
|
* @brief This functions should be called be user actions.
|
|
*
|
|
* This functions have to be implement in every other menu
|
|
* class.
|
|
*/
|
|
///@{
|
|
virtual void down() {};
|
|
virtual void up() {};
|
|
virtual void right() {};
|
|
virtual void left() {};
|
|
virtual void yes() {};
|
|
virtual void no() {};
|
|
///@}
|
|
|
|
/**
|
|
* @brief can be called to update shown data
|
|
*/
|
|
virtual void update() {
|
|
if (this->updateDelay == 0)
|
|
return;
|
|
|
|
if (millis() - this->lastUpdateMillis < this->updateDelay) {
|
|
return;
|
|
}
|
|
|
|
this->printMenu();
|
|
this->lastUpdateMillis = millis();
|
|
}
|
|
|
|
virtual void printMenu() = 0;
|
|
|
|
/**
|
|
* @brief Set the Parent Menu
|
|
*
|
|
* If the parentMenu is set it will be called automaticaly
|
|
* when the user left the child menu.
|
|
*
|
|
* @param menu
|
|
*/
|
|
void setParentMenu(MenuControl* menu) { this->parentMenu = menu; }
|
|
// MenuControl* getParentMenu() { return this->parentMenu; }
|
|
|
|
/**
|
|
* @brief Set the Lcd object
|
|
*
|
|
* If this is set the menu will be print on the display too.
|
|
*
|
|
* @param lcd
|
|
*/
|
|
void setLcd(DisplayWrapper* lcd) { this->lcd = lcd; }
|
|
|
|
/**
|
|
* @brief Set the time between each new print to the display
|
|
*
|
|
* If the delay is zero, no updates will be made.
|
|
* The delay is by default zero.
|
|
*
|
|
* @param delay time in milliseconds
|
|
*/
|
|
void setUpdateDelay(uint16_t delay = 0) { this->updateDelay = delay; }
|
|
|
|
protected:
|
|
void print(String lineOne, String lineTwo) const;
|
|
DisplayWrapper* getLcd() const { return this->lcd; }
|
|
|
|
MenuControl* parentMenu = nullptr;
|
|
DisplayWrapper* lcd = nullptr;
|
|
|
|
uint16_t updateDelay = 0;
|
|
uint32_t lastUpdateMillis = 0;
|
|
};
|
|
#endif // MENU_CONTROLL_H
|