Minigui教程1

Minigui 教程

前言

本文档内容意在带您快速了解 minigui 相关内容，您无需深究 code 也能够

迅速了解各接口的使用逻辑。其余具体内容则需要您在后续工作中逐步体会。文

档内容大致分为 minigui 简易架构介绍、常用功能接口、离线语音项目中的 GUI

框架和逻辑。

一、搭建工作环境

本内容请移步指相应的介绍文档，如 ministudio 的安装、使用等。目前相

应内容放在个人 Nas 盘中。如图：

（doc/articles）。

* etc

MiniGUI 的配置文件。目前有用于两个风格的配置文件。

* examples

Doxygen 使用的一些示例代码片段。出现在最终的 API 参考手册中。

* ext

MiniGUIExt 库的源代码

* ext/control：MonthCalendar、SpinBox、CoolBar、ListView、TreeView 等控

件。

* ext/image：动画 GIF 格式支持代码。

* mywindows

MyWins 库的源代码

* src

MiniGUI 库的源代码

* src/client：MiniGUI-Lite 版本的客户端特有源代码。

* src/control：MiniGUI 内建控件（static、button、listbox、edit 等等）。

* src/font：设备字体实现（RBF、VBF、TrueType、Type1 字体等）。

* src/font/in-core：嵌入代码的字体。

* src/gal：老的 GAL 引擎。

* src/gal/native：老的 FrameBuffer GAL 引擎。

* src/include：库的内部头文件。

* src/include/control：控件相关的内部头文件。

* src/kernel：窗口管理、共享资源管理等的源代码。

* src/main：对 main 函数的封装。

* src/misc：杂项实现：配置文件读写、套接字操作、定点数学函数、通用流函

数、绘图同步等等。

* src/mybmp：各种图片格式的支持，包括 GIF、JPG、PNG、BMP 等等。

* src/newgal：新的 GAL 引擎。

* src/newgal/fbcon：基于 FrameBuffer 的新 GAL 引擎。

* src/newgal/dummy：哑 GAL 引擎。

* src/newgal/qvfb：基于 QVFB 的新 GAL 引擎。

http://www.doc88.com/p-786671878309.html

https://blog.csdn.net/doon/article/details/7091379

https://blog.csdn.net/10km/article/details/83550368

非常有用，包含很多知识点：

https://so.csdn.net/so/search?q=MiniGUI&t=blog&u=anyuliuxing&urw=

https://blog.csdn.net/anyuliuxing/article/details/90239014

其 次 ， 对 于 您 最 初 的 界 面 设 计 工 作 ， 您 应 该 重 点 关 注

<window.h> ,<static.h>,<common.h>这几个文件的内容。同时：static.h 只是 static 类

控件的头文件，您如果使用了其他类型控件，就去找相应类型名字的 .h 即可。

三、项目中 GUI 内容的介绍

SDK\minigui-3.2-20210521\src\newgdi

SDK\minigui-3.2-20210521\include

1、菜单的基础框架（IRadio 为例，其余类似）

各界面才去统一的设计逻辑：每个菜单均对应一个.c/h 文件，文件名为他们

的各自的界面功能。（如 Minigui_App_InternetRadio.c 等）。

其中.c 文件的基本框架为：

1）Create_Minigui_IRadioWnd

2）ntCreateIradiomenuEx

3）Iradiomenu_onCreate

4）Iradiomenu_onKeyUp

1、Create_Minigui_IRadioWnd

这里对 ntCreateIradiomenuEx 接口的一个简单封装，因为你可能在创建洁面时

需要依据不同的状态来确定这个界面最开始是什么样的，那么你就可以使用这种

接口，并且日后在你新增的界面中，也建议使用这种逻辑。

2、ntCreateIradiomenuEx

3、Iradiomenu_onCreate

4、Iradiomenu_onKeyUp

5、IRadioWinProc

这几个接口都是通过 ministudio 生成的（其实在你熟悉之后，你可以自己手动

添加而脱离工具），他们的功能就是注册并初始化界面、创建界面、界面按键消

1）CreateWindow

这个接口可以创建控件和窗口，所以你需要熟悉这个接口内部的参数含义。

举个栗子：

Control_test =

CreateWindow(

CTRL_STATIC,

NULL,

WS_CHILD|WS_VISIBLE| SS_HOFFSET_VCENTER,

ID_AIRABLE_IRADIO_TEXT1,

0, 1, 320, 33,

SetWindowBkColor(Control_test,MGUI_NICENT_COLOR_BLACK);

这里将上述刚刚创建的 Control_test 控件设置一个黑色的背景。

SetWindowElementAttr(Control_test,WE_FGC_WINDOW,MGUI_NICENT_COLOR_WHITE);

这里将上述刚刚创建的 Control_test 控件设置一个白色的字体色[前景色]

3）Nicent_SetWindowFont_Not_Refresh 和 SetWindowFont

用来设置窗口、控件的字体风格。当然你的确认你使用的字体是已经被创建

的。

请注意 Nicent_SetWindowFont_Not_Refresh 是属于我们自己拓展的接口，

也建议你使用这个接口。使用 SetWindowFont 可能导致你的界面在你不需要刷新

的时候进行了刷新的动作。（刷新机制与消息机制有关，可以大概参考下面介绍