unleashed-firmware/applications/gui/modules/text_input.h
あく 4cf000f270
[FL-1465] Archive application bug fixes. Gui: update TextInput API. (#530)
* Update MLib to latest master.
* Archive: update string_t usage, add unsafe usage TODO, change model type to blocking and fix invalid usage.
* Gui: update text_input API and it's usage.
* fix blocking model issues
* fix  unsafe string_t usage

Co-authored-by: Igor Baranov <bedtimeposts@gmail.com>
Co-authored-by: its your bedtime <23366927+itsyourbedtime@users.noreply.github.com>
2021-06-24 00:46:52 +03:00

60 lines
No EOL
1.4 KiB
C

#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