/* Copyright(C) 2010- , JIELI TECHNOLOGY, Inc.
 * All right reserved.
 */
/* ------------------------------------------------------------------------------------*/
/**
 * @file layout.h
 *
 * @brief 布局控件API头文件
 *
 * @author
 *
 * @version
 *
 * @date 2022-12-14
 */
/* ------------------------------------------------------------------------------------*/

#ifndef __UI_LAYOUT_WIDGET_H__
#define __UI_LAYOUT_WIDGET_H__


#include "jlui/ui_core.h"
#include "jlui/control.h"



/* ------------------------------------------------------------------------------------*/
/**
 * @brief 布局控件句柄结构
 */
/* ------------------------------------------------------------------------------------*/
struct layout {
    struct element elm; 	//must be first
    u8 inited;			// 是否初始化，只有 true、false 两种状态
    u8 release;			// 子layout是否在onchange中释放标志，目前只有是、否两种状态
    // 空2byte
    struct layout *layout;			// 子控件指针
    const struct layout_info *info;	// layout info，从flash读进来
    const struct element_event_handler *handler;	// 回调句柄
};	// 80byte




/* ------------------------------------------------------------------------------------*/
/**
 * @brief layout_for_id 通过布局ID获取布局控件句柄
 *
 * @param id 布局控件ID
 *
 * @return layout布局控件句柄
 */
/* ------------------------------------------------------------------------------------*/
#define layout_for_id(id) \
	ui_element_for_id(id, struct layout)


/* ------------------------------------------------------------------------------------*/
/**
 * @brief layout_new 创建layout控件（内部调用）
 *
 * @param info 布局控件信息
 * @param num 布局控件数量
 * @param parent 父控件句柄
 *
 * @return layout 布局控件句柄
 */
/* ------------------------------------------------------------------------------------*/
struct layout *layout_new(struct layout_info *, int, struct element *);


/* ------------------------------------------------------------------------------------*/
/**
 * @brief layout_delete_probe 布局控件准备删除（内部调用）
 *
 * @param layout 带删除布局控件
 * @param num 布局控件数量
 */
/* ------------------------------------------------------------------------------------*/
void layout_delete_probe(struct layout *layout, int num);


/* ------------------------------------------------------------------------------------*/
/**
 * @brief layout_delete 删除布局控件（内部调用）
 *
 * @param layout 布局控件句柄
 * @param num 布局控件数量
 */
/* ------------------------------------------------------------------------------------*/
void layout_delete(struct layout *layout, int num);


/* ------------------------------------------------------------------------------------*/
/**
 * @brief layout_show 显示布局控件
 *
 * @param id 布局控件ID
 *
 * @return 0 正常，-22控件不存在
 */
/* ------------------------------------------------------------------------------------*/
int layout_show(int id);


/* ------------------------------------------------------------------------------------*/
/**
 * @brief layout_hide 隐藏布局控件
 *
 * @param id 布局控件ID
 *
 * @return 0 正常，-22控件不存在
 */
/* ------------------------------------------------------------------------------------*/
int layout_hide(int id);


/* ------------------------------------------------------------------------------------*/
/**
 * @brief layout_toggle 布局控件显示状态切换，显示时切换为隐藏，隐藏时切换为显示
 *
 * @param id 布局控件ID
 *
 * @return 0 隐藏，1 显示，-22 控件不存在
 */
/* ------------------------------------------------------------------------------------*/
int layout_toggle(int id);


/* ------------------------------------------------------------------------------------*/
/**
 * @brief layout_on_focus 布局控件聚焦，将指定布局控件设置为焦点
 *
 * @param layout 布局控件句柄
 */
/* ------------------------------------------------------------------------------------*/
void layout_on_focus(struct layout *layout);


/* ------------------------------------------------------------------------------------*/
/**
 * @brief layout_lose_focus 布局控件失焦，将布局控件焦点释放
 *
 * @param layout 布局控件句柄
 */
/* ------------------------------------------------------------------------------------*/
void layout_lose_focus(struct layout *layout);





#endif