mirror of
https://github.com/DarkFlippers/unleashed-firmware.git
synced 2024-12-29 00:09:19 +03:00
122 lines
3.1 KiB
C
122 lines
3.1 KiB
C
/**
|
|
* @file submenu.h
|
|
* GUI: SubMenu view module API
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <gui/view.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/** Submenu anonymous structure */
|
|
typedef struct Submenu Submenu;
|
|
typedef void (*SubmenuItemCallback)(void* context, uint32_t index);
|
|
|
|
/** Allocate and initialize submenu
|
|
*
|
|
* This submenu is used to select one option
|
|
*
|
|
* @return Submenu instance
|
|
*/
|
|
Submenu* submenu_alloc(void);
|
|
|
|
/** Deinitialize and free submenu
|
|
*
|
|
* @param submenu Submenu instance
|
|
*/
|
|
void submenu_free(Submenu* submenu);
|
|
|
|
/** Get submenu view
|
|
*
|
|
* @param submenu Submenu instance
|
|
*
|
|
* @return View instance that can be used for embedding
|
|
*/
|
|
View* submenu_get_view(Submenu* submenu);
|
|
|
|
/** Add item to submenu
|
|
*
|
|
* @param submenu Submenu instance
|
|
* @param label menu item label
|
|
* @param index menu item index, used for callback, may be
|
|
* the same with other items
|
|
* @param callback menu item callback
|
|
* @param callback_context menu item callback context
|
|
*/
|
|
void submenu_add_item(
|
|
Submenu* submenu,
|
|
const char* label,
|
|
uint32_t index,
|
|
SubmenuItemCallback callback,
|
|
void* callback_context);
|
|
|
|
/** Add lockable item to submenu
|
|
*
|
|
* @param submenu Submenu instance
|
|
* @param label menu item label
|
|
* @param index menu item index, used for callback, may be
|
|
* the same with other items
|
|
* @param callback menu item callback
|
|
* @param callback_context menu item callback context
|
|
* @param locked menu item locked status
|
|
* @param locked_message menu item locked message
|
|
*/
|
|
void submenu_add_lockable_item(
|
|
Submenu* submenu,
|
|
const char* label,
|
|
uint32_t index,
|
|
SubmenuItemCallback callback,
|
|
void* callback_context,
|
|
bool locked,
|
|
const char* locked_message);
|
|
|
|
/** Change label of an existing item
|
|
*
|
|
* @param submenu Submenu instance
|
|
* @param index The index of the item
|
|
* @param label The new label
|
|
*/
|
|
void submenu_change_item_label(Submenu* submenu, uint32_t index, const char* label);
|
|
|
|
/** Remove all items from submenu
|
|
*
|
|
* @param submenu Submenu instance
|
|
*/
|
|
void submenu_reset(Submenu* submenu);
|
|
|
|
/** Get submenu selected item index
|
|
*
|
|
* @param submenu Submenu instance
|
|
*
|
|
* @return Index of the selected item
|
|
*/
|
|
uint32_t submenu_get_selected_item(Submenu* submenu);
|
|
|
|
/** Set submenu selected item by index
|
|
*
|
|
* @param submenu Submenu instance
|
|
* @param index The index of the selected item
|
|
*/
|
|
void submenu_set_selected_item(Submenu* submenu, uint32_t index);
|
|
|
|
/** Set optional header for submenu
|
|
*
|
|
* @param submenu Submenu instance
|
|
* @param header header to set
|
|
*/
|
|
void submenu_set_header(Submenu* submenu, const char* header);
|
|
|
|
/** Set Orientation
|
|
*
|
|
* @param submenu Submenu instance
|
|
* @param orientation either vertical or horizontal
|
|
*/
|
|
void submenu_set_orientation(Submenu* submenu, ViewOrientation orientation);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|