蜂窝菜单 (Menu cellular)

蜂窝菜单组件以蜂窝形状显示一组图标。

用法

创建蜂窝菜单组件

要创建蜂窝菜单组件，使用 gui_menu_cellular_create() 函数。用户需要提供代表图标集的图像文件数组。

配置偏移

使用 gui_menu_cellular_offset() 函数可以调整水平和垂直偏移以获得更好的显示效果。

示例

GUI_APP_ENTRY(APP_MENU)
{
    /**
     * @link https://docs.realmcu.com/Honeygui/latest/widgets/gui_menu_cellular.html#example
    */
    gui_win_t *win = gui_win_create(GUI_APP_ROOT_SCREEN, APP_MENU_WIN_NAME, 0, 0, 0, 0);
    /* app swap animation configration of the next app*/
    uint32_t *array[] =
    {
        I4500009_BIN,
        I4500011_BIN,
        I4500015_BIN,
        I4500020_BIN,
        I4500028_BIN,
        I4500034_BIN,
        I4500035_BIN,
        I4500037_BIN,
        I4500040_BIN,
        I4500042_BIN,
        I4500047_BIN,
        I4500049_BIN,
        I4500052_BIN,
        I4500064_BIN,
        I4500009_BIN,
        I4500011_BIN,
        I4500015_BIN,
        I4500020_BIN,
        I4500028_BIN,
        I4500034_BIN,
        I4500035_BIN,
        I4500037_BIN,
        I4500040_BIN,
        I4500042_BIN,
        I4500047_BIN,
        I4500049_BIN,
        I4500052_BIN,
        I4500064_BIN,
        I4500009_BIN,
        I4500011_BIN,
        I4500015_BIN,
        I4500020_BIN,
        I4500028_BIN,
        I4500034_BIN,
        I4500035_BIN,
        I4500037_BIN,
        I4500040_BIN,
        I4500042_BIN,
        I4500047_BIN,
        I4500049_BIN,
        I4500052_BIN,
        I4500064_BIN,
        I4500009_BIN,
        I4500011_BIN,
        I4500015_BIN,
        I4500020_BIN,

    };

    gui_menu_cellular_t *cell = gui_menu_cellular_create(win, 100, array,
                                                         sizeof(array) / sizeof(uint32_t *));
    gui_menu_cellular_offset((void *)cell, -36, -216);
    {
        struct gui_menu_cellular_gesture_parameter gesture_parameter_array[] =
        {
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1},
        };
        gui_menu_cellular_on_click(cell, gesture_parameter_array,
                                   sizeof(gesture_parameter_array) / sizeof(gesture_parameter_array[0]));

    }
    //status_bar(win, (void *)cell);
    gui_return_create(win, gui_app_return_array,
                      sizeof(gui_app_return_array) / sizeof(uint32_t *), win_cb, (void *)cell);
}

API

Functions

gui_menu_cellular_t *gui_menu_cellular_create(void *parent, int icon_size, uint32_t *icon_array[], int array_size)

Create a honeycomb effect widget.

参数:

• parent – The father widget nested in.

• icon_size – Icon’s width(px).

• icon_array – Icons set’s file address array.

• array_size – The array’s size.

返回:

gui_menu_cellular_t*

void gui_menu_cellular_offset(gui_obj_t *menu_cellular, int offset_x, int offset_y)

Config offset.

参数:

• menu_cellular – The menu_cellular pointer.

• offset_x – Offset_x.

• offset_y – Offset_y.

void gui_menu_cellular_on_click(gui_menu_cellular_t *menu_cellular, struct gui_menu_cellular_gesture_parameter *para_array, int array_length)

Listen to click events on the cellular menu.

It processes the click event based on the given gesture parameters.

参数:

• menu_cellular – Pointer to the cellular menu structure.

• para_array – Array of gesture parameters corresponding to the click event.

• array_length – Length of the gesture parameters array.

gui_menu_cellular_t *gui_menu_cellular_create_ftl(void *parent, int icon_size, uint32_t *icon_array[], int array_size)

Create a honeycomb effect widget (ftl address mode).

参数:

• parent – The father widget nested in.

• icon_size – Icon’s width(px).

• icon_array – Icons set’s file address array (ftl address mode).

• array_size – The array’s size.

返回:

gui_menu_cellular_t*

struct gui_menu_cellular_t

Menu_cellular structure.

Public Members

gui_win_t base

base structure

void *overwrite

int x

int y

int16_t speed[2]

int16_t left

int16_t right

int16_t top

int16_t bottom

int16_t left_offset

int16_t right_offset

int16_t top_offset

int16_t bottom_offset

int16_t touch_y

bool render

struct gui_menu_cellular_gesture_parameter

Public Members

gui_event_cb_t callback_function

void *parameter