106 lines
2.9 KiB
C
106 lines
2.9 KiB
C
|
#pragma once
|
||
|
|
|
||
|
|
#include <gui/view.h>
|
||
|
|
|
||
|
|
/* Dialog anonymous structure */
|
||
|
|
typedef struct DialogEx DialogEx;
|
||
|
|
|
||
|
|
/* DialogEx result */
|
||
|
|
typedef enum {
|
||
|
|
DialogExResultLeft,
|
||
|
|
DialogExResultCenter,
|
||
|
|
DialogExResultRight,
|
||
|
|
} DialogExResult;
|
||
|
|
|
||
|
|
/* DialogEx result callback type
|
||
|
|
* @warning comes from GUI thread
|
||
|
|
*/
|
||
|
|
typedef void (*DialogExResultCallback)(DialogExResult result, void* context);
|
||
|
|
|
||
|
|
/* Allocate and initialize dialog
|
||
|
|
* This dialog used to ask simple questions like Yes/
|
||
|
|
*/
|
||
|
|
DialogEx* dialog_ex_alloc();
|
||
|
|
|
||
|
|
/* Deinitialize and free dialog
|
||
|
|
* @param dialog - DialogEx instance
|
||
|
|
*/
|
||
|
|
void dialog_ex_free(DialogEx* dialog_ex);
|
||
|
|
|
||
|
|
/* Get dialog view
|
||
|
|
* @param dialog - DialogEx instance
|
||
|
|
* @return View instance that can be used for embedding
|
||
|
|
*/
|
||
|
|
View* dialog_ex_get_view(DialogEx* dialog_ex);
|
||
|
|
|
||
|
|
/* Set dialog result callback
|
||
|
|
* @param dialog_ex - DialogEx instance
|
||
|
|
* @param callback - result callback function
|
||
|
|
*/
|
||
|
|
void dialog_ex_set_result_callback(DialogEx* dialog_ex, DialogExResultCallback callback);
|
||
|
|
|
||
|
|
/* Set dialog context
|
||
|
|
* @param dialog_ex - DialogEx instance
|
||
|
|
* @param context - context pointer, will be passed to result callback
|
||
|
|
*/
|
||
|
|
void dialog_ex_set_context(DialogEx* dialog_ex, void* context);
|
||
|
|
|
||
|
|
/* Set dialog header text
|
||
|
|
* If text is null, dialog header will not be rendered
|
||
|
|
* @param dialog - DialogEx instance
|
||
|
|
* @param text - text to be shown, can be multiline
|
||
|
|
* @param x, y - text position
|
||
|
|
* @param horizontal, vertical - text aligment
|
||
|
|
*/
|
||
|
|
void dialog_ex_set_header(
|
||
|
|
DialogEx* dialog_ex,
|
||
|
|
const char* text,
|
||
|
|
uint8_t x,
|
||
|
|
uint8_t y,
|
||
|
|
Align horizontal,
|
||
|
|
Align vertical);
|
||
|
|
|
||
|
|
/* Set dialog text
|
||
|
|
* If text is null, dialog text will not be rendered
|
||
|
|
* @param dialog - DialogEx instance
|
||
|
|
* @param text - text to be shown, can be multiline
|
||
|
|
* @param x, y - text position
|
||
|
|
* @param horizontal, vertical - text aligment
|
||
|
|
*/
|
||
|
|
void dialog_ex_set_text(
|
||
|
|
DialogEx* dialog_ex,
|
||
|
|
const char* text,
|
||
|
|
uint8_t x,
|
||
|
|
uint8_t y,
|
||
|
|
Align horizontal,
|
||
|
|
Align vertical);
|
||
|
|
|
||
|
|
/* Set dialog icon
|
||
|
|
* If x or y is negative, dialog icon will not be rendered
|
||
|
|
* @param dialog - DialogEx instance
|
||
|
|
* @param x, y - icon position
|
||
|
|
* @param name - icon to be shown
|
||
|
|
*/
|
||
|
|
void dialog_ex_set_icon(DialogEx* dialog_ex, int8_t x, int8_t y, IconName name);
|
||
|
|
|
||
|
|
/* Set left button text
|
||
|
|
* If text is null, left button will not be rendered and processed
|
||
|
|
* @param dialog - DialogEx instance
|
||
|
|
* @param text - text to be shown
|
||
|
|
*/
|
||
|
|
void dialog_ex_set_left_button_text(DialogEx* dialog_ex, const char* text);
|
||
|
|
|
||
|
|
/* Set center button text
|
||
|
|
* If text is null, center button will not be rendered and processed
|
||
|
|
* @param dialog - DialogEx instance
|
||
|
|
* @param text - text to be shown
|
||
|
|
*/
|
||
|
|
void dialog_ex_set_center_button_text(DialogEx* dialog_ex, const char* text);
|
||
|
|
|
||
|
|
/* Set right button text
|
||
|
|
* If text is null, right button will not be rendered and processed
|
||
|
|
* @param dialog - DialogEx instance
|
||
|
|
* @param text - text to be shown
|
||
|
|
*/
|
||
|
|
void dialog_ex_set_right_button_text(DialogEx* dialog_ex, const char* text);
|