gb.gui.keyboard

Description

// strings:
void gb.gui.keyboard( const char* title , char* text [, uint8_t length] )
// Multilang:
void gb.gui.keyboard( const MultiLang* title , char* text [, uint8_t length] [, uint8_t numLang] )

gb.gui.keyboard displays a keyboard in which you can enter a message. You can also provide a default text.

Parameters

  • const char* | const MultiLang* title: title which to display
  • char* text: this acts both as the default text and as the output buffer
  • uint8_t length (optional): the length in characters of the buffer, meaning if this is e.g. 12 your text buffer should be char[13] due to the added '\0'. If not provided, it is attempted to be autodetermined
  • uint8_t numLang (optional): number language entries for MultiLang title. If not provided, it is attempted to autodetermine it

Returns

none

Example

#include <Gamebuino-Meta.h>

void setup() {
gb.begin();

// ask the player for their favorite animal
char text[12] = "Foxies";
gb.gui.keyboard("Favorite Animal?", text);

gb.display.clear();
gb.display.println("You entered:");
gb.display.print(text);
}

void loop() {
while(!gb.update());
}