huxi
153 lines
4.9 KiB
C
153 lines
4.9 KiB
C
/* Copyright(C) 2010- , JIELI TECHNOLOGY, Inc.
|
|
* All right reserved.
|
|
*/
|
|
|
|
/* ------------------------------------------------------------------------------------*/
|
|
/**
|
|
* @file ui_slider.h
|
|
*
|
|
* @brief 水平进度条控件API接口头文件
|
|
*
|
|
* @author zhuhaifang@zh-jieli.com
|
|
*
|
|
* @version V201
|
|
*
|
|
* @date 2022-12-15
|
|
*/
|
|
/* ------------------------------------------------------------------------------------*/
|
|
|
|
#ifndef __UI_SLIDER_WIDGET_H__
|
|
#define __UI_SLIDER_WIDGET_H__
|
|
|
|
|
|
#include "jlui/ui_core.h"
|
|
#include "jlui/control.h"
|
|
|
|
|
|
|
|
/* ------------------------------------------------------------------------------------*/
|
|
/**
|
|
* @brief 定义水平进度条控件子控件数量
|
|
*/
|
|
/* ------------------------------------------------------------------------------------*/
|
|
#define SLIDER_CHILD_NUM (SLIDER_CHILD_END - SLIDER_CHILD_BEGIN)
|
|
|
|
|
|
struct slider_text_info {
|
|
u8 move;
|
|
int min_value;
|
|
int max_value;
|
|
int text_color;
|
|
};
|
|
|
|
|
|
/* ------------------------------------------------------------------------------------*/
|
|
/**
|
|
* @brief 水平进度条控件句柄结构
|
|
*/
|
|
/* ------------------------------------------------------------------------------------*/
|
|
struct ui_slider {
|
|
struct element elm; // 进度条控件本身
|
|
struct element child_elm[SLIDER_CHILD_NUM]; // 进度条控件子控件，3个：高亮、非高亮、滑块
|
|
|
|
u8 move: 1; // 划动使能（true使能，false不使能）
|
|
u8 step: 7; // 步进量
|
|
|
|
u8 follow_pic: 1; // right_pic和left_pic分界跟随滑块中线（注意，使能它将进度0%和100%时不被填满，适用滑块有图片的场景）
|
|
u8 persent: 7; // 百分比 0-100
|
|
|
|
s16 left; // selected的left
|
|
s16 width; // selected的width
|
|
s16 min_value; // 最小值
|
|
s16 max_value; // 最大值
|
|
const struct ui_slider_info *info;
|
|
const struct element_event_handler *handler;
|
|
}; // 340byte
|
|
|
|
|
|
/* ------------------------------------------------------------------------------------*/
|
|
/**
|
|
* @brief 通过ID获取水平进度条控件句柄
|
|
*/
|
|
/* ------------------------------------------------------------------------------------*/
|
|
#define ui_slider_for_id(id) \
|
|
ui_element_for_id(id, struct ui_slider)
|
|
|
|
|
|
/* ------------------------------------------------------------------------------------*/
|
|
/**
|
|
* @brief ui_slider_enable 水平进度条控件使能（内部调用）
|
|
*/
|
|
/* ------------------------------------------------------------------------------------*/
|
|
void ui_slider_enable();
|
|
|
|
|
|
/* ------------------------------------------------------------------------------------*/
|
|
/**
|
|
* @brief ui_slider_set_persent_by_id 设置水平进度条百分比（待redraw）
|
|
*
|
|
* @param id 水平进度条控件ID
|
|
* @param persent 水平进度条显示百分比
|
|
*
|
|
* @return 0 正常，-22 控件不存在
|
|
*/
|
|
/* ------------------------------------------------------------------------------------*/
|
|
int ui_slider_set_persent_by_id(int id, int persent);
|
|
|
|
|
|
/* ------------------------------------------------------------------------------------*/
|
|
/**
|
|
* @brief ui_slider_set_persent 设置水平进度条控件百分比（不带redraw）
|
|
*
|
|
* @param slider 水平进度条控件句柄
|
|
* @param persent 水平进度条显示百分比
|
|
*
|
|
* @return 0 正常，-22 控件不存在
|
|
*/
|
|
/* ------------------------------------------------------------------------------------*/
|
|
int ui_slider_set_persent(struct ui_slider *slider, int persent);
|
|
|
|
|
|
/* ------------------------------------------------------------------------------------*/
|
|
/**
|
|
* @brief slider_touch_slider_move 水平进度条控件划动（在ON_TOUCH_MOVE事件没有return true时，将move标志设置为真，底层会自动调用该接口）
|
|
*
|
|
* @param slider 水平进度条控件句柄
|
|
* @param e 触摸事件
|
|
*
|
|
* @return 0 正常，-22 控件不存在
|
|
*/
|
|
/* ------------------------------------------------------------------------------------*/
|
|
int slider_touch_slider_move(struct ui_slider *slider, struct element_touch_event *e);//触摸滑动功能
|
|
|
|
|
|
/* ------------------------------------------------------------------------------------*/
|
|
/**
|
|
* @brief ui_slider_set_follow_pic 设置高亮和非高亮部分是否跟随滑块中心
|
|
*
|
|
* @Params slider 进度条控件
|
|
* @Params follow_pic 是否跟随滑块中心 true 跟随，false 不跟随
|
|
*
|
|
* @return true 跟随滑块，false 不跟随滑块
|
|
*/
|
|
/* ------------------------------------------------------------------------------------*/
|
|
int ui_slider_set_follow_pic(struct ui_slider *slider, u8 follow_pic);
|
|
|
|
|
|
/* ------------------------------------------------------------------------------------*/
|
|
/**
|
|
* @brief slider_get_percent 获取水平进度条控件百分比
|
|
*
|
|
* @param slider 水平进度条控件句柄
|
|
*
|
|
* @return 水平进度条控件百分比值
|
|
*/
|
|
/* ------------------------------------------------------------------------------------*/
|
|
int slider_get_percent(struct ui_slider *slider);
|
|
|
|
|
|
|
|
|
|
#endif
|
|
|