unleashed-firmware/applications/gui/modules/text_input.h

#pragma once
#include <gui/view.h>

#ifdef __cplusplus
extern "C" {
#endif

/* Text input anonymous structure */
typedef struct TextInput TextInput;
typedef void (*TextInputCallback)(void* context);

/** 
 * @brief Allocate and initialize text input
 *        This text input is used to enter string
 * 
 */
TextInput* text_input_alloc();

/** 
 * @brief Deinitialize and free text input
 * 
 * @param text_input - Text input instance
 */
void text_input_free(TextInput* text_input);

/**
 * @brief Get text input view
 * 
 * @param text_input - Text input instance
 * @return View instance that can be used for embedding
 */
View* text_input_get_view(TextInput* text_input);

/**
 * @brief Set text input result callback
 * 
 * @param text_input - Text input instance
 * @param callback - callback fn
 * @param callback_context - callback context
 * @param text_buffer - pointer to YOUR text buffer, that we going to modify
 * @param text_buffer_size - YOUR text buffer size in bytes. Max string length will be text_buffer_size - 1.
 */
void text_input_set_result_callback(
    TextInput* text_input,
    TextInputCallback callback,
    void* callback_context,
    char* text_buffer,
    size_t text_buffer_size);

/** 
 * @brief Set text input header text
 * 
 * @param text input - Text input instance
 * @param text - text to be shown
 */
void text_input_set_header_text(TextInput* text_input, const char* text);

#ifdef __cplusplus
}
#endif