560ea5f995
* nfc: add scroll element for info * widget: format lines for scroll text element * widget: fix new line generation * widget: finish element text scroll * nfc: rework ultralight and NTAG info scenes * nfc: rework mf classic info screens * nfc: rework nfca info scenes * nfc: fix mf ultralight navigation * widget: add documentation * nfc: rework bank card infO * nfc: rework device info scene * nfc: fix incorrect atqa order * mf ultralight: remove unused function * widget: add mutex for model protection * widget: fix memory leak * nfc: rework delete scene * nfc: fix selected item in saved menu scene * widget: fix naming in text scroll element * nfc: fix navigation from delete success * nfc: add dictionary icon * widget: fix memory leak
173 lines
4.6 KiB
C
Executable File
173 lines
4.6 KiB
C
Executable File
/**
|
|
* @file widget.h
|
|
* GUI: Widget view module API
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "widget_elements/widget_element_i.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct Widget Widget;
|
|
typedef struct WidgetElement WidgetElement;
|
|
|
|
/** Allocate Widget that holds Widget Elements
|
|
*
|
|
* @return Widget instance
|
|
*/
|
|
Widget* widget_alloc();
|
|
|
|
/** Free Widget
|
|
* @note this function free allocated Widget Elements
|
|
*
|
|
* @param widget Widget instance
|
|
*/
|
|
void widget_free(Widget* widget);
|
|
|
|
/** Reset Widget
|
|
*
|
|
* @param widget Widget instance
|
|
*/
|
|
void widget_reset(Widget* widget);
|
|
|
|
/** Get Widget view
|
|
*
|
|
* @param widget Widget instance
|
|
*
|
|
* @return View instance
|
|
*/
|
|
View* widget_get_view(Widget* widget);
|
|
|
|
/** Add Multi String Element
|
|
*
|
|
* @param widget Widget instance
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param horizontal Align instance
|
|
* @param vertical Align instance
|
|
* @param font Font instance
|
|
* @param[in] text The text
|
|
*/
|
|
void widget_add_string_multiline_element(
|
|
Widget* widget,
|
|
uint8_t x,
|
|
uint8_t y,
|
|
Align horizontal,
|
|
Align vertical,
|
|
Font font,
|
|
const char* text);
|
|
|
|
/** Add String Element
|
|
*
|
|
* @param widget Widget instance
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param horizontal Align instance
|
|
* @param vertical Align instance
|
|
* @param font Font instance
|
|
* @param[in] text The text
|
|
*/
|
|
void widget_add_string_element(
|
|
Widget* widget,
|
|
uint8_t x,
|
|
uint8_t y,
|
|
Align horizontal,
|
|
Align vertical,
|
|
Font font,
|
|
const char* text);
|
|
|
|
/** Add Text Box Element
|
|
*
|
|
* @param widget Widget instance
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param width width to fit text
|
|
* @param height height to fit text
|
|
* @param horizontal Align instance
|
|
* @param vertical Align instance
|
|
* @param[in] text Formatted text. The following formats are available:
|
|
* "\e#Bold text\e#" - bold font is used
|
|
* "\e*Monospaced text\e*" - monospaced font is used
|
|
* "\e#Inversed text\e#" - white text on black background
|
|
* @param strip_to_dots Strip text to ... if does not fit to width
|
|
*/
|
|
void widget_add_text_box_element(
|
|
Widget* widget,
|
|
uint8_t x,
|
|
uint8_t y,
|
|
uint8_t width,
|
|
uint8_t height,
|
|
Align horizontal,
|
|
Align vertical,
|
|
const char* text,
|
|
bool strip_to_dots);
|
|
|
|
/** Add Text Scroll Element
|
|
*
|
|
* @param widget Widget instance
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param width width to fit text
|
|
* @param height height to fit text
|
|
* @param[in] text Formatted text. Default format: align left, Secondary font.
|
|
* The following formats are available:
|
|
* "\e#Bold text" - sets bold font before until next '\n' symbol
|
|
* "\ecBold text" - sets center horizontal align before until next '\n' symbol
|
|
* "\erBold text" - sets right horizontal align before until next '\n' symbol
|
|
*/
|
|
void widget_add_text_scroll_element(
|
|
Widget* widget,
|
|
uint8_t x,
|
|
uint8_t y,
|
|
uint8_t width,
|
|
uint8_t height,
|
|
const char* text);
|
|
|
|
/** Add Button Element
|
|
*
|
|
* @param widget Widget instance
|
|
* @param button_type GuiButtonType instance
|
|
* @param text text on allocated button
|
|
* @param callback ButtonCallback instance
|
|
* @param context pointer to context
|
|
*/
|
|
void widget_add_button_element(
|
|
Widget* widget,
|
|
GuiButtonType button_type,
|
|
const char* text,
|
|
ButtonCallback callback,
|
|
void* context);
|
|
|
|
/** Add Icon Element
|
|
*
|
|
* @param widget Widget instance
|
|
* @param x top left x coordinate
|
|
* @param y top left y coordinate
|
|
* @param icon Icon instance
|
|
*/
|
|
void widget_add_icon_element(Widget* widget, uint8_t x, uint8_t y, const Icon* icon);
|
|
|
|
/** Add Frame Element
|
|
*
|
|
* @param widget Widget instance
|
|
* @param x top left x coordinate
|
|
* @param y top left y coordinate
|
|
* @param width frame width
|
|
* @param height frame height
|
|
* @param radius frame radius
|
|
*/
|
|
void widget_add_frame_element(
|
|
Widget* widget,
|
|
uint8_t x,
|
|
uint8_t y,
|
|
uint8_t width,
|
|
uint8_t height,
|
|
uint8_t radius);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|