MSTAR GUI

1、架构 WIN32 SDK

　　ACT->CTL->API->GE/GOP

　　

　　ACT: Customized logic parts

　　CTL: Behavior widgets

　　API: UI API

2、调 用

　　

　　

　　非UI操作UI的两种方式：

　　　　1）MApp_ZUI_ProcessKey(U8 u8IRKey)　　2) Execute Action

3、Features & Behavior

　　HWND 行为：

　　

　　WINDOW ACT窗口API调用:

　　　　如为某一个窗口增加TIMER

　　

　　WINDOW CTL部件API调用:

　　每个CTL都有一个WinProc函数，通过MSG调用

　　

　　SKINTOOLS 默认的Default Window Procedure Behavior及默认行为:

　　

　　如果系统默认的Procedure不能满足需求，要手动定义WNDPROC：

　　

　　事件驱动方式：

　　通过MSG导入到相应窗口的WINPROG

　　

　　UI开发流程：

　　两类档案：1、BIN档，直接链接使用   2、INL档案，MSTAR_XXX_tables_c.inl  部分可修改

　　

4、SkinTool注意事项

　　1) 第一次载入MSTAR.xml，IMAGE需要重新设定路径：

　　　　选中某一个图片，可以单独设置ColorKey，SHIFT多选图片设置属性

　　

　　2) 窗口的新建一般使用Button

　　

　　3）UI SIZE使用不同屏，可以快速调整UI X/Y/W/H适应不同分辨率的屏

　　　　Tools->Stretch System Panel

　　　　

5、OSD PAGE FUNCTION

　　MApp_ZUI_APIwindow.c()  UI资源设置：

　　

　　全局API

　　1) MApp_ZUI_Main.c

　　　　非UI处理UI接口，包含“MApp_ZUI_Main.h”

　　　　MApp_ZUI_Init()

　　　　MApp_ZUI_MainTask()　　　　　　　　　　　　//消息分发及定时器处理

　　　　MApp_ZUI_ProcessKey()                           　　//非UI处理UI接口    

　　　　MApp_ZUI_ACT_ExecuteWndAction()              //非UI处理UI接口

　　　　MApp_ZUI_GetActiveOSD()

　　　　MApp_ZUI_GetPreviousOSD()

　　　　MApp_ZUI_ACT_StartupOSD()

　　　　MApp_ZUI_ACT_ShutdownOSD()

　　2) MApp_ZUI_APIwindow.c()/MApp_ZUI_APIwindow.h()

　　　　MApp_ZUI_API_GetMessage()

　　　　MApp_ZUI_API_PostMessage()

　　　　MApp_ZUI_API_SendMessage()

　　　　MApp_ZUI_API_ShowWindow()

　　　　MApp_ZUI_API_InvalidateRect()

　　　　MApp_ZUI_API_GetWindowData()    

　　　　MApp_ZUI_API_MoveWindow()

　　　　MApp_ZUI_API_GetWindowRect()

　　　　MApp_ZUI_API_SetTimer()         

　　　　MApp_ZUI_API_KillTimer()

　　　　MApp_ZUI_API_GetFocus()

　　　　MApp_ZUI_API_SetFocus()

　　　　MApp_ZUI_ACT_HandleGlobalKey()   

　　　　MApp_ZUI_ACT_ExecuteWndProc()   

　　3) 客制化：ACT PAGE

　　　　注意“MApp_ZUI_ACT_HandleKey_XXX()”  return FALS/TRUE的区别

　　　　　　“return TRUE” 表示接收后，不继续处理，“return FALSE”会继续处理

　　　　MApp_ZUI_ACT_AppShow_XXX()

　　　　MApp_ZUI_ACT_HandleKey_XXX()

　　　　MApp_ZUI_ACT_ExecuteAction_XXX()　　　　　　  //UI<->UI     非UI->UI操作

　　　　App_ZUI_ACT_GetDynamicText_XXX()　　　　　　//动态字串

　　　　MApp_ZUI_ACT_GetDynamicBmp_XXX()　　　　　//动态BITMAP

　　　　MApp_ZUI_ACT_Terminate_XXX()

　　4、资源绑定ACTION

　　　　绑定行为、参数传递及按键导航

　　　　MSTAR_XXX_tables_c.inl

　　　　

　　　　例如：

　　　　　　1) WIND 类别ID  代表MAP到不同的window proc

　　　　　　　　“EN_ZUI_DEFAULTWINPROC”代表的SkinTool默认的行为，即绘制页面的基本长相/查询“Keymap_Table”并导入相应的ACTION/导航操作等。

　　　　　　　　其它的类别，会在MApp_ZUI_ACTglobal.c->MApp_ZUI_ACT_ExecuteWndProc()导入到相应的WIN PROG

　　　　　　　　如：“EN_ZUI_DYNAMICTEXT_WINPROC” 会导入到MApp_ZUI_CTLdynatext.c->MApp_ZUI_ACT_DynamicTextWinProc()中

　　　　　　　　的MApp_ZUI_ACT_GetDynamicText(hWnd)最终会获取具体客制化ACT的字串内容进行显示刷新。

　　　　　　2) UI控件参数设定，如：EN_MSTAR_AUTOCLOSE_WINPROC 需要的参数 为100

　　　　　　3) UI控件状态

　　　　　　4) 导航设置

　　　　　　5) 键行为映射

　　　　　　1/2/5三个栏位是可手动修改的，SkinTools BUILD的时候不会被覆盖，如果多人修改UI，合代码的时候合并：1、MSTAR.xml  2、MSTAR_XXX_tables_c.inl的键绑定及1/2/5栏位。

　　　　

　　　　其它资源枚举：

　　　　　　MSTAR_wndproc_h.inl

　　　　　　MSTAR_strings_enum.h

　　　　　　MSTAR_bitmap_EnumIndex.h

　　　　　　MSTAR_components_h.inl

　　　　　　ZUI_exefunc.h　　　　　　　　　　　　//所有UI和逻辑切割的ACTION

　　　　导入到相应PAGE，分配中枢：

　　　　　　MApp_ZUI_ACTglobal.c

　　　　　　MApp_ZUI_ACT_StartupOSD()

　　　　　　MApp_ZUI_ACT_HandleGlobalKey()

　　　　　　MApp_ZUI_ACT_ExecuteWndAction()

　　　　　　MApp_ZUI_ACT_ExecuteWndProc()

　　　　　　MApp_ZUI_ACT_PostMessageFilter()

　　　　隐藏整个菜单：

　　　　　　1）HIDE MAINFRAME

　　　　　　2）SHOW MENU_XXX_BACKGROUND

　　　　　　

6、默认菜单行为：MApp_ZUI_APIcontrols.c

　　MApp_ZUI_API_DefaultWindowProc()

　　主要工作是：重绘/按键导入

　　

 

7、其它：

　　关联重绘：

　　　　如，蓝色A部件重绘时，棕色矩形B部件也会重绘，原因是A部件坐标与B部件坐标部分重叠，导致重绘A的同事B部件也会被重绘。