MenuItem

Defines

ITEM_DRAW_BUFFER_SIZE

ITEM_BASIC(...)

class MenuItem

#include <MenuItem.h>

Represent single item in menu.

┌────────────────────────────┐
│ > T E X T                  │
└────────────────────────────┘

Subclassed by BaseItemManyWidgets, BaseItemZeroWidget, ItemInput, ItemLabel, ItemToggle

Public Functions

inline MenuItem(const char *text)

inline const char *getText()

Get the text of the item.

Returns:

String - Item’s text

inline void setText(const char *text)

Set the text of the item.

Note

You need to call LcdMenu::refresh after this method to see the changes.

Parameters:

text – text to display for the item

inline virtual bool isSelectable() const

Check if the item can be selected by the cursor.

virtual ~MenuItem() noexcept = default

Protected Functions

inline uint8_t getViewSize(MenuRenderer *renderer) const

The number of available columns for the potential value of the item.

         visible area
       ┌───────────────┐
X X X X│X X X X █ X X X│X X
       ├───────────────┤
       │<── viewSize ─>│

Effectively const, but initialized lately when renderer is injected.

inline virtual bool process(LcdMenu *menu, const unsigned char command)

Process a command decoded in 1 byte. It can be a printable character or a control command like ENTER or LEFT. Return value is used to determine operation was successful or ignored. If the parent of item received that handle was ignored it can execute it’s own action on this command. Thus, the item always has priority in processing; if it is ignored, it is delegated to the parent element. Behaviour is very similar to Even Bubbling in JavaScript.

Parameters:

• menu – the owner menu of the item, can be used to retrieve required object, such as DisplayInterface or MenuScreen

• command – the character command, can be a printable character or a control command

Returns:

true if command was successfully handled by item.

inline virtual void draw(MenuRenderer *renderer)

Draw this menu item on specified display on current row.

Parameters:

renderer – The renderer to use for drawing.

Protected Attributes

const char *text = NULL

bool polling = false

Private Members

friend MenuScreen