一、NC 消息

Size: px

Start display at page:

Download "一、NC 消息"

付濮
6 years ago
Views:

1 MiniGUI 特性说明书本文档说明 MiniGUI 所支持的功能特性一概述 MiniGUI 是 Linux 控制台上运行的, 基于 SVGALib 和 LinuxThread 库的多窗口图形用户界面支持系统 MiniGUI 采用了类 Win32 的 API 接口, 实现了简化的类 Windows 98 风格的图形用户界面图形用户界面在许多情况下都优于字符界面, 其最大的优点是使应用程序的操作简单易学在 MiniGUI 中, 图形用户界面包括如下基本元素 : 主窗口窗口非客户区窗口标题窗口边框菜单栏窗口客户区子窗口 ( 窗片或控件 ) 对话框对话框控件图 1.1 图形用户界面的基本元素 1.1 窗口 MiniGUI 中的窗口基本分四类, 分别为主窗口对话框控件和主窗口中的窗片 MiniGUI 中的主窗口和 Windows 应用程序的主窗口概念类似, 但略微有些不同, MiniGUI 中的每个主窗口对应于一个单独的线程, 通过函数调用可建立主窗口以及对应的线程每个线程有一个消息队列, 主窗口从这一消息队列中获取消息并由窗口过程 ( 回调函数 ) 进行处理 MiniGUI 中的对话框是一种特殊的窗口, 对话框一般和控件一起使用, 这两个概念和 Windows 的相关概念是类似的 MiniGUI 支持的控件类型有 : 静态框 : 文本图标或矩形框等这种控件的属性一般不会在运行时发生变化文本框 : 单行或多行的文本编辑框按钮 : 单选钮复选框和一般按钮等其他特殊控件窗片是 MiniGUI 所特有的, 窗片实际是主窗口的子窗口, 只存在于主窗口中为了

