huxi
1256 lines
34 KiB
Lua
1256 lines
34 KiB
Lua
--[[
|
|
@apiDefine GuiGroup gui
|
|
--]]
|
|
|
|
|
|
|
|
--[[
|
|
@notes
|
|
@tip:gui库，包含所有gui相关的操作方法，包含创建实例，页面切换及具体控件方法等
|
|
@demo:gui:getComponentByName("BUTTON_1")\n gui:switchPageByName("PAGE_3", "left")\n gui:backToPreviousPage("right")
|
|
]]
|
|
gui = {}
|
|
|
|
gui.dial_item = 1
|
|
|
|
|
|
|
|
-- 表盘预览图路径
|
|
local watchPreviewImage = "/模式界面/project/config/蓝牙智能手表切图/表盘预览图/"
|
|
|
|
-- 表盘背景图路径
|
|
local watchBgPreviewImage = "/模式界面/project/config/蓝牙智能手表切图/表盘切换/"
|
|
|
|
|
|
|
|
-- 打印错误信息
|
|
function log_e(func, msg)
|
|
log:e('function \"'..func..'\", '..msg)
|
|
end
|
|
|
|
-- 打印警告信息
|
|
function log_w(func, msg)
|
|
log:w('function \"'..func..'\", '..msg)
|
|
end
|
|
|
|
-- 打印参数参考
|
|
function log_refer(msg)
|
|
log:i('>> please refer to : '..msg)
|
|
end
|
|
|
|
-- 检查参数类型
|
|
local function check_type(func, arg, num, typ)
|
|
return log:checkArgType(func, num, arg, typ)
|
|
end
|
|
|
|
|
|
|
|
|
|
-- 获取工作目录
|
|
local function getRootPath()
|
|
local config = sim_system:getWatchConfig()
|
|
return config.workspace_path
|
|
end
|
|
|
|
-- 获取模式界面路径
|
|
local function getModulePath()
|
|
local config = sim_system:getWatchConfig()
|
|
return config.workspace_path .. config.project_list.mode_interface
|
|
end
|
|
|
|
-- 获取升级界面路径
|
|
local function getUpdatePath()
|
|
local config = sim_system:getWatchConfig()
|
|
return config.workspace_path .. config.project_list.update_interface
|
|
end
|
|
|
|
-- 获取侧边栏页面路径
|
|
local function getSidebarPath()
|
|
local config = sim_system:getWatchConfig()
|
|
return config.workspace_path .. config.project_list.sidebar_interface
|
|
end
|
|
|
|
-- 获取表盘页面路径
|
|
local function getDialPath(num)
|
|
local config = sim_system:getWatchConfig()
|
|
return (config.workspace_path)..(config.project_list.dial_interface[num])
|
|
end
|
|
|
|
-- 获取表盘数量
|
|
local function getDialNum()
|
|
local config = sim_system:getWatchConfig()
|
|
return #config.project_list.dial_interface
|
|
end
|
|
|
|
|
|
|
|
|
|
-- 获取表盘预览图数量
|
|
local function getWatchPreviewNum()
|
|
local watchPreviewPath = getRootPath() .. watchPreviewImage
|
|
local previewList = sim_file:getListFile(watchPreviewPath)
|
|
return #previewList
|
|
end
|
|
|
|
-- 获取表盘预览图路径
|
|
local function getWatchPreviewPath(num)
|
|
local watchPreviewPath = getRootPath() .. watchPreviewImage
|
|
local previewList = sim_file:getListFile(watchPreviewPath)
|
|
return previewList[num].path
|
|
end
|
|
|
|
|
|
-- 获取表盘背景图数量
|
|
local function getWatchBgPreviewNum()
|
|
local watchBgPreviewPath = getRootPath() .. watchBgPreviewImage
|
|
local bgPreviewList = sim_file:getListFile(watchBgPreviewPath)
|
|
return #bgPreviewList
|
|
end
|
|
|
|
-- 获取表盘背景图路径
|
|
local function getWatchBgPreviewPath(num)
|
|
local watchBgPreviewPath = getRootPath() .. watchBgPreviewImage
|
|
local previewList = sim_file:getListFile(watchBgPreviewPath)
|
|
return previewList[num].path
|
|
end
|
|
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:touchEventDefault(takeover) 默认消息
|
|
@apiName touchEventDefault()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription touch消息是否默认接管
|
|
|
|
@apiParam {boolean{true, false}} [takeover] 是否默认接管touch消息，缺省时接管。
|
|
|
|
@apiParamExample 示例:
|
|
gui:touchEventDefault() -- 默认接管touch消息
|
|
gui:touchEventDefault(false) -- 默认不接管touch消息
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
所有touch消息不再传给父控件
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
父控件依然接收到touch消息
|
|
]]
|
|
function gui:touchEventDefault(take)
|
|
if (not check_type('touchEventTakeover', take, 1, 'boolean')) then
|
|
return
|
|
end
|
|
log:d('ename: [ GUI ], touchEventTakeover: '..tostring(take))
|
|
if take then
|
|
log:d("take over on")
|
|
ui:touchEventTakeOverOn()
|
|
else
|
|
log:d("take over off")
|
|
ui:touchEventTakeOverOff()
|
|
end
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:touchEventTakeover(takeover) 本次消息
|
|
@apiName touchEventTakeover()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 本次消息接管设置，只设置本次消息是否接管，一般用在touchDown，在touchDown中接管消息后，会将ui焦点聚焦到该控件
|
|
|
|
@apiParam {boolean{true, false}} [takeover] 是否接管本次消息，缺省时接管
|
|
|
|
@apiParamExample 示例:
|
|
gui:touchEventTakeover() -- 接管本次消息
|
|
gui:touchEventTakeover(false) -- 不接管本次消息
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
本次touch消息不再传给父控件
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
父控件依然接收到touch消息
|
|
]]
|
|
function gui:touchEventTakeover(take)
|
|
if (not check_type('touchEventTakeover', take, 1, 'boolean')) then
|
|
return
|
|
end
|
|
log:d('ename: [ GUI ], touchEventTakeover: '..tostring(take))
|
|
if take then
|
|
log:d("take over on")
|
|
ui:touchEventTakeOverOn()
|
|
else
|
|
log:d("take over off")
|
|
ui:touchEventTakeOverOff()
|
|
end
|
|
end
|
|
|
|
|
|
|
|
|
|
|
|
WatchDial = {}
|
|
|
|
|
|
--[[
|
|
@api {GET} number=obj:getWatchNum() 表盘数量
|
|
@apiName getWatchNum()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 获取内存中表盘的数量
|
|
|
|
@apiParamExample 示例:
|
|
watchdial = gui:getWatchHandler() -- 获取表盘句柄
|
|
number = watchdial:getWatchNum() -- 获取表盘数量
|
|
print(number) --打印表盘数量
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
准确获取内存中的表盘数量
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
获取到内存中表盘数量错误或程序异常
|
|
]]
|
|
function WatchDial:getWatchNum()
|
|
|
|
-- 获取表盘工程数量
|
|
local watchNum = getDialNum()
|
|
|
|
-- 获取预览图数量
|
|
local previewNum = getWatchPreviewNum()
|
|
|
|
-- 如果表盘工程数量和预览图数量不匹配，需要提示异常
|
|
if (watchNum ~= previewNum) then
|
|
log_e("getWatchNum", "watch dial project number no equal to dial preview number, please check it!")
|
|
log:c(self.previewPath, "orange")
|
|
for k, v in ipairs(gui.project_list.dial_interface) do
|
|
log:c(v, "orange")
|
|
end
|
|
end
|
|
|
|
log:d("watch number: "..tostring(watchNum))
|
|
return watchNum
|
|
end
|
|
|
|
|
|
--[[
|
|
@api {SET} obj:openWatchPreview(number) 打开表盘预览
|
|
@apiName openWatchPreview()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 打开指定的表盘预览文件
|
|
|
|
@apiParam {number} number 需要打开的表盘预览图索引
|
|
|
|
@apiParamExample 示例:
|
|
watchdial = gui:getWatchHandler() -- 获取表盘句柄
|
|
watchdial:openWatchPreview(0) -- 打开第0个表盘预览
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function WatchDial:openWatchPreview(num)
|
|
if (not log:checkArgType("openWatchPreview", 1, num, "number")) then
|
|
return
|
|
end
|
|
|
|
local watchNum = getWatchPreviewNum()
|
|
if (num < 0) or (num >= watchNum) then
|
|
log_e("openWatchPreview", "arg must between 0 to "..tostring(watchNum))
|
|
return
|
|
end
|
|
log:d("openWatchPreview")
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} obj:closeWatchPreview(number) 关闭表盘预览
|
|
@apiName closeWatchPreview()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 关闭指定的表盘预览图
|
|
|
|
@apiParam {number} number 准备关闭的表盘文件索引
|
|
|
|
@apiParamExample 示例:
|
|
watchdial = gui:getWatchHandler() -- 获取表盘句柄
|
|
watchdial:closeWatchPreview(0) -- 关闭第0个表盘
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function WatchDial:closeWatchPreview(num)
|
|
if (not log:checkArgType("closeWatchPreview", 1, num, "number")) then
|
|
return
|
|
end
|
|
|
|
local watchNum = getWatchPreviewNum()
|
|
if (num < 0) or (num >= watchNum) then
|
|
log_e("closeWatchPreview", "arg must between 0 to "..tostring(watchNum))
|
|
return
|
|
end
|
|
log:d("closeWatchPreview")
|
|
end
|
|
|
|
|
|
--[[
|
|
@api {SET} obj:selectWatchPreview(number) 选中表盘预览
|
|
@apiName selectWatchPreview()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 选中指定的表盘预览图
|
|
|
|
@apiParam {number} number 选中的表盘文件索引
|
|
|
|
@apiParamExample 示例:
|
|
watchdial = gui:getWatchHandler() -- 获取表盘句柄
|
|
watchdial:selectWatchPreview(0) -- 选中第0个表盘预览
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function WatchDial:selectWatchPreview(num)
|
|
if (not log:checkArgType("selectWatchPreview", 1, num, "number")) then
|
|
return
|
|
end
|
|
|
|
local watchNum = getDialNum()
|
|
if (num < 0) or (num >= watchNum) then
|
|
log_e("selectWatchPreview", "arg must between 0 to "..tostring(watchNum))
|
|
return
|
|
end
|
|
|
|
-- 返回文件路径
|
|
return getWatchPreviewPath(num + 1)
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} obj:switchWatch(index) 切换表盘
|
|
@apiName switchWatch()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 切换选中表盘使用
|
|
|
|
@apiParam {number} index 切换的目标表盘索引
|
|
|
|
@apiParamExample 示例:
|
|
watchdial = gui:getWatchHandler() -- 获取表盘句柄
|
|
watchdial:switchWatch(1) -- 切换到索引为1的表盘
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function WatchDial:switchWatch(item)
|
|
if (not log:checkArgType("switchWatch", 1, item, "number")) then
|
|
return
|
|
end
|
|
|
|
local watchNum = getDialNum()
|
|
if (item < 0) or (item >= watchNum) then
|
|
log_e("switchWatch", "arg must between 0 to "..tostring(watchNum))
|
|
return
|
|
end
|
|
gui.dial_item = item
|
|
|
|
-- 替换PAGE_0为对应的表盘，并切换页面
|
|
local dialPath = getDialPath(num + 1)
|
|
ui:replaceProjectPage(dialPath, 0, 0)
|
|
ui:switchPage(0)
|
|
end
|
|
|
|
|
|
--[[
|
|
@api {SET} number=obj:getWatchBgpNum() 表盘背景图数量
|
|
@apiName getWatchBgpNum()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 获取表盘背景图数量
|
|
|
|
@apiParamExample 示例:
|
|
watchdial = gui:getWatchHandler() -- 获取表盘句柄
|
|
number = watchdial:getWatchBgpNum() -- 获取表盘背景图数量
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function WatchDial:getWatchBgpNum()
|
|
-- 获取背景图数量
|
|
local bgppreviewNum = getWatchBgPreviewNum()
|
|
log:d("watch backgrand image number: "..tostring(bgppreviewNum))
|
|
return bgppreviewNum
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} obj:openWatchBgpPreview(number) 打开表盘背景
|
|
@apiName openWatchBgpPreview()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 打开指定表盘背景图
|
|
|
|
@apiParam {number} number 打开的表盘背景预览图索引
|
|
|
|
@apiParamExample 示例:
|
|
watchdial = gui:getWatchHandler() -- 获取表盘句柄
|
|
watchdial:openWatchBgpPreview(0) -- 打开第0个表盘背景预览图
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function WatchDial:openWatchBgpPreview(num)
|
|
if (not log:checkArgType("openWatchBgpPreview", 1, num, "number")) then
|
|
return
|
|
end
|
|
|
|
local number = getWatchBgPreviewNum()
|
|
if (num < 0) or (num >= number) then
|
|
log_e("openWatchBgpPreview", "arg must between 0 to "..tostring(number))
|
|
return
|
|
end
|
|
|
|
log:d("openWatchBgpPreview")
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} obj:closeWatchBgpPreview(index) 关闭表盘背景
|
|
@apiName closeWatchBgpPreview()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 关闭指定的表盘背景图
|
|
|
|
@apiParam {number} index 关闭的表盘背景预览图索引
|
|
|
|
@apiParamExample 示例:
|
|
watchdial = gui:getWatchHandler() -- 获取表盘句柄
|
|
watchdial:closeWatchBgpPreview(0) -- 关闭第0个表盘背景预览图
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function WatchDial:closeWatchBgpPreview(num)
|
|
if (not log:checkArgType("closeWatchBgpPreview", 1, num, "number")) then
|
|
return
|
|
end
|
|
|
|
local number = getWatchBgPreviewNum()
|
|
if (num < 0) or (num >= number) then
|
|
log_e("closeWatchBgpPreview", "arg must between 0 to "..tostring(number))
|
|
return
|
|
end
|
|
|
|
log:d("closeWatchBgpPreview")
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} obj:selectWatchBgpPreview(index) 选择表盘背景
|
|
@apiName selectWatchBgpPreview()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 选中指定的表盘背景图
|
|
|
|
@apiParam {number} index 选择的表盘背景预览图索引
|
|
|
|
@apiParamExample 示例:
|
|
watchdial = gui:getWatchHandler() -- 获取表盘句柄
|
|
watchdial:selectWatchBgpPreview(0) -- 选择第0个表盘背景图
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
暂空
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
暂空
|
|
]]
|
|
function WatchDial:selectWatchBgpPreview(num)
|
|
if (not log:checkArgType("selectWatchBgpPreview", 1, num, "number")) then
|
|
return
|
|
end
|
|
|
|
local number = getWatchBgPreviewNum()
|
|
if (num < 0) or (num >= number) then
|
|
log_e("selectWatchBgpPreview", "arg must between 0 to "..tostring(number))
|
|
return
|
|
end
|
|
|
|
-- 返回文件路径
|
|
return getWatchBgPreviewPath(num + 1)
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} watch=obj:getWatchHandler() 表盘句柄
|
|
@apiName getWatchHandler()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 获取表盘操作句柄
|
|
|
|
@apiParamExample 示例:
|
|
watchdial = gui:getWatchHandler() -- 获取表盘句柄
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
暂空
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
暂空
|
|
]]
|
|
function gui:getWatchHandler()
|
|
local watch = {}
|
|
setmetatable(watch, {__index = WatchDial})
|
|
return watch
|
|
end
|
|
|
|
|
|
|
|
|
|
-- 页面切换列表
|
|
local pageSwitch = {}
|
|
pageSwitch.index = 0
|
|
pageSwitch.list = {}
|
|
pageSwitch.maxPageNumber = 8
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:switchPageByName(PAGE,mode[,record]) 页面跳转
|
|
@apiName switchPageByName()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 按照指定的方式进行页面跳转
|
|
|
|
@apiParam {string{"PAGE_0", "PAGE_1", "PAGE_2", ...}} PAGE 目标页面名称
|
|
@apiParam {string{"left", "right", "hide"}} mode 切换方式
|
|
@apiParam {boolean{true, false}} [record] 是否记录切换路径，缺省时记录
|
|
|
|
@apiParamExample 示例:
|
|
-- 直接覆盖方式切换到PAGE1
|
|
gui:switchPageByName("PAGE_1", "hide")
|
|
|
|
-- 从右边滑入方式切换到PAGE3
|
|
gui:switchPageByName("PAGE_3", "right")
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
成功按照指定方式跳转到目标页面
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
页面未跳转，或未按照指定方式跳转到目标页面
|
|
]]
|
|
function gui:switchPageByName(...)
|
|
local arg = {...}
|
|
local arg_num = #arg
|
|
|
|
for k, v in pairs(arg) do
|
|
print(k, v)
|
|
end
|
|
|
|
|
|
-- 参数只能两个或三个
|
|
if (arg_num ~= 2) and (arg_num ~= 3) then
|
|
log_e("switchPageByName", "arg number, error")
|
|
return
|
|
end
|
|
|
|
local ename = arg[1]
|
|
local mode = arg[2]
|
|
local record = true
|
|
local s, e, str
|
|
-- 判断ename是否为字符串
|
|
if (not log:checkArgType("switchPageByName", 1, ename, "string", "number")) then
|
|
log_refer('"PAGE_0", "PAGE_1", "PAGE_2" etc.')
|
|
return
|
|
else
|
|
-- 正则匹配是否为页面
|
|
if (type(ename) == "string") then
|
|
s, e, str = string.find(ename, '(%bPAGE_)%d')
|
|
if ((s ~= 1) and (str ~= 'PAGE_')) then
|
|
log_e('switchPageByName', 'arg0 is not a page name!')
|
|
log_refer('"PAGE_0", "PAGE_1", "PAGE_2" etc.')
|
|
return
|
|
end
|
|
end
|
|
end
|
|
|
|
-- 判断mode是否为字符串
|
|
if (not log:checkArgType("switchPageByName", 2, mode, "string")) then
|
|
log_refer('"hide", "left", "right"')
|
|
return
|
|
end
|
|
|
|
-- 判断mode是否在指定范围内
|
|
local mode_val = {"left", "right", "hide"}
|
|
if (not log:checkValue(mode, mode_val)) then
|
|
log_refer('"hide", "left", "right"')
|
|
return
|
|
end
|
|
|
|
-- 如果有第三个参数，检查第三个参数
|
|
if (arg_num == 3) then
|
|
if (not log:checkArgType("switchPageByName", 3, arg[3], "boolean")) then
|
|
return
|
|
end
|
|
record = arg[3]
|
|
end
|
|
|
|
-- 记录页面跳转
|
|
if (record) then
|
|
-- 当前页面
|
|
local current_page = ui:getCurrPageName()
|
|
-- 目标页面
|
|
local target_page = ename
|
|
|
|
-- 如果列表里最新的页面不是当前页面，那么清空列表重新开始记录
|
|
if (not (pageSwitch.list[pageSwitch.index] ~= current_page)) then
|
|
pageSwitch.list[1] = current_page
|
|
pageSwitch.index = 1
|
|
end
|
|
|
|
-- 列表索引加一
|
|
pageSwitch.index = pageSwitch.index + 1
|
|
-- 如果列表索引超过最大页面记录数量，跳转到表盘页面
|
|
if (pageSwitch.index >= pageSwitch.maxPageNumber) then
|
|
pageSwitch.index = 1
|
|
local dialPath = getDialPath(gui.dial_item)
|
|
log:d("show dial: "..dialPath)
|
|
ui:replaceProjectPage(dialPath, 0, 0)
|
|
ui:switchPage(0)
|
|
return
|
|
end
|
|
|
|
-- 记录目标页面
|
|
pageSwitch.list[pageSwitch.index] = target_page
|
|
-- table.insert(pageSwitch.list, ename)
|
|
-- pageSwitch.index = pageSwitch.index + 1
|
|
for k, v in ipairs(pageSwitch.list) do
|
|
print(k, v)
|
|
end
|
|
end
|
|
|
|
-- 参数检查正确再模拟切换页面
|
|
log:d('switch page by name: '.. ename..', '..mode)
|
|
|
|
if (ename == "PAGE_0") then
|
|
-- 页面0表示表盘页面
|
|
local dialPath = getDialPath(gui.dial_item)
|
|
log:d("show dial: "..dialPath)
|
|
ui:switchPage(0)
|
|
ui:replaceProjectPage(dialPath, 0, 0)
|
|
else
|
|
if (mode == "hide") then
|
|
ui:switchPageByName(ename, 0)
|
|
else
|
|
ui:switchPageByName(ename, mode)
|
|
end
|
|
end
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:backToPreviousPage(mode) 返回上一级页面
|
|
@apiName backToPreviousPage()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 返回上一级页面，必须是通过switchPageByName跳转并选择记录的页面才能返回，否则直接返回表盘页面
|
|
|
|
@apiParam {string{"left", "right", "hide"}} mode 返回时切换方式
|
|
|
|
@apiParamExample 示例:
|
|
gui:switchPageByName("PAGE_5", "left") -- 从左边滑入切换到第5页
|
|
gui:backToPreviousPage("left") -- 从右边滑入返回上一页
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
成功返回上一次页面
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
返回表盘页面，或未按指定方式返回上一级页面
|
|
]]
|
|
function gui:backToPreviousPage(mode)
|
|
if (not log:checkArgType("backToPreviousPage", 1, mode, "string")) then
|
|
log_refer('"hide", "left", "right"')
|
|
return
|
|
end
|
|
|
|
local mode_val = {"hide", "left", "right"}
|
|
if (not log:checkValue(mode, mode_val)) then
|
|
log_refer('"hide", "left", "right"')
|
|
return
|
|
end
|
|
|
|
local current_page = ui:getCurrPageName()
|
|
-- 如果当前页面不是记录中最新的页面，则跳转到表盘页面
|
|
if (current_page ~= pageSwitch.list[pageSwitch.index]) then
|
|
pageSwitch.index = 1
|
|
local dialPath = getDialPath(gui.dial_item)
|
|
log:d("show dial: "..dialPath)
|
|
ui:replaceProjectPage(dialPath, 0, 0)
|
|
ui:switchPage(0)
|
|
return
|
|
end
|
|
pageSwitch.index = pageSwitch.index - 1
|
|
-- 如果索引小于1，则跳转到表盘页面
|
|
if (pageSwitch.index <= 1) then
|
|
pageSwitch.index = 1
|
|
local dialPath = getDialPath(gui.dial_item)
|
|
log:d("show dial: "..dialPath)
|
|
ui:replaceProjectPage(dialPath, 0, 0)
|
|
ui:switchPage(0)
|
|
return
|
|
end
|
|
-- 获取上一个页面并跳转
|
|
local prev_page = pageSwitch.list[pageSwitch.index]
|
|
ui:switchPageByName(prev_page, mode)
|
|
|
|
log:d('back to previous page: '..mode)
|
|
|
|
-- ui:backToPreviousPage(mode)
|
|
-- table.remove(pageSwitch.list)
|
|
-- pageSwitch.index = pageSwitch.index - 1
|
|
end
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:checkPreviousPage(PAGE) 检查上一级页面
|
|
@apiName checkPreviousPage()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 检查上一级页面是否为指定页面
|
|
|
|
@apiParam {string{"PAGE_0", "PAGE_1", "PAGE_2", ...}} PAGE 上一级页面名称
|
|
|
|
@apiParamExample 示例:
|
|
if (gui:checkPreviousPage("PAGE_7")) then
|
|
-- 如果上一级页面是PAGE7执行这里
|
|
else
|
|
-- 否则执行这里
|
|
end
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
返回 true，上一页是指定页面
|
|
返回 false，上一页不是指定页面
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function gui:checkPreviousPage(page)
|
|
if (not log:checkArgType("checkPreviousPage", 1, page, "string")) then
|
|
return
|
|
end
|
|
|
|
-- 正则匹配是否为页面
|
|
local s, e, str
|
|
s, e, str = string.find(page, '(%bPAGE_)%d')
|
|
if ((s ~= 1) and (str ~= 'PAGE_')) then
|
|
log_e('checkPreviousPage', 'arg0 is not a page name!')
|
|
log_refer('"PAGE_0", "PAGE_1", "PAGE_2" etc.')
|
|
return
|
|
end
|
|
|
|
local prev_page = pageSwitch.list[pageSwitch.index - 1]
|
|
log:d("check page: "..tostring(page)..", prev_page: "..tostring(prev_page))
|
|
if prev_page == page then
|
|
return true
|
|
end
|
|
return false
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} type=gui:getControlType(ename) 获取控件类型
|
|
@apiName getControlType()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 获取控件的类型名称
|
|
|
|
@apiParam {string} ename 控件名称
|
|
|
|
@apiParamExample 示例:
|
|
control_type = gui:getControlType("TEXT_TEST") -- 获取名称为“TEXT_TEST”的控件类型
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
返回控件名称字符串
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
返回值为 nil
|
|
]]
|
|
function gui:getControlType(ename)
|
|
if (not log:checkArgType("getControlType", 1, ename, "string")) then
|
|
return nil
|
|
end
|
|
|
|
local ctr_type = nil
|
|
ctr_type = ui:getControlType(ename)
|
|
if ((ctr_type == "VerticalList") or (ctr_type == "HorizontalList")) then
|
|
ctr_type = "List"
|
|
end
|
|
log:d('ename: [ '..ename..' ], control type: '..ctr_type)
|
|
return ctr_type
|
|
end
|
|
|
|
|
|
-- 页面滑动列表
|
|
local pageSlide = {index = 0, list = {}}
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:pageSlideInit() 页面滑动初始化
|
|
@apiName pageSlideInit()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 页面循环滑动初始化
|
|
|
|
@apiParamExample 示例:
|
|
gui:pageSlideInit()
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function gui:pageSlideInit()
|
|
log:d("pageSlideInit")
|
|
slide:initPage()
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:pageSlideAdd(PAGE) 页面增加
|
|
@apiName pageSlideAdd()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 增加指定页面到滑动列表
|
|
|
|
@apiParam {string{"PAGE_1", "PAGE_2", "PAGE_3", ...}} PAGE 需增加到循环滑动列表的页面
|
|
|
|
@apiParamExample 示例:
|
|
gui:pageSlideAdd("PAGE_5") -- 增加PAGE5到循环滑动列表
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function gui:pageSlideAdd(page)
|
|
-- 正则匹配是否为页面
|
|
local s, e, str
|
|
s, e, str = string.find(page, '(%bPAGE_)%d')
|
|
if ((s ~= 1) and (str ~= 'PAGE_')) then
|
|
log_e('checkPreviousPage', 'arg0 is not a page name!')
|
|
log_refer('"PAGE_0", "PAGE_1", "PAGE_2" etc.')
|
|
return
|
|
end
|
|
log:d("pageSlideAdd: "..page)
|
|
slide:insertNextPageByName(page)
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:pageSlideDel(PAGE) 页面删除
|
|
@apiName pageSlideDel()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 从页面滑动列表中删除指定页面
|
|
|
|
@apiParam {string{"PAGE_0", "PAGE_1", "PAGE_2", ...}} PAGE 需从循环滑动页面列表删除的页面
|
|
|
|
@apiParamExample 示例:
|
|
gui:pageSlideDel("PAGE_3") -- 将PAGE3从循环滑动页面列表删除
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function gui:pageSlideDel(page)
|
|
-- 正则匹配是否为页面
|
|
local s, e, str
|
|
s, e, str = string.find(page, '(%bPAGE_)%d')
|
|
if ((s ~= 1) and (str ~= 'PAGE_')) then
|
|
log_e('checkPreviousPage', 'arg0 is not a page name!')
|
|
log_refer('"PAGE_0", "PAGE_1", "PAGE_2" etc.')
|
|
return
|
|
end
|
|
log:d("pageSlideDel: "..page)
|
|
slide:deletePageByName(page)
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:pageSlideFree() 释放页面
|
|
@apiName pageSlideFree()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 释放页面滑动列表
|
|
|
|
@apiParamExample 示例:
|
|
gui:pageSlideFree() --释放掉所有滑动列表的页面，关闭页面滑动功能
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function gui:pageSlideFree()
|
|
log:d("pageSlideFree")
|
|
slide:freePage()
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:pageSlideNext(PAGE) 插入下一页
|
|
@apiName pageSlideNext()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 从当前页面的后一页插入指定页面到滑动列表
|
|
|
|
@apiParam {string{"PAGE_0", "PAGE_1", "PAGE_2", ...}} PAGE 下一页页面名称
|
|
|
|
@apiParamExample 示例:
|
|
gui:pageSlideNext("PAGE_10")
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function gui:pageSlideNext(page)
|
|
-- 正则匹配是否为页面
|
|
local s, e, str
|
|
s, e, str = string.find(page, '(%bPAGE_)%d')
|
|
if ((s ~= 1) and (str ~= 'PAGE_')) then
|
|
log_e('checkPreviousPage', 'arg0 is not a page name!')
|
|
log_refer('"PAGE_0", "PAGE_1", "PAGE_2" etc.')
|
|
return
|
|
end
|
|
log:d("pageSlideNext: "..page)
|
|
slide:insertNextPageByName(page)
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:pageSlidePrev(PAGE) 插入上一页
|
|
@apiName pageSlidePrev()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 在当前页面上一页插入指定页面到滑动列表
|
|
|
|
@apiParam {string{"PAGE_0", "PAGE_1", "PAGE_2", ...}} PAGE 上一页页面名称
|
|
|
|
@apiParamExample 示例:
|
|
gui:pageSlidePrev("PAGE_7")
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
无
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
无
|
|
]]
|
|
function gui:pageSlidePrev(page)
|
|
-- 正则匹配是否为页面
|
|
local s, e, str
|
|
s, e, str = string.find(page, '(%bPAGE_)%d')
|
|
if ((s ~= 1) and (str ~= 'PAGE_')) then
|
|
log_e('checkPreviousPage', 'arg0 is not a page name!')
|
|
log_refer('"PAGE_0", "PAGE_1", "PAGE_2" etc.')
|
|
return
|
|
end
|
|
log:d("pageSlidePrev: "..page)
|
|
slide:insertPrevPageByName(page)
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} obj=gui:getComponentByName(ename) 创建控件实例
|
|
@apiName getComponentByName()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 创建控件实例（注意：所有控件都用这个方法创建实例）
|
|
|
|
@apiParam {string} ename 控件名称
|
|
|
|
@apiParamExample 示例:
|
|
text = gui:getComponentByName("TEXT_TEST") -- 获取控件名为TEXT_TEST的文本控件实例
|
|
text:setText("hello") -- 让控件TEXT_TEST显示字符串“hello”
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
重构获取控件对象，不同类型的控件包含不同的方法
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
获取到对象内容为 nil
|
|
]]
|
|
function gui:getComponentByName(ename)
|
|
if (not log:checkArgType("getComponentByName", 1, ename, "string")) then
|
|
log:i("This function only allows the control name to be passed in")
|
|
return
|
|
end
|
|
|
|
-- 获取控件类型
|
|
local ctr_type = ui:getControlType(ename)
|
|
|
|
log:d('get component by name: '..ctr_type)
|
|
|
|
-- 创建self table
|
|
local self = {}
|
|
|
|
-- 根据控件类型让gui继承对应控件库
|
|
if (ctr_type == 'Button') then
|
|
-- 按钮
|
|
setmetatable(self, {__index = Button})
|
|
setmetatable(Button, {__index = obj})
|
|
elseif (ctr_type == 'NewLayout') then
|
|
-- 布局
|
|
setmetatable(self, {__index = Layout})
|
|
setmetatable(Layout, {__index = obj})
|
|
elseif (ctr_type == 'ImageList') then
|
|
-- 图片
|
|
self._item = 0
|
|
setmetatable(self, {__index = Image})
|
|
setmetatable(Image, {__index = obj})
|
|
elseif (ctr_type == 'Battery') then
|
|
-- 电池电量
|
|
setmetatable(self, {__index = Battery})
|
|
setmetatable(Battery, {__index = obj})
|
|
elseif (ctr_type == 'Number') then
|
|
-- 数字
|
|
setmetatable(self, {__index = Number})
|
|
setmetatable(Number, {__index = obj})
|
|
elseif (ctr_type == 'Text') then
|
|
-- 文本
|
|
setmetatable(self, {__index = Text})
|
|
setmetatable(Text, {__index = obj})
|
|
elseif (ctr_type == 'Time') then
|
|
-- 时间
|
|
setmetatable(self, {__index = Time})
|
|
setmetatable(Time, {__index = obj})
|
|
elseif (ctr_type == 'watch') then
|
|
-- 表盘
|
|
setmetatable(self, {__index = Watch})
|
|
setmetatable(Watch, {__index = obj})
|
|
elseif (ctr_type == 'vslider') or (ctr_type == "slider") then
|
|
-- 进度条
|
|
setmetatable(self, {__index = Slider})
|
|
setmetatable(Slider, {__index = obj})
|
|
elseif (ctr_type == 'progressbar') then
|
|
-- 圆弧
|
|
setmetatable(self, {__index = Progress})
|
|
setmetatable(Progress, {__index = obj})
|
|
elseif (ctr_type == 'multiprogressbar') then
|
|
-- 多重圆弧
|
|
setmetatable(self, {__index = Multiprogress})
|
|
setmetatable(Multiprogress, {__index = obj})
|
|
elseif (ctr_type == 'compass') then
|
|
-- 指南针
|
|
setmetatable(self, {__index = Compass})
|
|
setmetatable(Compass, {__index = obj})
|
|
end
|
|
|
|
local obj = {}
|
|
if ((ctr_type == "VerticalList") or (ctr_type == "HorizontalList")) then
|
|
-- 列表控件
|
|
setmetatable(self, {__index = Grid})
|
|
setmetatable(Grid, {__index = obj})
|
|
obj = ui:getScrollListByName(ename)
|
|
elseif (ctr_type == "NewGrid") then
|
|
-- 表格控件
|
|
setmetatable(self, {__index = Grid})
|
|
setmetatable(Grid, {__index = obj})
|
|
obj = ui:getScrollGridByName(ename)
|
|
else
|
|
-- 使用ui库创建方法，用于重封装
|
|
obj = ui:getComponentByName(ename)
|
|
end
|
|
|
|
-- 保存控件名称和类型，注意：这两参数只用于模拟器调试时的打印
|
|
self._ename = ename
|
|
self._type = ctr_type
|
|
|
|
-- 控件id，在小机SDK中会保存控件ID
|
|
self.__id = 0x5a5a5a5a
|
|
|
|
-- 控件高亮状态标志
|
|
self._highlight = false
|
|
|
|
-- self table的obj继承ui库
|
|
if (not obj) then
|
|
log:e("function \"getComponentByName\" create object error!, please check control: "..tostring(ename))
|
|
return nil
|
|
else
|
|
self.obj = obj
|
|
end
|
|
|
|
return self
|
|
end
|
|
|
|
|
|
-- 根据路径获取文件名称和类型
|
|
local function lua_get_file_name_and_type(path)
|
|
local file_name = ""
|
|
local file_type = ""
|
|
|
|
-- 获取文件完整名称
|
|
local file = path:match(".+/([^/]*%.%w+)$")
|
|
|
|
-- 去除文件扩展名
|
|
local idx = file:match(".+()%.%w+$")
|
|
if (idx) then
|
|
file_name = file:sub(1, idx - 1)
|
|
else
|
|
file_name = file
|
|
end
|
|
|
|
-- 获取文件扩展名
|
|
file_type = path:match(".+%.(%w+)$")
|
|
-- print(file, idx, file_name, file_type)
|
|
return file_name, file_type
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:dynamicUILoading(ui_table) 动态加载UI页面
|
|
@apiName dynamicUILoading()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 动态加载UI页面，主要用于跨工程页面的加载，入设置界面，消息界面等
|
|
|
|
@apiParam {table{tab_file, page_id, layout_id, parent_id}} ui_table 待加载的页面信息，使用table形式
|
|
|
|
@apiParamExample 示例:
|
|
暂空
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
暂空
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
暂空
|
|
]]
|
|
function gui:dynamicUILoading(ui_table)
|
|
-- 参数检查
|
|
if (not log:checkArgType("dynamicUILoading", 1, ui_table, "table")) then
|
|
return
|
|
end
|
|
|
|
-- table里面的参数检查
|
|
if (not log:checkArgType("dynamicUILoading", "tab_file", ui_table.tab_file, "string")) then
|
|
return
|
|
end
|
|
if (not log:checkArgType("dynamicUILoading", "page_id", ui_table.page_id, "number")) then
|
|
return
|
|
end
|
|
if (not log:checkArgType("dynamicUILoading", "layout_id", ui_table.layout_id, "number")) then
|
|
return
|
|
end
|
|
if (not log:checkArgType("dynamicUILoading", "parent_id", ui_table.parent_id, "number")) then
|
|
return
|
|
end
|
|
|
|
log:d(ui_table.tab_file)
|
|
-- 解析路径，确定使用的是什么工程
|
|
local file_name, file_type = lua_get_file_name_and_type(ui_table.tab_file)
|
|
|
|
-- 获取当前页面id
|
|
local id = ui:getCurrPageID()
|
|
local current_page = utils:tranHexAddrToControlID(id).pageid
|
|
|
|
-- 获取目标页面id
|
|
id = ui_table.page_id
|
|
local target_page = utils:tranHexAddrToControlID(id).pageid
|
|
|
|
-- 根据文件名称找到对应工程加载页面替换
|
|
if (file_name == "sidebar") then
|
|
ui:replaceProjectPage(gui.project_list.sidebar_interface, target_page, current_page)
|
|
ui:switchPage(0)
|
|
elseif (file_name == "update") then
|
|
ui:replaceProjectPage(gui.project_list.mode_interface, target_page, current_page)
|
|
ui:switchPage(0)
|
|
-- elseif (file_name == "dial") then
|
|
-- ui:replaceProjectPage(gui.project_list.sidebar_interface, target_page, current_page)
|
|
-- ui:switchPage(0)
|
|
else
|
|
log_e("dynamicUILoading", "unknow project path: "..ui_table.tab_file)
|
|
end
|
|
|
|
self.loadLayout = ui_table.layout_id
|
|
self.loadPage = target_page
|
|
self.currPage = current_page
|
|
end
|
|
|
|
|
|
|
|
--[[
|
|
@api {SET} gui:dynamicUIRealese(layout_id) 释放动态页面
|
|
@apiName dynamicUIRealese()
|
|
@apiGroup GuiGroup
|
|
@apiVersion 1.0.0
|
|
@apiDescription 释放动态加载的页面
|
|
|
|
@apiParamExample 示例:
|
|
暂空
|
|
|
|
@apiSuccessExample {number} 成功响应:
|
|
暂空
|
|
|
|
@apiErrorExample {number} 失败响应:
|
|
暂空
|
|
]]
|
|
function gui:dynamicUIRealese(layout_id)
|
|
if (not log:checkArgType("dynamicUIRealese", 1, layout_id, "number")) then
|
|
return
|
|
end
|
|
if (layout_id ~= self.loadLayout) then
|
|
log_e("dynamicUIRealese", "release layout: "..tostring(layout_id).." is not dyanmic load layout: "..tostring(self.loadLayout))
|
|
return
|
|
end
|
|
-- print(self.currPage, self.loadPage)
|
|
|
|
-- 用页面动态加载的方法，把原本的页面加载回来来实现页面释放的模拟效果
|
|
ui:replaceProjectPage(gui.project_list.mode_interface, self.currPage, self.currPage)
|
|
ui:switchPage(0)
|
|
-- log:emptyFunction("dynamicUIRealese")
|
|
end
|
|
|
|
|
|
|
|
|
|
return gui
|
|
|