Input from Character Set

This example will show you how to input using a charset.

Process

Imports

// other includes ...
#include <ItemInput.h>
#include <LcdMenu.h> // Always comes after every item type import

Define your charset (list of accepted/valid chars)

You also need to track the active index of the list

// ../../examples/CharsetInput/CharsetInput.ino#L36-L40

#define CHARSET_SIZE 10
// Create your charset
char charset[] = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9'};
// Active index of the charset
uint8_t charsetPosition;

Move to an ItemInput menu item

Use up() and/or down() to navigate to an ItemInput.

Enter edit mode

Execute enter() to go to edit mode. (the cursor will start blinking 😉)

Use up() and down() to cycle through your charset

drawChar(char c) is used to display the character without storing the value, the value will be stored only when type(char character) is executed.

// ...
case UP:
    if (.isInEditMode())  // Update the position only in edit mode
        charsetPosition = (charsetPosition + 1) % CHARSET_SIZE;
    menu.drawChar(charset[charsetPosition]);  // Works only in edit mode
    menu.up();
    break;
case DOWN:
    if (menu.isInEditMode())  // Update the position only in edit mode
        charsetPosition =
            constrain(charsetPosition - 1, 0, CHARSET_SIZE);
    menu.drawChar(charset[charsetPosition]);  // Works only in edit mode
    menu.down();
    break;
// ...

Type the selected character

Use menu.type(char character) to type the selected character

case ENTER:  // Press enter to go to edit mode: for ItemInput
    menu.type(charset[charsetPosition]);  // Works only in edit mode
    menu.enter();

menu.back() will exit edit mode

The value of the menu item will be passed through to the callback function attached to this item.

Full example 👉 .../examples/CharsetInput/CharsetInput.ino