2 处理上的方便, 主窗口的子窗口只以平铺的形式出现, 因此我们将这种子窗口称为窗片或窗格窗片可以是私有的控件类型, 也可以是标准的控件类型 1.2 消息和消息循环在 Windows 系列操作系统中, 广泛使用了消息驱动的概念在 MiniGUI 中, 我们也使用了消息驱动作为应用程序的创建构架在消息驱动的应用程序中, 计算机外设发生的事件, 例如键盘键的敲击鼠标键的按击等, 都由支持系统收集, 将其以事先的约定格式翻译为特定的消息应用程序一般包含有自己的消息队列, 系统将消息发送到应用程序的消息队列中应用程序可以建立一个循环, 在这个循环中读取消息并处理消息, 一直处理到特定的消息传来为止这样的循环称为消息循环一般地, 消息由代表消息的一个整型数和消息的附加参数组成例如, 鼠标左键的按下消息, 可能由 133 这个数来表示, 其附加参数可能包含按下时的鼠标所在位置信息例如,MiniGUI 中如下定义消息 : typedef struct { HWND hwnd; int message; WPARAM wparam; LPARAM lparam;... MSG; message 指定了特定的消息类型,wParam 是以 unsigned int 类型定义的消息的短参数, lparam 是以 long 类型定义的消息长参数应用程序一般要提供一个处理消息的标准函数在消息循环中, 系统可以调用此函数, 应用程序在此函数中处理相应消息图 1.2 是一个消息驱动的应用程序的简单构架示意外设事件主窗口线程消息队列消息循环窗口过程窗口管理器主窗口线程消息队列主窗口线程消息队列图 1.2 消息驱动的应用程序的简单构架在 MiniGUI 中, 消息分为如下几种类型 : 系统消息, 为系统内部管理使用鼠标消息, 鼠标的点击移动等产生的消息键盘消息, 键盘的按键消息窗口消息, 窗口管理消息菜单消息, 菜单管理消息

3 命令消息等 1.3 窗口过程和窗口类窗口过程是用来处理窗口消息的函数过程对于同一类型的控件, 其窗口过程一般是一样的因此, 系统一般利用窗口的窗口类名来区分不同的窗口类并调用不同的窗口过程由于几乎每一个主窗口均和其他窗口有着不同的窗口过程, 因此, 在 MiniGUI 中, 窗口类的概念只存在于控件和窗片中对于主窗口来说, 其窗口过程在建立主窗口时指定, 而对控件和窗片来说, 则在注册窗口类时指定, 而在建立窗片或控件时指定所属窗口类 1.4 句柄句柄是 MiniGUI 用来标识对象的标识符句柄和指针概念类似, 但它不一定是指针值利用句柄,MiniGUI 将系统变量从应用项目中分离了出来, 因为程序员只能通过句柄访问对象, 因而就没有利用指针是可能发生的因非法访问而导致的数据不一致问题在 MiniGUI 中, 窗口控件设备环境菜单图标等均使用句柄访问二窗口 2.1 应用程序和主窗口我们将基于 MiniGUI 的一个会话 (session) 称为一个应用项目, 而其中每个单独的线程或线程组称为应用每个应用项目可建立多个应用主窗口是建立在 MiniGUI 基础上的应用的主界面 MiniGUI 为每个主窗口建立单独的消息队列, 在该主窗口基础上派生出的窗片对话框及其控件均使用同一消息队列在 MiniGUI 中, 每个应用对应于一个线程理论上讲, 每个应用可以具备多个主窗口, 但在 MiniGUI 中, 主窗口均以单独的线程实现但多个主窗口对应单一线程的情况也是可以在 MiniGUI 中实现的每个应用项目有一个 MiniGUIMain 函数, 在这个函数中, 可建立初始的应用线程在调用 MiniGUIMain 之前, MiniGUI 启动自己的桌面窗口 ( Desktop) 桌面窗口作为 MiniGUI 的窗口管理器而存在下面的代码段在 MiniGUIMain 中启动了三个主窗口线程 : int MiniGUIMain(int args, char* arg[]) { pthread_t thread, thread2, thread3; CreateThreadForMainWindow(&thread, NULL, TestWindowMain, 0); CreateThreadForMainWindow(&thread2, NULL, TestWindowMain2, 0); CreateThreadForMainWindow(&thread3, NULL, TestWindowMain3, 0); return 0; CreateThreadForMainWindow 函数为主窗口建立线程, 并返回线程标识符其中的第三个参数是线程的入口函数地址如下的代码段定义了上述代码中第一个主窗口线程的入口函数 :

4 void InitCreateInfo(PMAINWINCREATE pcreateinfo) { pcreateinfo->dwstyle = WS_THICKFRAME; pcreateinfo->spcaption = "The first main window" ; pcreateinfo->hmenu = 0; pcreateinfo->hcursor = GetSystemCursor(2); pcreateinfo->hicon = LoadIconFromFile("res/table.ico"); pcreateinfo->mainwindowproc = TestMainWinProc; pcreateinfo->lx = 50; pcreateinfo->ty = 50; pcreateinfo->rx = 300; pcreateinfo->by = 480; pcreateinfo->ibkcolor = COLOR_lightwhite; pcreateinfo->dwadddata1 = 0; pcreateinfo->dwadddata2 = 0; void* TestWindowMain(void* { MSG Msg; data) MAINWINCREATE CreateInfo; HWND hmainwnd; InitCreateInfo(&CreateInfo); if(!(hmainwnd = CreateMainWindow(&CreateInfo)) ) return NULL; ShowWindow(hMainWnd, SW_SHOWNORMAL); while( GetMessage(&Msg, hmainwnd) ) { DispatchMessage(&Msg); MainWindowThreadCleanup(hMainWnd); return NULL; 在上面的代码段中, 该线程首先调用 CreateMainWindow 建立了主窗口, 然后调用 ShowWindow 显示了主窗口, 最后启动了消息循环当消息循环因为接收到 MSG_QUIT 消息而终止时, 该函数调用了 MainWindowThreadCleanup 清除了相关的线程数据从上述代码中可看出主函数不支持窗口类, 在调用 CreateMainWindow 函数时直接指定主窗口的窗口过程地址我们也可以从中看到主窗口所支持的其他属性 : 1. 窗口风格表 2.1 给出了所支持的窗口风格表 2.1 MiniGUI 支持的主窗口风格风格 WS_BORDER WS_THICKFRAME WS_THINFRAME WS_CAPTION WS_HSCROLL WS_MAXMIZEBOX WS_MINIMIZEBOX WS_SYSMENU WS_VSCROLL 描述创建一个具有单线边框的窗口创建一个具有宽边框的窗口创建一个具有细边框的窗口创建一个具有标题栏的窗口创建一个具有水平滚动条的窗口创建一个具有最大化框的窗口创建一个具有最小化框的窗口创建一个具有系统菜单的窗口创建一个具有垂直滚动条的窗口

5 WS_DISABLED WS_MAXIMIZE WS_MINIMIZE WS_VISIBLE WS_EX_TOPMOST 2. 窗口标题 3. 窗口菜单 4. 窗口图标 5. 窗口背景色创建一个初始为禁止的窗口创建一个初始最大化的窗口创建一个初始最小化的窗口创建一个初始可见的窗口创建一个顶层窗口, 这是一个 Win32 的扩展风格 2.2 主窗口过程主窗口过程实际是一个回调函数, 一般由 DispatchMessage 函数调用, 用来处理应用的消息主窗口过程一般如下定义 : int TestMainWinProc(HWND hwnd, int message, WPARAM wparam, LPARAM lparam) { HDC hdc; int x, y; RECT client; static BITMAP bitmap; static BOOL fvalid = FALSE; static int paintcount = 0; switch (message) { case MSG_CREATE: SetTimer (hwnd, 100, 20); if(loadbitmap(&bitmap, "res/mnls.bmp") < 0) fprintf (stderr, "Test Main Win: Loading bitmap failure!\n"); else fvalid = TRUE; case MSG_PAINT: hdc = BeginPaint (hwnd); testdc (hdc, fvalid?&bitmap:null); EndPaint (hwnd, hdc); case MSG_LBUTTONDBLCLK: hdc = GetClientDC (hwnd); TextOut(hdc, 0, 0, "Left button double clicked"); ReleaseDC (hdc); PostMessage (hwnd, MSG_CLOSE, 0, 0); return 0; case MSG_TIMER: if (ISINBACKGROUND) paintcount++; if (paintcount % 10!= 0) { hdc = GetClientDC (hwnd); GetClientRect (hwnd, &client); x = random() % (RECTW (client)); y = random() % (RECTH (client)); SetBrushColor(hdc, RGB2Index (hdc, random() % 256, random() % 256, random() % 256)); FillBox(hdc, x, y, random() % RECTW (client), random() % RECTH (client));

6 ReleaseDC (hdc); else InvalidateRect (hwnd, NULL, FALSE); case MSG_CLOSE: KillTimer (hwnd, 100); UnloadBitmap (&bitmap); DestroyMainWindow (hwnd); PostQuitMessage (hwnd); return 0; return DefaultMainWinProc(hWnd, message, wparam, lparam); 主窗口有四个入口参数, 分别是消息的目标窗口句柄消息消息的 WPARAM ( 即 unsigned int) 型参数和 LPARAM ( 即 long int) 型参数在 32 位系统中, 消息的两个参数实际是等长度的主窗口的窗口过程处理应用感兴趣的消息, 将其他消息传递给 DefaultMainWindProc 函数处理 2.3 桌面的应用项目接口当用户在桌面上单击鼠标右键时可弹出浮动式菜单, 应用项目可通过桌面提供的接口在该菜单中添加菜单项, 从而提供一定的灵活性要利用桌面的应用项目接口, 应用项目要实施两个函数 : void Customi ze D e sktopmenu (HMENU hmnu, int ipos); int CustomDesktopCommand (int id); 通过 CustomizeDesktopMenu 函数, 应用项目可在桌面的浮动式菜单中添加菜单及菜单项当用户选择了定制的菜单项时,MiniGUI 将调用 CustomDesktopCommand 函数, 这时, 应用项目就可以处理该菜单命令 2.4 对话框和控件对话框实际是一种特殊的主窗口一般而言, 对话框中包含有许多系统提供的控件对话框和控件的设计目标是提供和 Win32 在源代码级上的完全兼容但某些复杂的控件不打算支持, 对话框页也不支持 MiniGUI 支持的控件有 : 静态控件按钮控件编辑控件列表控件滚动条控件组合框控件同时,MiniGUI 将提供标准的公共对话框 : 文件打开对话框文件保存对话框

7 2.6 消息框 MiniGUI 将提供和 Win32 完全兼容的消息框调用接口 2.6 窗片窗片是主窗口中子窗口的简化支持, 为了避免子窗口之间的互相剪切, 而采用了平铺式的子窗口实现, 不考虑子窗口的互相剪切, 因而也就不提供多文档接口也因为这个原因, 我们将这种子窗口称为窗片或窗格窗片的建立和控件的建立方法一致 2.7 滚动支持将提供和 Win32 完全兼容的主窗口或子窗口的滚动支持三对话框窗片和控件该部分功能尚未实现, 其目标是提供和 WIN32 的 80% 兼容需要提供的接口分为如下几类 ( 注, 我们将窗片和控件统称为窗口, 并严格区分主窗口和窗口这两个名词 ): 窗口类的注册和注销窗口的创建和销毁对话框和控件管理常见控件消息操作接口等的实现四消息及消息队列在 MiniGUI 中, 基本实现了 Win32 的消息处理函数消息可通过如下函数发送 : 通过 PostMessage 发送消息发送到消息队列后立即返回这种发送方式称为邮寄消息如果消息队列中的邮寄消息缓冲区满, 则该函数返回错误值通过 PostSyncMessage 发送该函数用来向不同于调用该函数的线程消息队列邮寄消息, 并且只有该消息被处理之后, 该函数才能返回, 因此这种消息称为同步消息通过 SendMessage 发送该函数可以向任意一个窗口发送消息, 消息处理完成之后, 该函数返回如果目标窗口所在线程和调用线程是同一个线程, 该函数直接调用窗口过程, 如果处于不同的线程, 则利用 PostSyncMessage 函数发送同步消息通过 SendNotifyMessage 发送该函数向指定的窗口发送通知消息, 将消息放入消息队列后立即返回由于这种消息和邮寄消息不同, 是不允许丢失的, 因此, 系统以链表的形式处理这种消息通过 SendAsyncMessage 发送利用该函数发送的消息称为异步消息, 系统直接调用目标窗口的窗口过程

8 五图形设备接口图形设备接口, 即 GDI, MiniGUI 中用来实现图形输出的模块 5.1 基本概念图形设备在 MiniGUI 中, 采用了在 Windows 和 X Window 中普遍采用的图形设备概念每个图形设备定义了计算机显示屏幕上的一个矩形输出区域在调用图形输出函数时, 均要求指定经初始化, 或经建立的图形设备上下文, 或设备环境 (DC) 每个图形输出均局限在图形设备指定的矩形区域内在多窗口系统中, 各个图形设备之间的输出互相剪切, 以避免图形输出之间互相影响剪切域剪切域就是在图形设备上定义的一个区域, 所有在该图形设备上进行的图形输出, 超过剪切域的部分, 均被裁剪只有在剪切域上的图形输出才是可见的输出 MiniGUI 中的剪切域, 定义为矩形剪切域的集合映射模式映射模式指定了特定图形输出的坐标值如何映射到图形设备的坐标值图形设备的坐标系原点定义为图形设备矩形区域的左上角向右为正 X 坐标轴方向 ; 向下为正 Y 坐标轴方向这一坐标系称为设备坐标系通过 GDI 模块的映射模式操作函数, 可定义自己的逻辑坐标系逻辑坐标系可以是设备坐标系的水平或垂直反转, 缩放, 或者偏移多数 GDI 输出函数指定的是逻辑坐标系默认情况下, 逻辑坐标系和设备坐标系是重合的 5.2 GDI 功能特性的分类说明图形设备能力通过调用函数 GetGDCapability, 可获得图形设备的如下能力 : 颜色数目 ; 水平和竖直方向的象素点数 ; 设备坐标系中可见点的最大 x 和 y 坐标值创建销毁或获取释放图形设备接口和 Win32 类似, MiniGUI 中也有一个 DC 的缓冲区, 应用可调用 GetDC 或 GetClientDC 函数从 DC 缓冲区中获取图形设备环境, 在结束使用 DC 之后, 应当调用 ReleaseDC 函数释放 DC 应用也可以建立自己私有的 DC, 这种 DC 可以是全局有效的 DC, 由于免除了获取和释放以及初始化等工作, 因此, 利用这种 DC 可加速图形显示当应用不再使用私有 DC

9 时, 应当利用 DeletePrivateDC 删除私有 DC 下面的代码即利用了这种 DC: int TestMainWinProc2(HWND hwnd, int message, WPARAM wparam, LPARAM lparam) { static HDC hdc; HDC hpaintdc; int x, y; RECT client; static int count = 0; static BITMAP bitmap; static BOOL fvalid = FALSE; static int paintcount = 0; switch (message) { case MSG_CREATE: SetTimer (hwnd, 100, 20); SetTimer (hwnd, 200, 5); if(loadbitmap(&bitmap, "res/j11b.bmp") < 0) fprintf (stderr, "Test Main Win: Loading bitmap failure!\n"); else fvalid = TRUE; case MSG_SHOWWINDOW: if (wparam == SW_SHOWNORMAL) hdc = CreatePrivateClientDC (hwnd); case MSG_PAINT: hpaintdc = BeginPaint (hwnd); testdc (hpaintdc, fvalid?&bitmap:null); EndPaint (hwnd, hpaintdc); case MSG_LBUTTONDBLCLK: return 0; case MSG_TIMER: if (ISINBACKGROUND) if (wparam == 100) { paintcount ++; if (paintcount % 10!= 0) { GetClientRect (hwnd, &client); x = random() % (RECTW (client)); y = random() % (RECTH (client)); SetPenColor(hdc, RGB2Index (hdc, random() % 256, random() % 256, random() % 256)); LineTo(hdc, x, y); else InvalidateRect else if (wparam == 200) { if (count < 5) { Ping (); count ++; else KillTimer (hwnd, 200); (hwnd, NULL, TRUE);

10 case MSG_CLOSE: KillTimer (hwnd, 100); KillTimer (hwnd, 200); UnloadBitmap (&bitmap); DeletePrivateDC (hdc); DestroyMainWindow (hwnd); PostQuitMessage (hwnd); return 0; return DefaultMainWinProc(hWnd, message, wparam, lparam); 上述代码在应用主窗口建立时创建了私有 DC, 然后在定时器消息中利用私有 DC 进行绘制, 最后在关闭窗口时删除了私有 DC MiniGUI 也支持内存中的虚拟 DC, 可通过 CreateCompatibleDC 建立内存 DC, 利用这种 DC, 可加速绘制过程, 并减少绘制过程中闪烁现象应用可使用 DeleteCompatibleDC 函数删除内存 DC 上述 DC 的创建或获取与 Win32 API 有较明显的不同一般绘制属性这类功能用来设置 DC 的绘制属性, 这些属性及其影响的绘图操作在表 5.1 中列出表 5.1 一般绘图属性绘制属性所影响的绘图操作备注背景色文本输出 GetBkColor, SetBkColor 背景模式文本输出 GetBkMode, SetBkMode 文本颜色文本输出 GetTextColor, SetTextColor 画笔类型线条输出只支持实型画笔 GetPenType, SetPenType 画笔颜色线条输出 GetPenColor, SetPenColor 画刷类型填充操作只支持实型画刷 GetBrushType, SetBrushType 画刷颜色填充操作 GetBrushColor, SetBrushColor 一般绘图支持这类功能用来完成基本的绘图功能, 这些功能包括 : 画点直线圆矩形等另外还有一些颜色转换方面的功能, 可以将特定的 RGB 转换为最接近的 256 色调色板中的颜色索引值接口函数由表 5.2 给出表 5.2 一般绘图支持函数 SetPixel SetPixelRGB GetPixel GetPixelRGB RGB2Index MoveTo, LineTo 功能说明设置指定的象素颜色, 颜色值以调色板索引给出设置指定的象素颜色, 颜色值以 RGB 值给出获取指定点的象素颜色, 以调色板索引给出获取指定点的象素颜色, 以 RGB 值给出完成 RGB 值到调色板索引值的转换绘制直线

11 Circle Rectangle 绘制圆绘制矩形文本输出支持这类功能用来利用系统字体输出文本可实现无格式文本 ( TextOut) 和有格式文本 (TabbedTextOut) 的输出作为辅助函数, 应用还可以利用 GetTabbedTextExtent 函数来获得格式化文本字符串的输出尺寸由于系统字体是等宽字体, 无格式文本的输出长度就等于单字节字符串个数乘以单个字符的宽度利用 GetCharWidth 以及 GetCCharWidth 可获取单字节字符以及双字节字符 ( 汉字 ) 的宽度 ; 利用 GetCharHeight 可获取字符的高度映射函数支持 MiniGUI 支持的映射方式有两种, 一种和 Win32 的 MM_TEXT 映射方式一样, 即设备坐标系和逻辑坐标系是一致的 ; 一种和 Win32 的 MM_ANISOTROPIC 映射方式一样, 逻辑 x 和 y 轴可以以任意的比例映射到对应的坐标轴上其他的 Win32 映射方式不被支持通过函数 SetMapMode 设定映射方式利用 SetWindowExt 和 SetViewportExt 可设置 MM_ANISOTROPIC 映射方式的坐标轴方向比例等利用 SetWindowOrg 和 SetViewPortOrg 可以设定原点位置和上述函数的对应的 Get 函数组可用来获取设定值坐标转换这类函数用来实现设备坐标到逻辑坐标的转换 DPtoLP 将设备坐标转换为逻辑坐标, LPtoDP 将逻辑坐标转换为设备坐标剪切支持这类函数用来实现对 DC 剪切域的操作和 Win32 不同的是,MiniGUI 的剪切域只支持矩形剪切域 ExcludeClipRect 可用来在当前剪切域中排除指定的矩形区域 IncludeClipRect 可用来在当前剪切域中包含指定的矩形区域 CliprectIntersect 可用来将当前剪切域和指定矩形相交 SelectClipRect 将剪切域设置为指定矩形 GetBoundsRect 获取包含当前剪切域的最大矩形 PtVisible 可判断给定点是否处于剪切域 RectVisible 可判断给定矩形是否和剪切域相交位图支持这类函数用来实现填充操作利用 FillBox 可以以当前的画刷类型和颜色填充指定矩形利用 FillBoxWithBitmap 可以用指定的位图填充指定矩形, 如果有需要, 该函数可进行位图的缩放利用 BitBlt 函数可在两个 DC 之间复制图象

12 利用 StretchBlt 函数可两个 DC 之间复制图象, 并完成缩放利用函数 LoadBitmap 可从 Windows BMP 文件中装入位图信息 UnloadBitmap 则卸载位图信息图标支持 MiniGUI 的图标支持和 Win32 API 大致相同, 包含如下几种操作 : 创建和销毁图标 :LoadIconFromFile CreateIcon DestroyIcon 图标绘制支持 :DrawIcon 根据需要 MiniGUI 将提供系统图标集, 及相应的操作函数矩形支持这类函数提供了实现矩形相交, 合并等一般性的操作, 达到 Win32 的 95% 兼容下面是这些函数的说明 1) SetRect void GUIAPI SetRect(RECT* prc, int left, int top, int right, int bottom); 该函数将矩形 prc 设定为参数 left, top, right, bottom 指定的大小 2) SetRectEmpty void GUIAPI SetRectEmpty(RECT* prc); 该函数将矩形 prc 设置为空矩形. 空矩形就是面积为 0 的矩形. 该函数将矩形的 left, top, right, bottom 值均设置为 0 3) CopyRect void GUIAPI CopyRect(RECT* pdrc, const RECT* psrc); 该函数将矩形 psrc 复制到 pdrc 中 4) IsRectEmpty BOOL GUIAPI IsRectEmpty(const RECT* PRC); 该函数判断指定矩形是否为空矩形若为空矩形, 则函数返回 TRUE, 否则返回 FALSE 5) EqualRect BOOL GUIAPI EqualRect(const RECT* prc1, const RECT* prc2); 该函数判断指定的两个矩形是否是相等的矩形相等的矩形其 bottom 值均相等 left, top, right, 6) NormalizeRect void GUIAPI Normali ze R e ct(rect* prect); 该函数将指定的矩形 prect 进行正规化处理矩形的正规化指满足如下条件的矩形 :

13 left <= right 并且 top <= bottom 7) IntersectRect BOOL GUIAPI IntersectRect(RECT* pdrc, const RECT* psrc1, const RECT* psrc2); 该函数求两个矩形 psrc1 和 psrc2 的相交区域, 并在 pdrc 中返回相交矩形如果 psrc1 和 psrc2 相交, 函数返回为 TRUE 如果 psrc1 和 psrc2 不相交, 函数返回为 FALSE,pdrc 为空矩形 8) DoesIntersect BOOL GUIAPI DoesIntersect(const RECT* psrc1, const RECT* psrc2); 该函数判断两个矩形是否相交如果 psrc1 和 psrc2 相交, 函数返回为 TRUE 如果 psrc1 和 psrc2 不相交, 函数返回为 FALSE 9) UnionRect BOOL GUIAPI UnionRect(RECT* pdrc, const RECT* psrc1, const RECT* psrc2); 该函数求两个矩形 psrc1 和 psrc2 相并矩形, 并在 pdrc 中返回相并矩形如果 psrc1 和 psrc2 能够进行相并操作, 函数返回 TRUE 如果 psrc1 和 psrc2 不能进行相并操作, 函数返回 FALSE,pdrc 为空矩形 10) SubtractRect BOOL GUIAPI SubtractREct(RECT* pdrc, const RECT* psrc1, const RECT* psrc2); 该函数求两个矩形 psrc1 和 psrc2 相减的矩形, 并在 pdrc 中返回结果矩形如果 psrc1 和 psrc2 能够进行相减操作, 函数返回 TRUE 如果 psrc1 和 psrc2 不能进行相减操作, 函数返回 FALSE,pdrc 为空矩形 11) OffsetRect void GUIAPI OffsetRect(RECT* prc, int x, int y); 该函数将矩形 prc 偏移指定的偏移量 x, y 12) InflateRect void GUIAPI InflateRect(RECT* prc, int cx, int cy); 该函数将矩形 prc 的长和宽分别增加 cx 和 cy 13) PtInRect BOOL GUIAPI PtInRect(const RECT* prc, int x, int y); 该函数判断指定点 (x, y) 是否处于矩形 prc 中如果指定点在矩形中, 函数返回 TRUE; 否则返回 FALSE

14 六菜单 MiniGUI 中的菜单接口和 Win32 90% 兼容, 但有少许差别在外观上,MiniGUI 可为弹出式菜单定义一个菜单标题, 可支持空的弹出式菜单 ; 在内部结构和概念上也有一些小的差别主要区别在于子菜单的定义上, 子菜单即可以是一个完整的弹出式菜单, 也可以是一个没有弹出式菜单标题的子菜单从另一个角度讲, 弹出式菜单是由标题以及一系列子菜单项组成的 MiniGUI 提供用来操作菜单的函数有 : HMENU GUIAPI CreateMenu (); HMENU GUIAPI CreatePopupMenu ( PMENUITEMINFO pmii); HMENU GUIAPI CreateSystemMenu (); int GUIAPI InsertMenuItem (HMENU hmnu, int item, BOOL flag, PMENUITEMINFO pmii); int GUIAPI RemoveMenu (HMENU hmnu, int item, UINT flags); int GUIAPI DeleteMenu (HMENU hmnu, int item, UINT flags); int GUIAPI DestroyMenu (HMENU hmnu); 功能上述这些函数用来操作菜单数据, 可实现菜单的创建销毁, 菜单项的添加删除等 int GUIAPI IsMenu (HMENU hmnu); 该函数可用来判断给定句柄是否为菜单句柄 HMENU GUIAPI SetMenu (HWND hwnd, HMENU hmnu); HMENU GUIAPI GetMenu (HWND hwnd); 上述函数用于获取或设置主窗口的菜单 void GUIAPI DrawMenuBar (HWND hwnd); int GUIAPI TrackMenuBar (HWND hwnd, int pos); int GUIAPI TrackPopupMenu (HMENU hmnu, UINT uflags, int x, int y, HWND hwnd; HMENU GUIAPI GetMenuBarItemRect (HWND hwnd, int pos, RECT* prc); BOOL GUIAPI HiliteMenuBarItem (HWND hwnd, int pos, UINT flag); 上述函数用于显示并跟踪菜单 int GUIAPI GetMenuItemCount (HMENU hmnu); int GUIAPI GetMenuItemID (HMENU hmnu, int pos); int GUIAPI GetMenuItemInfo (HMENU hmnu, int item, BOOL flag, PMENUITEMINFO pmii); int GUIAPI GetMenuItemRect (HWND hwnd, HMENU hmnu, int item, PRECT prc); HMENU GUIAPI GetPopupSubMenu (HMENU hpppmnu); HMENU GUIAPI GetSubMenu (HMENU hmnu, int pos); int GUIAPI GetSystemMenu (HWND hwnd, BOOL flag); UINT GUIAPI EnableMenuItem (HMENU hmnu, int item, UINT flags); int GUIAPI CheckMenuRadioItem (HMENU hmnu, int first, int last, int checkitem, UINT flags); int GUIAPI SetMenuItemBitmaps (HMENU hmnu, int item, UINT flags, PBITMAP hbmpunchecked, PBITMAP hbmpchecked); int GUIAPI SetMenuItemInfo (HMENU hmnu, int item, BOOL flag, PMENUITEMINFO pmii); 上述这些函数用于获取或设置菜单属性

15 七定时器在 MiniGUI 中应用项目可用的定时器总共可有 16 个, 而每个应用最多只能定义 8 个定时器 MiniGUI 中的定时器和 Win32 中使用定时器的方法是一样的, 但不支持定时器回调函数 MiniGUI 提供来操作定时器的函数有 : BOOL GUIAPI SetTimer (HWND hwnd, int id, int speed); BOOL GUIAPI KillTimer (HWND hwnd, int id); BOOL GUIAPI SetTimerSpeed (HWND hwnd, int id, int speed); 如下的代码段建立了标识号为 100 的定时器 : SetTimer (hwnd, 100, 20); 然后在适当的时候删除了定时器 : KillTimer (hwnd, 100); 注意, 在 Win32 中, 创建定时器时指定定时器的时间间隔, 而在 MiniGUI 中指定的是速度八鼠标光标 MiniGUI 提供了和 Win32 基本兼容的鼠标光标操作, 其中有光标的创建和销毁, 系统光标支持, 光标剪切, 光标位置以及光标的显示和隐藏等下面的函数可用来创建销毁鼠标光标, 或获取系统鼠标光标 : HCURSOR GUIAPI LoadCursorFromFile(const char* filename); HCURSOR GUIAPI CreateCursor(int xhotspot, int yhotspot, int w, int h, const BYTE* pandbits, const BYTE* pxorbits, int colornum); BOOL GUIAPI DestroyCursor(HCURSOR hcsr); HCURSOR GUIAPI GetSystemCursor(int csrid); 函数 GetCurrentCursor 则可以返回当前的鼠标光标 : HCURSOR GUIAPI GetCurrentCursor(void); 下面的函数剪切鼠标光标的活动范围 : void GUIAPI ClipCursor(const RECT* prc); void GUIAPI GetClipCursor(RECT* prc); 下面的函数同步获取或设置鼠标光标的位置, 需要给定屏幕坐标 : void GUIAPI GetCursorPos(POINT* ppt); void GUIAPI SetCursorPos(int x, int y); SetCursor 函数可用来设置鼠标光标形状 : HCURSOR GUIAPI SetCursor(HCURSOR hcsr); ShowCursor 可隐藏或显示鼠标光标 : int GUIAPI ShowCursor(BOOL fshow);

16 九插入符 MiniGUI 将完全实现 Win32 对插入符的管理功能包括如下函数 : CreateCaret DestroyCaret 上述函数用来创建和销毁插入符 GetCaretBlinkTime GetCaretPos HideCaret SetCaretBlinkTime SetCaretPos ShowCaret 上述函数用来显示隐藏或操作插入符属性十键盘和鼠标输入这部分内容应保持和 Win32 的 80% 兼容, 在现有基础上还需要完成如下工作 : 鼠标输入信息中键盘的标志信息, 即 Ctrl Alt Shift 等键的信息键盘从原始键码到 ASCII 或 GB2312 码的翻译十一键盘快捷键这部分内容将保持和 Win32 的 90% 兼容, 包含如下函数 : CopyAcceleratorTable CreateAcceleratorTable DestroyAcceleratorTable LoadAccelerators * AddAccelerator * RemoveAccelerator * 上述函数用来操作快捷键数据结构因为没有资源文件, 因此,LoadAccelerators 是实现从指定文件中装载快捷键的函数,AddAccelerator 和 RemoveAccelerator 函数用来向已有的快捷键中添加或删除快捷键 TranslateAccelerator 该函数将快捷键翻译为对应的菜单命令

PowerPoint 演示文稿

PowerPoint 演示文稿嵌入式系统嵌入式 GUI 浙江大学计算机学院陈文智 chenwz@zju.edu.cn 提纲嵌入式 GUI 概述 MiniGUI 概述 MiniGUI 架构 MiniGUI 使用 MiniGUI 编程 1 嵌入式 GUI 概述 GUI 的出现是 PC 应用的一个分水岭嵌入式平台上的 GUI 具备轻小型占用资源少高性能高可靠性和可配置性等嵌入式平台所特有的优点一般针对特定的硬件设备或环境,