Page

The page widget enables developers to establish a column of additional controls along the y-axis. These controls are permitted to extend beyond the screen’s display boundary. Users can access these controls by swiping up or down.

Usage

Example

#include "root_image_hongkong/ui_resource.h"
#include <gui_img.h>
#include "gui_win.h"
#include "gui_text.h"
#include <draw_font.h>
#include "gui_button.h"
#include "gui_page.h"

extern void callback_prism(void *obj, gui_event_t e);

void page_tb_activity(void *parent)
{
    gui_img_create_from_mem(parent, "page1", ACTIVITY_BIN, 0, 0, 0, 0);
    gui_win_t *win_function = gui_win_create(parent, "win_function", 0, 0, 368, 448);
    gui_obj_add_event_cb(win_function, (gui_event_cb_t)callback_prism, GUI_EVENT_TOUCH_LONG, NULL);

    gui_page_t *pg1 = gui_page_create(parent, "page", 0, 0, 0, 0);

    gui_img_t *img1 = gui_img_create_from_mem(pg1, "img1", BUTTON1_BIN, 0, 150, 0, 0);
    gui_img_t *img2 = gui_img_create_from_mem(pg1, "img2", BUTTON2_BIN, 0, 230, 0, 0);
    gui_img_t *img3 = gui_img_create_from_mem(pg1, "img3", BUTTON3_BIN, 0, 300, 0, 0);
    gui_img_t *img4 = gui_img_create_from_mem(pg1, "img4", PLAYER_MUSIC_REWIND_ICON_BIN, 0, 380, 0, 0);
    gui_img_t *img5 = gui_img_create_from_mem(pg1, "img5", PLAYER_MUSIC_WIND_ICON_BIN, 0, 460, 0, 0);
}

API

Defines

GUI_PAGE_MAX_SPEED

GUI_PAGE_MIN_SPEED

Enums

enum T_PAGE_REBOUND_TYPE

Values:

enumerator PAGE_REBOUND_NOT

enumerator PAGE_REBOUND_UP

enumerator PAGE_REBOUND_DOWN

Functions

void gui_page_update(gui_obj_t *obj)

update the page widget.

Parameters:

obj – widget pointer.

void gui_page_destory(gui_obj_t *obj)

destory the page widget.

Parameters:

obj – widget pointer.

void gui_page_ctor(gui_page_t *this, gui_obj_t *parent, const char *name, int16_t x, int16_t y, int16_t w, int16_t h)

construct a page widget.

Parameters:

this – widget pointer.
parent – the father widget the page nested in.
filename – the page widget name.
x – the X-axis coordinate.
x – the Y-axis coordinate.
w – the width.
h – the hight.

gui_page_t *gui_page_create(void *parent, const char *name, int16_t x, int16_t y, int16_t w, int16_t h)

create a page widget.

Example usage

{
     char* ptxt = "page_name";
     parent = (void *)gui_page_create(parent, ptxt, x, y, w, h);
}

Parameters:

parent – the father widget the page nested in.
filename – the page widget name.
x – the X-axis coordinate.
x – the Y-axis coordinate.
w – the width.
h – the hight.

Returns:

return the widget object pointer

void gui_page_add_scroll_bar(gui_page_t *this, void *bar_pic, IMG_SOURCE_MODE_TYPE src_mode)

Parameters:

this – widget object pointer
bar_pic – bar picture address
src_mode – image source mode, 0 memory and 1 file system

void gui_page_set_offset(gui_page_t *this, int offset)

Parameters:

this – widget object pointer
offset – page offset

int gui_page_get_offset(gui_page_t *this)

Parameters:

this – widget object pointer

Returns:

page offset

void gui_page_set_animate(gui_page_t *this, uint32_t dur, int repeat_count, void *callback, void *p)

Parameters:

o – widget object pointer
dur – Animation duration
repeat_count – Repeat play times, -1 means play on repeat forever
callback – animate frame callback
p – parameter

void gui_page_rebound(gui_page_t *this, bool rebound)

config rebound

Parameters:

this – widget object pointer
rebound – true: config rebound; false: not rebound;

void gui_page_center_alignment(gui_page_t *page, int align_hight)

automatic center alignment

Parameters:

page – widget pointer
align_hight –

void gui_page_set_only_top_slide(gui_page_t *page, bool flag)

set only top slide flag

Parameters:

page – widget pointer
flag – true:only top slide; false:all slide

struct gui_page_t

#include <gui_page.h>

PAGE widget structure.

Public Members

gui_obj_t base

uint32_t current_id

uint32_t widget_count

uint32_t width

int yold

int16_t recode[5]

int speed

int target

int start_x

int start_y

int align_hight

gui_img_t *scroll_bar

int get_yend

gui_animate_t *animate

void (*ctor)(struct gui_page *this, gui_obj_t *parent, const char *name, int16_t x, int16_t y, int16_t w, int16_t h)

bool release

bool press

bool gesture_flag

bool top_slide_only

uint8_t status

IMG_SOURCE_MODE_TYPE src_mode

uint8_t checksum

Page

Usage

Create page widget

Example

API