/*
*helloworld.c 的开始所包括的四个头文件<minigui/common.h>、<minigui/minigui.h>、
*<minigui/gdi.h> 和 <minigui/window.h> 是所有的MiniGUI 应用程序都必须包括的头文件：
*/
#include <stdio.h>
#include <minigui/common.h>//包括MiniGUI 常用的宏以及数据类型的定义。
#include <minigui/minigui.h>//包含了全局的和通用的接口函数以及某些杂项函数的定义。
#include <minigui/gdi.h>//包含了 MiniGUI 绘图函数的接口定义。
#include <minigui/window.h>//包含了窗口有关的宏、数据类型、数据结构定义以及函数接口声明。
//使用预定义控件的MiniGUI 应用程序还必须包括另外一个头文件— —<minigui/control.h>：
//control.h 包含了 libminigui 中所有内建控件的接口定义。
/*
*在helloworld.c 程序中，窗口过程是名为HelloWinProc 的函数。窗口过程函数可以由程序员任意命名，
*CreateMainWindow 函数根据MAINWINCREATE 结构类型的参数中指定的窗口过程创建主窗口。
*窗口过程的4 个参数与MSG 结构的前四个域是相同的。
*第一个参数hWnd 是接收消息的窗口的句柄，它与CreateMainWindow 函数的返回值相同，
*该值标识了接收该消息的特定窗口。
*第二个参数与MSG 结构中的message 域相同，它是一个标识窗口所收到消息的整数值。
*最后两个参数都是32 位的消息参数，它提供和消息相关的特定信息。
*/
static int HelloWinProc(HWND hWnd, int message, WPARAM wParam, LPARAM lParam)
{
HDC hdc;
switch (message) {
case MSG_PAINT:
hdc = BeginPaint (hWnd);
TextOut (hdc, 60, 60, "Hello world!");
EndPaint (hWnd, hdc);
return 0;
case MSG_CLOSE:
DestroyMainWindow (hWnd);
PostQuitMessage (hWnd);
return 0;
}
return DefaultMainWinProc(hWnd, message, wParam, lParam);
}
/*MiniGUI 程序的入口点为MiniGUIMain
*参数argc 和argv 与C 程序main
*函数的参数argc 和argv 的含义是一样的，分别为命令行参数个数和参数字符串数组指针。
*/
int MiniGUIMain (int argc, const char* argv[])
{
MSG Msg;//消息数据结构体文章末尾给出
HWND hMainWnd;//窗口句柄
MAINWINCREATE CreateInfo;//窗口结构体，绘图等用到
#ifdef _MGRM_PROCESSES//JoinLayer 是MiniGUI-Processes 模式的专有函数，因此包含在 _MGRM_PROCESSES
JoinLayer(NAME_DEF_LAYER , "helloworld" , 0 , 0);//的条件编译中。在 MiniGUI-Processes 运行模式下，每个MiniGUI 客户端程序在调用其它
#endif//MiniGUI 函数之前必须调用该函数将自己添加到一个层中（或创建一个新层）
/*
如果程序是 MiniGUI-Processes 服务器端，你应该改为调用 ServerStartup：
if (!ServerStartup (0 , 0 , 0)) {
fprintf (stderr,
"Can not start the server of MiniGUI-Processes: mginit.\n");
return 1;
}
*/
CreateInfo.dwStyle = WS_VISIBLE | WS_BORDER | WS_CAPTION;//设置主窗口风格，这里把窗口设为初始可见的，并具有边框和标题栏。
CreateInfo.dwExStyle = WS_EX_NONE;//设置主窗口的扩展风格，该窗口没有扩展风格
CreateInfo.spCaption = "HelloWorld";//设置主窗口的标题为“HelloWorld”。
CreateInfo.hMenu = 0;//设置主窗口的主菜单，该窗口没有主菜单
CreateInfo.hCursor = GetSystemCursor(0);//设置主窗口的光标为系统缺省光标。
CreateInfo.hIcon = 0;//设置主窗口的图标，该窗口没有图标。
CreateInfo.MainWindowProc = HelloWinProc;//设置主窗口的窗口过程函数为HelloWinProc，所有发往该窗口的消息由该函数处理。
/*设置主窗口在屏幕上的位置，该窗口左上角位于(0, 0)，右下角位于(320, 240)。*/
CreateInfo.lx = 0;
CreateInfo.ty = 0;
CreateInfo.rx = 240;
CreateInfo.by = 180;
CreateInfo.iBkColor = COLOR_lightwhite;//设置主窗口的背景色为白色，PIXEL_lightwhite 是MiniGUI 预定义的象素值。
CreateInfo.dwAddData = 0;//设置主窗口的附加数据，该窗口没有附加数据。
CreateInfo.hHosting = HWND_DESKTOP;//设置主窗口的托管窗口为桌面窗口
hMainWnd = CreateMainWindow (&CreateInfo);//创建和显示主窗口
if (hMainWnd == HWND_INVALID)//判读窗口句柄是否为有效的句柄
return -1;
/*ShowWindow的第一个参数为所要显示的窗口句柄，第二个参数指明显示窗口的方式（显示还是隐藏）SW_SHOWNORMAL说明要显示主窗口，并把它置为顶层窗口。
调用ShowWindow 函数才能把所创建的窗口显示在屏幕上。*/
ShowWindow(hMainWnd, SW_SHOWNORMAL);
while (GetMessage(&Msg, hMainWnd)) {//在调用ShowWindow 函数之后，主窗口就会显示在屏幕上。和其它GUI 一样，现在是
TranslateMessage(&Msg);//进入消息循环的时候了。MiniGUI 为每一个MiniGUI 程序维护一个消息队列。在发生事件之
DispatchMessage(&Msg);//后，MiniGUI 将事件转换为一个消息，并将消息放入目标程序的消息队列之中。应用程序现
}//在的任务就是执行如下的消息循环代码，不断地从消息队列中取出消息，进行处理：
/*
1.Msg 变量是类型为MSG 的结构，MSG 结构在window.h 中定义如下：
typedef struct _MSG
{
HWND hwnd;
int message;
WPARAM wParam;
LPARAM lParam;
unsigned int time;
#ifndef _LITE_VERSION
void* pAdd;
#endif
} MSG;
typedef MSG* PMSG;
2.GetMessage 函数调用从应用程序的消息队列中取出一个消息：
GetMessage( &Msg, hMainWnd);
该函数调用的第二个参数为要获取消息的主窗口的句柄，第一个参数为一个指向MSG
结构的指针，GetMessage 函数将用从消息队列中取出的消息来填充该消息结构的各个域
3.只要从消息队列中取出的消息不为MSG_QUIT，GetMessage 就返回一个非0 值，消息
循环将持续下去。MSG_QUIT 消息使GetMessage 返回0，导致消息循环的终止。
TranslateMessage (&Msg);
4.TranslateMessage 函数把击键消息转换为MSG_CHAR 消息，然后直接发送到窗口过程函数。
DispatchMessage (&Msg);
DispatchMessage 函数最终将把消息发往该消息的目标窗口的窗口过程，让它进行处理，
*/
/*程序退出
用户单击窗口右上角的关闭按钮时窗口过程函数将收到一个MSG_CLOSE 消息。
helloworld 程序在收到MSG_CLOSE 消息时调用DestroyMainWindow 函数销毁主窗口，并
调用PostQuitMessage 函数在消息队列中投入一个MSG_QUIT 消息。当GetMessage 函数
取出MSG_QUIT 消息时将返回0，最终导致程序退出消息循环。
程序最后调用MainWindowThreadCleanup 清除主窗口所使用的消息队列等系统资源并
最终由MiniGUIMain 返回。
*/
MainWindowThreadCleanup (hMainWnd);
return 0;
}
#ifndef _MGRM_PROCESSES
#include <minigui/dti.c>
#endif