[转载] MiniGUI编程速查表
文摘 嵌入式 2020-09-17
阅读：4864
前言
自己学习MiniGui也快一年了，粗浅的学习了一下，本文是根据《MINIGUI-PROG-GUIDE-V3.0-C》中的内容整理而来，根据自己的理解做了一些分类，大部分都是一些函数的说明，方便自己以后学习MiniGui时查阅。现在分享出来，供大家一起学习。当然在学习的过程中也遇到过一些坑，像自定义控件，主窗口透明背景，窗口弹出动画啊，控件动画等等，有时间也会分享出来。
1 窗口的创建
1.1 创建函数
| 函数 | 含义 | 备注 |
|---|
| CreateMainWindowEx | 主窗口创建函数 | 以Ex结尾的函数都是新增加的函数 |
| CreateWindowEx | 控件的创建函数 | 以Ex结尾的函数都是新增加的函数 |
| DialogBoxIndirectParamEx | 模态对话框的创建函数 | 以Ex结尾的函数都是新增加的函数 |
| CreateMainWindowIndirectParamEx | 非模态对话框的创建函数 | 以Ex结尾的函数都是新增加的函数 |
| CreateMainWindow | 无扩展主窗口创建函数 | |
| CreateWindow | 无扩展控件的创建函数 | |
| DialogBoxIndirectParam | 无扩展模态对话框的创建函数 | |
| CreateMainWindowIndirectParam | 无扩展非模态对话框的创建函数 | |
| CreateWindowEx2 | 对CreateWindowEx的封装 | |
1.2 主窗口创建属性
| 属性 | 含义 |
|---|
| CreateInfo.dwStyle | 窗口风格 |
| CreateInfo.spCaption | 窗口的标题 |
| CreateInfo.dwExStyle | 窗口的附加风格 |
| CreateInfo.hMenu | 附加在窗口上的菜单句柄 |
| CreateInfo.hCursor | 在窗口中所使用的鼠标光标句柄 |
| CreateInfo.hIcon | 程序的图标 |
| CreateInfo.MainWindowProc | 该窗口的消息处理函数指针 |
| CreateInfo.lx | 窗口左上角相对屏幕的绝对横坐标,以象素点表示 |
| CreateInfo.ty | 窗口左上角相对屏幕的绝对纵坐标,以象素点表示 |
| CreateInfo.rx | 窗口右下角相对屏幕的绝对横坐标,以象素点表示 |
| CreateInfo.by | 窗口右下角相对屏幕的绝对纵坐标,以象素点表示 |
| CreateInfo.iBkColor | 窗口背景颜色 |
| CreateInfo.dwAddData | 附带给窗口的一个 32 位值 |
| CreateInfo.hHosting | 窗口消息队列的托管窗口 |
2 预定义的控件类
| 控件类 | 类名称 | 宏定义 |
|---|
| 静态框 | "static" | CTRL_STATIC |
| 按钮 | "button" | CTRL_BUTTON |
| 列表框 | "listbox" | CTRL_LISTBOX |
| 单行编辑框 | "sledit" | CTRL_SLEDIT |
| 多行编辑框 | "mledit" | CTRL_MLEDIT |
| 文本编辑框 | "textedit" | CTRL_TEXTEDIT |
| 单行双向文本编辑框 | "bidisledit" | CTRL_BIDISLEDIT |
| 组合框 | "combobox" | CTRL_COMBOBOX |
| 菜单按钮 | "menubutton" | CTRL_MENUBUTTON |
| 进度条 | "progressbar" | CTRL_PROGRESSBAR |
| 滑块 | "trackbar" | CTRL_TRACKBAR |
| 工具栏 | "newtoolbar" | CTRL_NEWTOOLBAR |
| 属性表 | "propsheet" | CTRL_PROPSHEET |
| 滚动窗口控件 | "ScrollWnd" | CTRL_SCROLLWND |
| 滚动型控件 | "ScrollView" | CTRL_SCROLLVIEW |
| 树型控件 | "treeview" | CTRL_TREEVIEW |
| 列表型控件 | "listview" | CTRL_LISTVIEW |
| 月历 | "MonthCalendar" | CTRL_MONTHCALENDAR |
| 旋钮控件 | "SpinBox" | CTRL_SPINBOX |
| 酷工具栏 | "CoolBar" | CTRL_COOLBAR |
| 动画控件 | "Animation" | CTRL_ANIMATION |
| 网格控件 | "gridview" | CTRL_GRIDVIEW |
| 图标型控件 | "IconView" | CTRL_ICONVIEW |
| 滚动条控件 | "ScrollBar" | CTRL_SCROLLBAR |
3 风格
3.1 窗口通用风格
| 风格 | 含义 | 备注 |
|---|
| WS_NONE | 未指定任何风格 | |
| WS_CHILD | 创建子窗口 | |
| WS_VISIBLE | 创建初始可见的窗口 | |
| WS_DISABLED | 创建初始被禁止的窗口 | |
| WS_CAPTION | 创建含标题栏的主窗口 | 仅用于主窗口 |
| WS_SYSMENU | 创建含系统菜单的主窗口 | 仅用于主窗口 |
| WS_BORDER | 创建有边框的窗口 | |
| WS_THICKFRAME | 创建具有厚边框的窗口 | |
| WS_THINFRAME | 创建具有薄边框的窗口 | |
| WS_VSCROLL | 创建带垂直滚动条的窗口 | |
| WS_HSCROLL | 创建带水平滚动条的窗口 | |
| WS_MINIMIZEBOX | 标题栏上带最小化按钮 | 仅用于主窗口 |
| WS_MAXIMIZEBOX | 标题栏上带最大化按钮 | 仅用于主窗口 |
| WS_EX_NONE | 无扩展风格 | |
| WS_EX_USEPRIVATECDC | 使用私有DC | 仅用于主窗口 |
| WS_EX_TOPMOST | 建立始终处于顶层的主窗口 | 仅用于主窗口 |
| WS_EX_TOOLWINDOW | 建立Tooltip主窗口 | 仅用于主窗口。Tooltip主窗口将不会拥有输入焦点,但仍接收鼠标消息 |
| WS_EX_TRANSPARENT | 透明窗口风格 仅用于控件 | |
| WS_EX_USEPARENTFONT | 使用父窗口字体作为默认字体 | |
| WS_EX_USEPARENTCURSOR | 使用父窗口光标作为默认光标 | |
| WS_EX_NOCLOSEBOX | 主窗口标题栏上不带关闭按钮 | |
| WS_EX_CTRLASMAINWIN | 建立可显示在主窗口之外的控件 | 仅用于控件 |
| WS_EX_TROUNDCNS | 左上角和右上角是圆角的窗口 | |
| WS_EX_BROUNDCNS | 左下角和右下角是圆角的窗口 | |
| WS_EX_CLIPCHILDREN | 调用BegainPaint获得DC并刷新窗口客户区时, 子窗口所占区域将被剪切;也就是说,向窗口客户区的输出不会输出到子窗口所在位置。 | 该风格将导致额外的内存占用并影响绘制效率。只有窗口的输出和其子窗口的输出发生重叠时才应使用该风格,一般的对话框窗口、属性页控件无需使用该风格。 |
| WS_EX_LEFTSCROLLBAR | 创建垂直滚动条在左侧的窗口 | |
| WS_EX_AUTOSECONDARYDC | 双缓冲窗口扩展风格 | 仅用于主窗口 |
3.2 控件风格
3.2.1 仅用于对话框控件的风格
| 风格 | 含义 | 备注 |
|---|
| WS_GROUP | 具有该风格的控件将成为同组控件的打头控件 | 从该控件到下一个WS_GROUP风格的控件之前的,或者下一个不同种类的控件之前的控件属于同一组 |
| WS_TABSTOP | 具有TAB键停止功能 | 当用户在对话框中使用TAB键和Shift-TAB键切换输入焦点时,具有该风格的控件可获得焦点 |
3.2.2 静态框风格
| 风格 | 含义 | 备注 |
|---|
| SS_SIMPLE | 显示单行文本 | 控件文本不会自动换行显示,并且文本永远是左对齐 |
| SS_LEFT | 左对齐 | 用来显示多行文本 |
| SS_CENTER | 中对齐 | 用来显示多行文本 |
| SS_RIGHT | 右对齐 | 用来显示多行文本 |
| SS_LEFTNOWORDWRAP | 扩展文本中的TAB符 | 但是不做自动换行处理 |
| SS_BITMAP | 显示一幅位图 | |
| SS_ICON | 显示一幅图标 | |
| SS_CENTERIMAGE | 居中显示 | 与SS_REALSIZEIMAGE一起使用，则取消缩放，居中显示 |
| SS_REALSIZEIMAGE | 消缩放操作，并显示在静态框的左上方 | 默认情况下,位图和图标要经过适当的缩放充满整个静态框 |
| SS_GROUPBOX | 分组框 | 是一个矩形框,分组框标题在其顶部显示,分组方块常用来包含其他的控件 |
| SS_WHITERECT | 以白色填充静态框矩形 | |
| SS_GRAYRECT | 以灰色填充静态框矩形 | |
| SS_BLACKRECT | 以黑色填充静态框矩形 | |
| SS_GRAYFRAME | 灰色边框 | |
| SS_WHITEFRAME | 白色边框 | |
| SS_BLACKFRAME | 黑色边框 | |
| SS_NOTIFY | 接收静态框消息 | |
3.2.3 按钮风格
| 风格 | 含义 | 备注 |
|---|
| BS_PUSHBUTTON | 边框要细一些 | |
| BS_DEFPUSHBUTTON | "DEF"代表"默认"，边框要粗一些 | 默认接收ENTER键输入的按钮,而不管当前的输入焦点处于哪个控件上 |
| BS_MULTLINE | 指定显示多行文本 | 通常情况下,按钮文本会以单行的形式在垂直和水平方向居中显示,不会自动换行 |
| BS_LEFTTEXT | 文本置于复选框的左边 | |
| BS_LEFT | 文本在左边 | |
| BS_CENTER | 文本在中间 | |
| BS_RIGHT | 文本在右边 | |
| BS_TOP | 文本在上边 | |
| BS_BOTTOM | 文本在下边 | |
| BS_VCENTER | 文本居中垂直 | |
| BS_BITMAP | 普通按钮上显示位图 | |
| BS_ICON | 普通按钮上显示图标 | |
| BS_REALSIZEIMAGE | 使位图或图标显示在控件中部,不作任何缩放 | 默认情况下位图或图标会缩放显示以充满整个按钮窗口范围 |
| BS_CHECKBOX | 复选框 | 应用程序需要自己向该控件发送消息来设定选中标记 |
| BS_AUTOCHECKBOX | 复选框 | 控件会自动在选中和非选中状态之间切换 |
| BS_3STATE | 复选框 | 功能同上，复选框内是灰色的,这种状态表明该复选框不能被选择或者禁止使用 |
| BS_AUTO3STATE | 复选框 | 功能同上，复选框内是灰色的,这种状态表明该复选框不能被选择或者禁止使用 |
| BS_PUSHLIKE | 使复选框以普通按钮的形式显示 | 选中时显示为按下状态,未选中时显示为正常状态 |
| BS_RADIOBUTTON | 单选钮 | 它的行为很像复选框，圆圈内的加重圆点表示该单选按钮已经被选中 |
| BS_AUTORADIOBUTTON | 单选钮 | 自动显示用户的选择情况 |
| BS_PUSHLIKE | 使单选按钮以普通按钮的形式显示 | 选中时显示为按下状态,未选中时显示为正常状态 |
| BS_NOTIFY | 接收按钮消息 | |
3.2.4 列表风格
| 风格 | 含义 |
|---|
| LBS_MULTIPLESEL | 多选列表框 |
| LBS_USEICON | 附带位图或者图标 |
| LBS_CHECKBOX | 在列表项旁边显示一个检查框 |
| LBS_AUTOCHECK | 自动切换选中状态 |
| LBS_NOTIFY | 选中某个列表项时产生通知消息 |
| LBS_SORT | 列表排序 |
3.2.5 编辑框风格
| 风格 | 含义 |
|---|
| ES_UPPERCASE | 可以使编辑框只显示大写字母 |
| ES_LOWERCASE | 可以使编辑框只显示小写字母 |
| ES_PASSWORD | 编辑框用来输入密码,但用星号(*)显示输入的字符 |
| ES_READONLY | 建立只读编辑框,用户不能修改编辑框中的内容,但插入符仍然可见 |
| ES_BASELINE | 在编辑框文本下显示虚线 |
| ES_AUTOWRAP | 用于多行编辑框,当文本超过控件边界时,将自动换行 |
| ES_LEFT | 指定非多行编辑框的对齐风格,实现文本的左对齐风格 |
| ES_NOHIDESEL | 编辑框在失去焦点时保持被选择文本的选中状态 |
| ES_AUTOSELECT | 编辑框在得到焦点时自动选中所有的文本内容(仅针对单行编辑框) |
| ES_TITLE | 在编辑框的第一行显示指定的标题,只适用于多行编辑框控件 |
| ES_TIP | 当编辑框的内容为空时,在其中显示相关的提示信息;只适用于SLEDIT控件 |
| ES_CENTER | 指定非多行编辑框的对齐风格,实现文本的居中对齐风格 |
| ES_RIGHT | 指定非多行编辑框的对齐风格,实现文本的右对齐风格 |
其中适用于多行编辑框的风格有：ES_UPPERCASE, ES_LOWERCASE, ES_READONLY, ES_BASELINE, ES_AUTOWRAP, ES_NOHIDESEL,ES_TITLE
其中适用于单行编辑框的风格有：ES_UPPERCASE, ES_LOWERCASE, ES_READONLY, ES_BASELINE, ES_LEFT, ES_CENTER, ES_RIGHT,ES_PASSWORD,ES_NOHIDESEL,ES_AUTOSELECT,ES_TIP
3.2.6 组合框风格
| 风格 | 含义 |
|---|
| CBS_SIMPLE | 创建一个简单组合框 |
| CBS_DROPDOWNLIST | 创建下拉式组合框 |
| CBS_SPINLIST | 创建旋钮组合框 |
| CBS_SPINARROW_TOPBOTTOM | 箭头在内容的上下 |
| CBS_SPINARROW_LEFTRIGHT | 箭头在内容的左右 |
| CBS_READONLY | 使组合框的输入域成为只读区域 |
| CBS_UPPERCASE | 使键入编辑框中的文本自动变成大写 |
| CBS_LOWERCASE | 使键入编辑框中的文本自动变成小写 |
| CBS_EDITBASELINE | 使编辑框带有文本基线 |
| CBS_SORT | 使用该风格的组合框将自动对插入的条目进行排序 |
| CBS_EDITNOBORDER | 使得输入域不带边框 |
| CBS_AUTOFOCUS | 组合框在获得输入焦点之后,编辑框将自动获得输入焦点 |
| CBS_AUTOSPIN | 创建旋钮数字框,默认的最小值和最大值为0和100 |
| CBS_AUTOLOOP | 框中的数字将自动循环显示 |
3.2.7 菜单按钮风格
| 风格 | 含义 |
|---|
| MBS_SORT | 对菜单按钮中的条目进行排序显示 |
| MBS_LEFTARROW | 箭头显示在菜单按钮的左侧 |
| MBS_NOBUTTON | 不显示按钮 |
| MBS_ALIGNLEFT | 菜单按钮上的文字向左对齐 |
| MBS_ALIGNRIGHT | 菜单按钮上的文字向右对齐 |
| MBS_ALIGNCENTER | 菜单按钮上的文字居中对齐 |
3.2.8 进度条风格
| 风格 | 含义 |
|---|
| PBS_NOTIFY | 使用该风格的进度条控件会产生通知消息 |
| PBS_VERTICAL | 竖直显示进度条 |
3.2.9 滑块风格
| 风格 | 含义 |
|---|
| TBS_NOTIFY | 滑块产生通知消息 |
| TBS_VERTICAL | 创建竖直的滑块，默认情况下,滑块是水平的 |
| TBS_TIP | 滑块两端显示文字说明，还将在控件的中部显示当前刻度值 |
| TBS_NOTICK | 不显示刻度 |
| TBS_BORDER | 风格可使滑块带有边框,该风格不常用 |
3.2.10 工具栏风格
| 风格 | 含义 |
|---|
| NTBS_HORIZONTAL | 水平显示工具栏，这是默认风格 |
| NTBS_VERTICAL | 垂直显示工具栏 |
| NTBS_MULTLINE | 工具栏可多行显示，当工具项类型为NTBIF_NEWLINE时,将另起一行显示其后添加的工具项 |
| NTBS_WITHTEXT | 将在按钮下方或者按钮右边显示文本,默认显示在按钮位图的下方。这时,应用程序必须在添加按钮时指定按钮对应的文本。当文字在图标下方显示且按钮处于被激活状态时,按钮图片将突出显示 |
| NTBS_TEXTRIGHT | 配合NTBS_WITHTEXT风格使用时,该风格指定将文本显示在按钮位图的右边。当文字在图标右侧且按钮处于被激活状态时,按钮图片和文字都将突出显示 |
| NTBS_DRAWSTATES | 不使用按钮的高亮、按下以及灰化状态的位图单元,而改用三维风格的边框来表示这些状态 |
| NTBS_DRAWSEPARATOR | 绘制分隔条。默认情况下,工具栏上用来分隔按钮的分隔条是不会被绘制的,而只会加大两个按钮之间的间距。具有该风格之后,将绘制窄的分隔条 |
3.2.11 属性表风格
| 风格 | 含义 |
|---|
| PSS_SIMPLE | 所有的属性页凸舌具有相同的宽度 |
| PSS_COMPACTTAB | 属性页凸舌的宽度取决于属性页标题文本的长度 |
| PSS_SCROLLABLE | 属性页凸舌的宽度取决于属性页标题文本的长度,当属性页凸舌的数目过多时,将自动出现左右箭头用来调节当前可见的属性页凸舌 |
| PSS_BOTTOM | 属性页凸舌显示在属性表的下方,可以和上面三种风格同时配合使用 |
3.2.12 滚动型控件风格
| 风格 | 含义 |
|---|
| SVS_AUTOSORT | 对列表项进行自动排序，前提是先使用SVM_SETITEMCMP消息 |
| SVM_SETITEMCMP | 设置滚动型控件的列表项比较函数 |
| SVM_SORTITEMS | 来对列表项进行一次性的排序 |
3.2.13 树型控件风格
| 风格 | 含义 |
|---|
| TVS_WITHICON | 使用图标来显示每项的折叠和展开状态,相应的图标可以在创建节点项时指定，没有该风格使用一个带方框的"+"号来表示一个折叠的节点项，用带方框的"-"号来表示展开的节点项 |
| TVS_SORT | 对节点项进行自动排序 |
| TVS_NOTIFY | 将在响应用户操作时产生相应的通知消息和通知码 |
3.2.14 列表控件风格
| 风格 | 含义 |
|---|
| LVS_TREEVIEW | 支持以树型的方式来显示列表项 |
| LVS_UPNOTIFY | 指定列表型控件的在响应用户鼠标点击操作时的响应方式，默认情况下,如果没有指定LVS_UPNOTIFY风格,列表型控件将在鼠标按下时发出通知消息;如果指定了该风格,控件将在鼠标抬起时发出通知消息 |
3.2.15 月历控件风格
| 风格 | 含义 |
|---|
| MCS_CHN | 控件以中文显示日期信息 |
| MCS_ENG_L | 以英文显示日期信息 |
| MCS_ENG_S | 以简写的英文格式显示 |
| MCS_NOTIFY | 将在响应用户操作时等情况下产生相应的通知消息 |
3.2.16 旋钮控件风格
| 风格 | 含义 |
|---|
| SPS_AUTOSCROLL | 自动判断旋钮控件目前的滚动状态,在滚动到最大值和最小值时分别把向上和向下箭头禁止掉(变灰)，没有该风格的旋钮控件的滚动状态由应用程序掌握 |
3.2.17 酷工具栏风格
| 风格 | 含义 |
|---|
| CBS_BMP_16X16 | 酷工具栏的按钮项分别显示16x16的位图 |
| CBS_BMP_32X32 | 酷工具栏的按钮项分别显示32x32的位图 |
| CBS_BMP_CUSTOM | 酷工具栏的按钮项使用自定义大小的位图 |
| CBS_USEBKBMP | 酷工具栏有背景位图 |
3.2.18 动画控件风格
| 风格 | 含义 |
|---|
| ANS_AUTOLOOP | 使用该风格之后,动画控件将自动重复播放动画 |
| ANS_SCALED | 根据控件大小缩放动画对象 |
| ANS_FITTOANI | 根据动画对象大小调整控件尺寸 |
3.2.19 独立滚动条风格
| 风格 | 含义 |
|---|
| SBS_HORZ | 创建一个水平滚动条。当没有指定SBS_BOTTOMALIGN或SBS_TOPALIGN,滚动条的范围根据CreateWindowEx2参数x,y,w,h决定 |
| SBS_VERT | 创建一个垂直滚动条。当没有指定SBS_LEFTALIGN或SBS_RIGHTALIGN,滚动条的范围根据CreateWindowEx2参数x,y,w,h决定 |
| SBS_BOTTOMALIGN | 与SBS_HORZ一起使用。放置水平滚动条在CreateWindowEx2指定范围的底部 |
| SBS_TOPALIGN | 与SBS_HORZ一起使用。放置水平滚动条在CreateWindowEx2指定范围的顶部 |
| SBS_LEFTALIGN | 与SBS_VERT一起使用。放置垂直滚动条在CreateWindowEx2指定范围的左边 |
| SBS_RIGHTALIGN | 与SBS_VERT一起使用,放置垂直滚动条在CreateWindowEx2指定范围的右边 |
| SBS_NOARROWS | 没有箭头,不能与SBS_NOSHAFT一起使用 |
| SBS_NOSHAFT | 没有shaft,不能与SBS_NOARROWS一起使用 |
| SBS_FIXEDBARLEN | 水平滚动条的thumb长度固定,或者垂直滚动条的thumb长度固定 |
| SBS_NOTNOTIFYPARENT | 向父窗口的通知发送方式不是发送通知码,而是发送消息;默认发送通知码 |
4 通用窗口操作函数
| 函数 | 含义 | 备注 |
|---|
| UpdateWindow | 立即更新某个窗口 | |
| ShowWindow | 显示或隐藏某个窗口 | |
| IsWindowVisible | 判断某个窗口是否可见 | 控件和主窗口均可用 |
| EnableWindow | 使能或禁止某个窗口 | |
| IsWindowEnabled | 判断某个窗口是否可用 | |
| GetClientRect | 获取窗口客户区矩形 | |
| GetWindowRect | 获取窗口矩形 | 屏幕坐标系中的窗口尺寸 |
| GetWindowBkColor | 获取窗口背景色 | |
| SetWindowBkColor | 设置窗口背景色 | |
| GetWindowFont | 获取窗口默认字体 | |
| SetWindowFont | 设置窗口默认字体 | |
| GetWindowCursor | 获取窗口光标 | |
| SetWindowCursor | 设置窗口光标 | |
| GetWindowStyle | 获取窗口风格 | |
| GetWindowExStyle | 获取窗口扩展风格 | |
| GetFocusChild | 获取拥有输入焦点的子窗口 | |
| SetFocusChild | 设置焦点子窗口 | |
| GetWindowCallbackProc | 获取窗口过程函数 | |
| SetWindowCallbackProc | 设置窗口过程函数 | |
| GetWindowAdditionalData | 获取窗口附加数据一 | |
| SetWindowAdditionalData | 设置窗口附加数据一 | |
| GetWindowAdditionalData2 | 获取窗口附加数据二 | 对话框和控件在内部已使用附加数据二,保留附加数据一给应用程序使用 |
| SetWindowAdditionalData2 | 设置窗口附加数据二 | |
| GetWindowCaption | 获取窗口标题 | 通常用于主窗口 |
| SetWindowCaption | 设置窗口标题 | |
| InvalidateRect | 使窗口的给定矩形区域无效 | 将引发窗口重绘 |
| GetUpdateRect | 获取窗口当前的无效区域外包矩形 | |
| ClientToScreen | 将窗口客户区坐标转换为屏幕坐标 | |
| ScreenToClient | 将屏幕坐标转换为客户区坐标 | |
| WindowToScreen | 将窗口坐标转换为屏幕坐标 | |
| ScreenToWindow | 将屏幕坐标转换为窗口坐标 | |
| IsMainWindow | 判断给定窗口是否为主窗口 | |
| IsControl | 判断给定窗口是否为控件 | |
| IsDialog | 判断给定窗口是否为对话框 | |
| GetParent | 获取窗口的父窗口句柄 | 主窗口的父窗口永远为HWND_DESKTOP |
| GetMainWindowHandle | 返回包含某个窗口的主窗口句柄 | |
| GetNextChild | 获取下一个子窗口 | 用于遍历某个窗口的所有子窗口 |
| GetNextMainWindow | 获取下一个主窗口句柄 | 用于遍历所有主窗口 |
| GetHosting | 获取某个主窗口的托管窗口 | |
| GetFirstHosted | 获取某个主窗口的第一个被托管窗口 | 用于遍历某个主窗口的所有被托管窗口 |
| GetNextHosted | 获取下一个被托管窗口 | |
| GetActiveWindow | 获取当前活动主窗口 | |
| SetActiveWindow | 设置当前活动主窗口 | |
| GetCapture | 获取当前捕获鼠标的窗口 | |
| SetCapture | 捕获鼠标 | |
| ReleaseCapture | 释放鼠标 | |
| MoveWindow | 移动窗口或改变窗口大小 | |
| ScrollWindow | 滚动窗口客户区的内容 | ScrollWindow函数可根据客户区的滚动情况自动调整窗口内子窗口的位置 |
| IncludeWindowStyle | 增加指定的窗口属性 | |
| ExcludeWindowStyle | 去除指定的窗口属性 | |
| GetNotificationCallback | 获取控件的通知消息回调函数 | 在MiniGUI 1.2.6 版本中出现 |
| SetNotificationCallback | 设置控件的通知消息回调函数 | |
| SetTimer | 创建定时器 | 指定的窗口会收到MSG_TIMER消息 |
| KillTimer | 删除定时器 | |
| DestroyAllControls | 销毁所有的子窗口 | |
5 对话框操作函数
| 函数 | 含义 | 备注 |
|---|
| GetDlgCtrlID | 根据控件句柄获取控件标识符 | |
| GetDlgItem | 根据控件标识符获取控件句柄 | |
| GetDlgItemInt | 获取控件文本并转换为整数值 | |
| SetDlgItemInt | 根据整数值设置控件文本 | |
| GetDlgItemText | 获取子控件文本 | 功能同GetWindowText |
| GetDlgItemText2 | 获取子控件文本 | 根据文本长度自动分配内存,应用程序负责释放该内存 |
| SetDlgItemText | 设置子控件文本 | 功能同SetWindowText |
| GetNextDlgGroupItem | 获取下一个同组子控件 | 用于遍历同组控件,参阅WS_GROUP风格 |
| GetNextDlgTabItem | 获取下一个"TAB键停止"子控件 | 用于TAB键游历控件,参阅WS_TABSTOP风格 |
| SendDlgItemMessage | 向子控件发送消息 | 功能同SendMessage |
| CheckDlgButton | 设置检查框子控件的选中状态 | |
| CheckRadioButton | 设置单选按钮子控件的选中状态 | |
| IsDlgButtonChecked | 检查子按钮是否选中 | |
| GetDlgDefPushButton | 获取当前默认子按钮 | |
6 控件操作函数
6.1 菜单操作函数
| 函数 | 含义 | 备注 |
|---|
| CreateMenu | 创建一个空的菜单 | |
| InsertMenuItem | 添加菜单项 | |
| CreatePopupMenu | 创建弹出式菜单 | |
| TrackPopupMenu | 显示弹出式菜单 | |
| StripPopupHead | 删除弹出式菜单的头部 | |
| GetMenuItemInfo | 获得感兴趣的菜单项属性 | |
| SetMenuItemInfo | 设置感兴趣的菜单项属性 | |
| RemoveMenu | 从菜单中删除指定的菜单项 | 如果菜单项含有子菜单,则会解除子菜单和该菜单项的关联,但并不删除子菜单 |
| DeleteMenu | 从菜单中删除指定的菜单项 | 如果菜单项含有子菜单,则同时会删除子菜单 |
| DestroyMenu | 删除整个菜单 | |
6.2 滚动条操作函数
| 函数 | 含义 | 备注 |
|---|
| EnableScrollBar | 使能、禁止滚动条 | |
| SetScrollRange | 设置滚动条的滚动范围 | |
| SetScrollInfo | 设置滚动条的信息 | 如果在调用SetScrollRange后,调用了影响滚动条位置的其他函数,则应该将bRedraw设定为FALSE以避免过多地重画 |
6.3 键盘/鼠标操作函数
| 函数 | 含义 | 备注 |
|---|
| GetShiftKeyStatus | 获取键状态值 | |
| GetKeyStatus | 确定键盘上某个键的状态 | |
| GetFocusChild | 获得某个窗口中具有输入焦点的子窗口的句柄 | |
| SetFocusChild | 父窗口可以调用该函数来把输入焦点赋予它的某个子窗口 | |
| SetCapture | 用该函数来使某个窗口捕获鼠标 | 在某一时刻只能有一个窗口捕获鼠标 |
| ReleaseCapture | 恢复正常的鼠标处理方式 | |
| GetCapture | 确定当前哪个窗口捕获了鼠标 | |
6.4 图标/光标操作函数
| 函数 | 含义 | 备注 |
|---|
| LoadIconFromFile | 从一个Windows图标文件(*.ico)中载入图标,图标可以是单色、16色或256色的 | |
| LoadIconFromMem | 从内存中装载图标 | |
| DrawIcon | 装载完图标对象之后,就可以调用该函数在指定的位置绘制图标 | |
| DestroyIcon | 销毁图标句柄,并释放它所占用的内存 | |
| CreateIcon | 运行时动态创建图标，同样需要用DestroyIcon函数来销毁 | |
| GetLargeSystemIcon | 来获取内存中的系统图标来使用 | 32x32像素的系统大图标 |
| GetSmallSystemIcon | 来获取内存中的系统图标来使用 | 16x16像素的系统小图标 |
| LoadSystemIcon | 直接从MiniGUI.cfg配置文件中定义的图标文件中载入所需的系统图标 | 实际上是通过调用 LoadIconFromFile来载入图标的，不再需要的时候也必须使用DestroyIcon函数来销毁 |
| LoadCursorFromFile | 从一个Windows光标文件中载入光标 | |
| LoadCursorFromMem | 从内存中读入光标 | |
| CreateCursor | 动态创建光标 | |
| DestroyCursor | 销毁由LoadCursorFromFile函数和CreateCursor函数创建的光标,并释放光标对象所占用的内存 | |
| GetCursorPos | 获取光标的当前屏幕位置 | |
| SetCursorPos | 把光标移动到屏幕上的指定位置 | |
| GetCurrentCursor | 获取当前光标句柄 | |
| SetCursorEx | 设置当前光标 | |
| SetCursor | 设置当前光标,不改变缺省光标 | |
| SetDefaultCursor | 把给定光标设置为当前光标和缺省光标 | |
| GetWindowCursor | 获取给定窗口的当前光标 | |
| SetWindowCursor | 设置新的窗口光标 | |
| GetSystemCursor | 获得的系统缺省光标 | GetSystemCursor(0)、GetSystemCursor(IDC_ARROW)是一样的 |
| ShowCursor | 显示或隐藏光标 | |
| ClipCursor | 把光标限定在屏幕的某个矩形区域内 | 常用于响应某一特定的限制矩形区域内的事件 |
| GetClipCursor | 获取当前的光标限定矩形 | 该函数可以用来在设置新的限定矩形之前保存原始限定矩形,需要时把它用于恢复原始区域 |
6.4.1光标类型
| 类型 | 含义 | 值 |
|---|
| IDC_ARROW | 系统缺省的箭头光标 | 0 |
| IDC_IBEAM | 'I'形光标,指示输入区域 | 1 |
| IDC_PENCIL | 笔形光标 | 2 |
| IDC_CROSS | 十字光标 | 3 |
| IDC_MOVE | 移动光标 | 4 |
| IDC_SIZENWSE | 西北-东南方向的调整大小光标 | 5 |
| IDC_SIZENESW | 东北-西南方向的调整大小光标 | 6 |
| IDC_SIZEWE | 东西方向的调整大小光标 | 7 |
| IDC_SIZENS | 南北方向的调整大小光标 | 8 |
| IDC_UPARROW | 向上箭头光标 | 9 |
| IDC_NONE | 空光标 | 10 |
| IDC_HELP | 带问号光标 | 11 |
| IDC_BUSY | 忙光标 | 12 |
| IDC_WAIT | 等待光标 | 13 |
| IDC_RARROW | 右箭头光标 | 14 |
| IDC_COLOMN | 列光标 | 15 |
| IDC_ROW | 行光标 | 16 |
| IDC_DRAG | 拖动光标,用于拖放操作 | 17 |
| IDC_NODROP | 不可放下光标,用于拖放操作 | 18 |
| IDC_HAND_POINT | 手形指点光标 | 19 |
| IDC_HAND_SELECT | 手形选择光标 | 20 |
| IDC_SPLIT_HORZ | 水平分割光标 | 21 |
| IDC_SPLIT_VERT | 垂直分割光标 | 22 |
6.5 插入符操作函数
| 函数 | 含义 | 备注 |
|---|
| CreateCaret | 创建一个插入符,并把它赋给指定的窗口 | |
| DestroyCaret | 销毁由创建的插入符 | |
| ShowCaret | 显示插入符 | |
| HideCaret | 把插入符隐藏掉 | |
| GetCaretPos | 获取插入符的所在位置 | |
| SetCaretPos | 在一个窗口之内移动插入符 | |
| GetCaretBlinkTime | 获取插入符的反转时间 | 该时间以毫秒计数,系统缺省的插入符反转时间为500毫秒 |
| SetCaretBlinkTime | 定义插入符的反转时间 | 插入符反转时间最小不能小于100毫秒 |
6.6 剪贴板操作函数
| 函数 | 含义 | 备注 |
|---|
| CreateClipBoard | 创建自定义的剪贴板，包括系统的最多有NR_CLIPBOARDS（4）个 | MiniGUI提供了一个默认的文本剪贴板,名字为CBNAME_TEXT |
| DestroyClipBoard | 销毁自定义的剪贴板 | |
| SetClipBoardData | 把数据传送到指定的剪贴板 | |
| GetClipBoardDataLen | 获取剪贴板上数据的大小 | |
| GetClipBoardData | 把剪贴板上的数据复制到指定的数据缓冲区中 | |
| GetClipBoardByte | 从剪贴板数据的指定位置获取一个字节 | |
6.7 配置文件操作函数
| 函数 | 含义 | 备注 |
|---|
| GetValueFromEtcFile | 从指定的配置文件当中获取指定的键值,键值以字符串形式返回 | |
| GetIntValueFromEtcFile | 从指定的配置文件当中获取指定的整数型键值 | |
| SetValueToEtcFile | 将给定的键值保存到指定的配置文件当中 | 如果配置文件不存在,则将新建配置文件 |
| LoadEtcFile | 把指定的配置文件读入内存,返回一个配置对象句柄 | |
| UnloadEtcFile | 释放内存中的配置文件信息 | |
| GetValueFromEtc | 使用方法和第一个函数类似 | 注意第一个参数是句柄 |
| GetIntValueFromEtc | 使用方法和第二个函数类似 | 注意第一个参数是句柄 |
| SetValueToEtc | 使用方法和第三个函数类似 | 只改变内存中的配置值 |
| RemoveSectionInEtc | 从内存中的配置文件信息中删除指定的段信息 | |
| RemoveSectionInEtcFile | 从指定的配置文件当中删除指定的段信息 | |
| GetValueFromEtcSec | 从内存中的配置文件信息的指定段中获取指定的键值 | |
| GetIntValueFromEtcSec | 从内存中的配置文件信息的指定段中获取指定的整数型键值 | |
| SetValueToEtcSec | 保存键值到内存中的配置文件信息的指定段中 | |
| SaveEtcToFile | 将内存中的配置文件信息保存到指定的文件中 | |
| FindSectionInEtc | 在内存中的配置文件信息中查找指定的字段 | 如果没有指定的字段存在,当参量bCreateNew为TRUE时将新建一空字段 |
6.8 编辑框操作函数
| 函数 | 含义 |
|---|
| GetWindowTextLength | 获取文本的长度,以字节为单位 |
| GetWindowText | 获取编辑框中的文本 |
| SetWindowText | 设置编辑框中的文本内容 |
7 消息的种类
7.1 窗口消息
| 消息 | 含义 |
|---|
| MSG_NCCREATE | 消息在MiniGUI建立主窗口的过程中发送到窗口过程 |
| MSG_SIZECHANGING | 消息窗口尺寸发生变化时,或者建立窗口时发送到窗口过程 |
| MSG_SIZECHANGED | 消息在窗口尺寸发生变化后发送到窗口过程 |
| MSG_CSIZECHANGED | 消息是窗口客户区的尺寸发生变化后发送到窗口过程 |
| MSG_CREATE | 消息在窗口成功创建并添加到MiniGUI的窗口管理器之后发送到窗口过程 |
| MSG_FONTCHANGING | 当应用程序调用SetWindowFont改变窗口的默认字体时,将发送该消息到窗口过程 |
| MSG_FONTCHANGED | 当应用程序调用SetWindowFont改变了窗口的默认字体后,将发送该消息到窗口过程 |
| MSG_ERASEBKGND | 当系统需要清除窗口背景时,将发送该消息到窗口过程 |
| MSG_PAINT | 该消息在需要进行窗口重绘时发送到窗口过程 |
| MSG_CLOSE | 当用户点击窗口上的"关闭"按钮时, MiniGUI向窗口过程发 送MSG_CLOSE消息 |
| MSG_DESTROY | 消息在应用程序调DestroyMainWindow或者DestroyWindow时发送到窗口过程当中 |
| MSG_INITDIALOG | 消息是在MiniGUI根据对话框模板建立对话框以及控件之后,发送到对话框回调函数的 |
| MSG_COMMAND | 控件内部发生某种事件时,会通过通知消息通知其父窗口 |
| MSG_ACTIVEMENU | 在用户激活菜单栏中的某个弹出式菜单后, MiniGUI将给菜单栏所在的窗口过程发送MSG_ACTIVEMENU消息 |
| MSG_TIMER | 创建定时器后触发的消息 |
一般来说,在以下情况下,MiniGUI程序的窗口过程会接收到一个MSG_PAINT 消息
- 用户移动窗口或显示窗口时,MiniGUI向先前被隐藏的窗口发送 MSG_PAINT 消息
- 程序使用InvalidateRect函数来更新窗口的无效区域,这将产生一个 MSG_PAINT 消息
- 程序调用UpdateWindow函数来重绘窗口
- 覆盖程序窗口的对话框或消息框被消除
- 下拉或弹出菜单被消除
7.2 键鼠消息
| 消息 | 含义 |
|---|
| MSG_KEYDOWN | 一个键被按下，如果用户按住某个键不放手，系统将会产生一系列按下的消息 |
| MGS_SYSKEYDOWN | 一个键被按下，如果用户按住某个键不放手，系统将会产生一系列按下的消息 |
| MSG_KEYUP | 释放一个键 |
| MGS_SYSKEYUP | 释放一个键 |
| MSG_CHAR | 字符键的字符消息 |
| MSG_KILLFOCUS | 系统向将要失去焦点的窗口发送该消息 |
| MSG_SETFOCUS | 发送给将要得到焦点的窗口 |
| MSG_LBUTTONDOWN | 鼠标左按钮被按下，MSG_NCLBUTTONDOWN |
| MSG_LBUTTONUP | 鼠标左按钮被释放，MSG_NCLBUTTONUP |
| MSG_RBUTTONDOWN | 鼠标右按钮被按下，MSG_NCRBUTTONDOWN |
| MSG_RBUTTONUP | 鼠标右按钮被释放，MSG_NCRBUTTONUP |
| MSG_LBUTTONDBLCLK | 鼠标左按钮被双击，MSG_NCLBUTTONDBLCLK |
| MSG_RBUTTONDBLCLK | 鼠标右按钮被双击，MSG_NCRBUTTONDBLCLK |
| MSG_HITTEST | 如果发生鼠标事件,系统会向含有光标热点的窗口或捕捉鼠标的窗口发送该消息，MSG_NCHITTEST |
| MSG_MOUSEMOVE | 确定光标的当前位置 |
| MSG_SETCURSOR | 当用户移动鼠标时,MiniGUI 将把MSG_SETCURSOR消息发送给光标下面的窗口,光标应用程序可以在处理MSG_SETCURSOR消息时改变当前的光标 |
7.3 控件消息
7.3.1 滚动条消息
| 消息 | 含义 |
|---|
| MSG_VSCROLL | 垂直滚动条上下移动的消息 |
| MSG_HSCROLL | 水平滚动条左右移动的消息 |
7.3.2 静态框消息
| 消息 | 含义 |
|---|
| STM_GETIMAGE | 返回位图的指针或者图标句柄 |
| STM_SETIMAGE | 通过wParam参数重新设置位图指针或者图标句柄,并且返回原来的指针 |
7.3.3 按钮消息
| 消息 | 含义 |
|---|
| BM_GETCHECK | 查询复选框或者单选钮的选中状态 |
| BM_SETCHECK | 设置复选框或者单选钮的选中状态 |
| BM_GETSTATE | 查询普通按钮或者复选框的按下或释放状态 |
| BM_SETSTATE | 设置普通按钮或者复选框的按下或释放状态 |
| BM_GETIMAGE | 获取位图按钮上的位图或者图标 |
| BM_SETIMAGE | 设置位图按钮上的位图或者图标 |
| BM_CLICK | 发送BM_CLICK模拟用户鼠标的单击操作 |
7.3.4 列表消息
| 消息 | 含义 |
|---|
| LB_ERRSPACE | 当列表框控件所能存储的内容超过了可用内存空间时返回该消息 |
| LB_ERR | 因为其他原因而出错返回该消息 |
| LB_OKAY | 操作成功返回该消息 |
| LB_ADDSTRING | 将新的字符串追加为列表框的最后一项 |
| LB_INSERTSTRING | 将字符串插入到列表框中的指定位置 |
| LB_DELETESTRING | 从列表框中删除指定的条目 |
| LB_RESETCONTENT | 清空列表框中的所有内容 |
| LB_GETCOUNT | 可获得列表框中的条目个数 |
| LB_GETTEXTLEN | 获得列表框中指定条目的字符串长度 |
| LB_GETTEXT | 将该条目复制到文字缓冲区中 |
| LB_SETTEXT | 设置列表框条目的字符串 |
| LB_GETITEMDATA | 获得列表框条目的其他信息，如位图对象或图标句柄、检查框状态 |
| LB_SETITEMDATA | 设置列表框条目的其他信息，如位图对象或图标句柄、检查框状态 |
| LB_SETCURSEL | 控制当前的选中项，对于多项选择列表框，只能用来设置当前高亮项 |
| LB_GETCURSEL | 获得当前选定的索引项，对于多项选择列表框，只能用来获取当前高亮项,无法获得所有具有选中状态的条目 |
| LB_SETSEL | 设定某特定条目的选择状态,而不影响其他项 |
| LB_GETSEL | 获取某特定条目的选择状态 |
| LB_GETSELCOUNT | 获得多选列表框中当前被选中的条目个数 |
| LB_GETSELITEMS | 获得所有被选中条目的索引值 |
| LB_FINDSTRING | 查找含有字符串的条目，返回模糊匹配字符串string的条目索引值 |
| LB_FINDSTRINGEXACT | 将进行严格精确匹配查找 |
| LB_GETCHECKMARK | 设置某条目的检查框的当前状态,如果没有找到相应条目,则返回LB_ERR,CMFLAG_CHECKED处于选择状态,CMFLAG_PARTCHECKED处于部分选择状态,CMFLAG_BLANK处于未选择状态 |
| LB_SETCHECKMARK | 指定索引处条目的检查框的状态为status中指定的值 |
| LB_SETITEMBOLD | 指定索引处条目的检查框的状态为加粗显示状态,根据lParam的值判断是否进行加粗设置,如果为1则加粗显示,为0则正常显示 |
| LB_GETITEMDISABLE | 获取指定索引处条目的检查框是否处于禁止选中状态，返回1表示该条目的检查框处于禁止选中状态，0表示该条目的检查框处于可选择状态 |
| LB_SETITEMDISABLE | 设置指定索引处条目的检查框的状态为禁止选中状态，根据lParam的值设置，为1则设置为禁止选中状态,为0则为可选择状态 |
| LB_MULTIADDITEM | 用于向列表框一次添加多个条目 |
| LB_SETSTRCMPFUNC | 重载默认的排序方式 |
| LB_SETITEMADDDATA | 设置附加的32位数据 |
| LB_GETITEMADDDATA | 获取附加的32位数据 |
| LB_SETITEMHEIGHT | 设定条目所占的高度 |
| LB_GETITEMHEIGHT | 返回条目所占的高度 |
7.3.5 编辑框消息
| 消息 | 含义 |
|---|
| MSG_GETTEXTLENGTH | 获取文本的长度,以字节为单位 |
| MSG_GETTEXT | 获取编辑框中的文本 |
| MSG_SETTEXT | 设置编辑框中的文本内容 |
| EM_GETCARETPOS | 获得当前的插入符位置 |
| EM_SETCARETPOS | 设置插入符的位置 |
| EM_GETSEL | 获取当前被选中的文本 |
| EM_SETSEL | 设置当前被选中的文本 |
| EM_GETSELPOS | 获取当前的选择点位置 |
| EM_GETSELPOS | 用法和EM_GETCARETPOS消息类似 |
| EM_SELECTALL | 使编辑框所有的文本都被选中 |
| EM_COPYTOCB | 把编辑框控件当前选中的文本复制到剪贴板 |
| EM_CUTTOCB | 把剪贴板的文本内容剪切到编辑框 |
| EM_INSERTCBTEXT | 把剪贴板的文本内容复制到编辑框 |
| EM_GETLINEHEIGHT | 获取行的高度 |
| EM_SETLINEHEIGHT | 设置行的高度 |
| EM_GETLINECOUNT | 获取行的数量 |
| EM_LIMITTEXT | 设置编辑框控件的文本上限,以字节为单位 |
| EM_SETREADONLY | 在wParam参数传递TRUE,将使编辑框置于只读状态,而wParam参数传递FALSE,将使编辑框置于正常编辑状态 |
| EM_SETPASSWORDCHAR | 修改密码字符 |
| EM_GETPASSWORDCHAR | 获得当前的密码字符 |
| EM_SETTIPTEXT | 设置编辑框的提示文字 |
| EM_GETTIPTEXT | 获取编辑框的提示文字 |
| EM_SETTITLETEXT | 设置编辑框的标题文字 |
| EM_GETTITLETEXT | 获取编辑框的标题文字 |
| EM_SETLFDISPCHAR | 设置了用于行结束符的显示符号,编辑框将把行结束符显示为所设的显示符号 |
| EM_SETLINESEP | 改变编辑框使用的换行符号 |
| EM_GETNUMOFPARAGRAPHS | 获取文本的段落数目 |
| EM_GETPARAGRAPHLENGTH | 获取某个特定段落的长度,获取成功返回指定段落的长度,失败返回-1 |
| EM_GETPARAGRAPHTEXT | 获取特定段落的文本 |
7.3.6 组合框消息
| 消息 | 含义 |
|---|
| CB_ADDSTRING | 用来向内部列表框中添加条目 |
| CB_INSERTSTRING | 用来向内部列表框中插入条目 |
| CB_DELETESTRING | 用来从内部列表框中删除条目 |
| CB_FINDSTRING | 用于模糊匹配列表框中的条目 |
| CB_FINDSTRINGEXACT | 用于精确匹配列表框中的条目 |
| CB_GETCOUNT | 用于获取内部列表框中的条目个数 |
| CB_GETCURSEL | 用于获取内部列表框的当前选中项 |
| CB_SETCURSEL | 用于设置内部列表框的选中项 |
| CB_RESETCONTENT | 用于清空内部列表框 |
| CB_GETITEMADDDATA | 用于获取内部列表框条目的附加数据 |
| CB_SETITEMADDDATA | 用于设置内部列表框条目的附加数据 |
| CB_GETITEMHEIGHT | 用于获取内部列表框条目的高度 |
| CB_SETITEMHEIGHT | 用于设置内部列表框条目的高度 |
| CB_SETSTRCMPFUNC | 用于设置内部列表框排序用的字符串对比函数 |
| CB_GETLBTEXT | 用于获取内部列表框条目的文本内容 |
| CB_GETLBTEXTLEN | 用于获得内部列表框条目的文本长度 |
| CB_GETCHILDREN | 获得组合框的子控件,wParam返回编辑框控件指针,lParam返回列表框控件指针 |
| CB_LIMITTEXT | 用于限制内部编辑框的文本长度 |
| CB_SETEDITSEL | 用来设置编辑框选中的文本 |
| CB_GETEDITSEL | 用来获取编辑框选中的文本 |
| CB_SPIN | 发送该消息将使旋钮框向前或向后步进,相当于用户单击编辑框旁边的向上或向下箭头(在编辑框中键入向上或向下箭头键,也可取得一样的效果)。wParam控制步进方向,取0为向下,取1为向上 |
| CB_FASTSPIN | 发送该消息将使旋钮框快速向前步进,相当于用户在编辑框中键入PageUp/PageDown键。wParam控制步进方向,取0为向上,取1为向下 |
| CB_GETDROPPEDCONTROLRECT | 获得组合框的下拉列表对应矩形位置 |
| CB_GETDROPPEDSTATE | 检查组合框的下拉列表是否为显示状态 |
| CB_GETSPINRANGE | 获得可取的最大值和最小值,它们分别存储在wParam参数和lParam参数指向的地址中 |
| CB_SETSPINRANGE | 设定可取的最大值和最小值,分别取wParam参数和lParam参数的值 |
| CB_SETSPINVALUE | 参数设置编辑框的当前数值,通过wParam参数传递要设置的值 |
| CB_GETSPINVALUE | 该消息返回当前编辑框内的数值 |
| CB_SPIN | 发送该消息将使旋钮框向前或向后步进,相当于用户单击编辑框旁边的向上或向下箭头(在编辑框中键入向上或向下箭头键,也可取得一样的效果)。wParam控制步进方向,取1为向上,取0为向下。步进值取决于CB_SETSPINPACE的设置值 |
| CB_FASTSPIN | 发送该消息将使旋钮框快速向前步进,相当于用户在编辑框中键入PageUp/PageDown键。wParam控制步进方向,取0为向上,取1为向下。步进值取决于CB_SETSPINPACE的设置值 |
| CB_GETSPINPACE | 获得步进值(wParam)和快速步进值(lParam) |
| CB_SETSPINPACE | 设置步进值(wParam)和快速步进值(lParam) |
| CB_SETSPINFORMAT | 设定整数的格式化字符串。MiniGUI 在内部使用sprintf和sscanf函数在编辑框的文本字符串和整数值之间互相转换。设定格式化字符串之后,MiniGUI在调用sprintf和sscanf函数时将使用这个格式化字符串,使之具有特定的显示格式 |
7.3.7 菜单按钮消息
| 消息 | 含义 |
|---|
| MBM_ADDITEM | 向菜单按钮添加条目，当内存空间不足时,则返回MB_ERR_SPACE |
| MBM_DELITEM | 从菜单按钮中删除条目 |
| MBM_RESETCTRL | 删除所有条目 |
| MBM_SETCURITEM | 设置选中条目,被选中的条目文本将显示在菜单按钮上 |
| MBM_GETCURITEM | 获得当前选中条目的索引号 |
| MBM_GETITEMDATA | 获取菜单项条目的数据 |
| MBM_SETITEMDATA | 设置菜单项条目的数据 |
| MBM_SETSTRCMPFUNC | 设定一个定制的排序函数 |
7.3.8 进度条消息
| 消息 | 含义 |
|---|
| PBM_SETRANGE | 设置进度条的范围，默认情况下的进度条范围是0到100 |
| PBM_SETSTEP | 设置步进长度，默认的进度条步进值是10，当进度条的步进值为负值时,需要设置进度条的位置为进度条范围的最大值 |
| PBM_SETPOS | 设置进度条位置 |
| PBM_DELTAPOS | 在当前进度基础上偏移 |
| PBM_STEPIT | 使进度条前进一个步进值 |
7.3.9 滑块消息
| 消息 | 含义 |
|---|
| TBM_SETRANGE | 通过wParam和lParam参数分别设置滑块的最小值和最大值。默认的范围是0~10 |
| TBM_GETMIN | 获得滑块的最小值 |
| TBM_GETMAX | 获得滑块的最大值 |
| TBM_SETMIN | 设置滑块的最小值 |
| TBM_SETMAX | 设置滑块的最大值 |
| TBM_SETLINESIZE | 通过wParam参数设置滑块的步进值。当用户在滑块拥有输入焦点时按下向上或向下光标键,将使滑块向上或向下移动该步进值。默认的步进值是1 |
| TBM_GETLINESIZE | 获得滑块的步进值 |
| TBM_SETPAGESIZE | 通过wParam参数设置滑块的快速步进值。当用户在滑块拥有输入焦点时按下PageUp和PageDown键,将使滑块分别向上或向下移动该快速步进值。默认的快速步进值是5 |
| TBM_GETPAGESIZE | 获得滑块的快速步进值 |
| TBM_SETPOS | 设置滑块的位置 |
| TBM_GETPOS | 获得滑块的位置 |
| TBM_SETTICKFREQ | 设置刻度间距,默认间距是1 |
| TBM_GETTICKFREQ | 获得刻度间距 |
| TBM_SETTIP | 设置最小值及最大值处的文字说明 |
| TBM_GETTIP | 获取最小值及最大值处的文字说明 |
7.3.10 工具栏消息
| 消息 | 含义 |
|---|
| NTBM_ADDITEM | 向工具栏中添加一个工具项 |
| NTBM_GETITEM | 获取具有指定标识符的工具项信息 |
| NTBM_SETITEM | 设置具有指定标识符的工具项信息 |
| NTBM_ENABLEITEM | 使能或者禁止某个具有指定标识符的工具项 |
| NTBM_SETBITMAP | 改变工具栏上的按钮位图 |
7.3.11 属性表消息
| 消息 | 含义 |
|---|
| PSM_ADDPAGE | 向属性表中添加属性页 |
| MSG_INITPAGE | 类似对话框的MSG_INITDIALOG消息 |
| MSG_SHOWPAGE | 在属性页被隐藏和重新显示时发送到属性页过程中 |
| PSM_SHEETCMD | 属性表控件将向其拥有的所有属性页广播MSG_SHEETCMD消息 |
| PSM_REMOVEPAGE | 删除某个属性页 |
| PSM_GETPAGE | 获得具有某个索引值的属性页的窗口句柄 |
| PSM_GETPAGEINDEX | 根据属性页句柄返回属性页索引值 |
| PSM_GETPAGECOUNT | 返回属性页总个数 |
| PSM_GETTITLELENGTH | 根据wParam参数传入的属性页索引值获得该属性页标题的长度,类似窗口的MSG_GETTEXTLENGTH消息 |
| PSM_GETTITLE | 根据wParam参数传入的属性页索引值获得该属性页标题,并保存在lParam参数传递的缓冲区中,类似窗口的 MSG_GETTEXT消息 |
| PSM_SETTITLE | 根据lParam参数传入的文本字符串设置由wParam指定的属性页标题,类似窗口的MSG_SETTEXT消息 |
| PSM_GETACTIVEPAGE | 返回活动属性页的窗口句柄 |
| PSM_GETACTIVEINDEX | 返回活动属性页的索引值 |
| PSM_SETACTIVEINDEX | 根据wParam传入的属性页索引值设置活动属性页 |
7.3.12 滚动窗口消息
| 消息 | 含义 |
|---|
| SVM_SETCONTRANGE | 设置滚动窗口的内容区域的大小 |
| SVM_SETCONTWIDTH | 设置滚动窗口的宽度 |
| SVM_SETCONTHEIGHT | 设置滚动窗口的高度 |
| SVM_GETCONTWIDTH | 获取内容区域的宽度 |
| SVM_GETCONTHEIGHT | 获取内容区域的高度 |
| SVM_GETVISIBLEWIDTH | 获取内容区域的可视区域宽度 |
| SVM_GETVISIBLEHEIGHT | 获取内容区域的可视区域高度 |
| SVM_GETCONTENTX | 获取内容区域的当前位置X值 |
| SVM_GETCONTENTY | 获取内容区域的当前位置Y值 |
| SVM_SETCONTPOS | 设置内容区域的当前位置值,也就是在可视区域中移动内容区域到某个指定位置 |
| SVM_MAKEPOSVISIBLE | 使内容区域中的某个位置点成为可见 |
| SVM_GETHSCROLLVAL | 获取滚动窗口的当前水平滚动值 |
| SVM_GETVSCROLLVAL | 获取滚动窗口的当前垂直滚动值 |
| SVM_GETHSCROLLPAGEVAL | 获取滚动窗口的当前水平页滚动值 |
| SVM_GETVSCROLLPAGEVAL | 获取滚动窗口的当前垂直页滚动值 |
| SVM_SETSCROLLVAL | 设置滚动窗口的水平和垂直滚动值 |
| SVM_SETSCROLLPAGEVAL | 设置滚动窗口的水平和垂直页滚动值 |
| SVM_ADDCTRLS | 往其中添加子控件 |
| SVM_RESETCONTENT | 重置滚动窗口控件,包括清空其中的子控件和设置内容区域的范围和位置值为默认值 |
| SVM_GETCTRL | 获取滚动窗口控件中的子控件的句柄 |
| SVM_GETFOCUSCHILD | 获取滚动窗口控件中具有键盘焦点的子控件 |
| SVM_SETCONTAINERPROC | 设置新的容器窗口过程,从而达到定制滚动窗口的目的 |
7.3.13 滚动型控件消息
| 消息 | 含义 |
|---|
| SVM_SETITEMDRAW | 设置列表项的绘制函数 |
| SVM_SETITEMOPS | 设置列表项相关操作的一些回调函数,包括初始化、绘制和结束函数 |
| SVM_ADDITEM | 添加一个列表项 |
| SVM_DELITEM | 删除一个列表项 |
| SVM_REFRESHITEM | 刷新一个列表项区域 |
| SVM_GETITEMADDDATA | 获取列表项的附加数据 |
| SVM_SETITEMADDDATA | 设置列表项的附加数据 |
| SVM_GETITEMCOUNT | 获取当前列表项的数量 |
| SVM_RESETCONTENT | 删除掉控件中所有的列表项 |
| SVM_SETCURSEL | 设置控件的高亮列表项 |
| SVM_GETCURSEL | 获取控件的当前高亮列表项 |
| SVM_SELECTITEM | 设置列表项的选中状态 |
| SVM_SHOWITEM | 显示一个列表项 |
| SVM_CHOOSEITEM | 是SVM_SELECTITEM和SVM_SHOWITEM消息的组合,用来选中一个列表项并使之可见 |
| MSG_FREEZE | 在操作之前冻结控件,操作之后解冻 |
| SVM_SETMARGINS | 对滚动型控件的边缘范围进行设置 |
| SVM_GETMARGINS | 获取滚动型控件的边缘范围值 |
| SVM_GETLEFTMARGIN | 获取左边缘值 |
| SVM_GETTOPMARGIN | 获取上边缘值 |
| SVM_GETRIGHTMARGIN | 获取右边缘值 |
| SVM_GETBOTTOMMARGIN | 获取下边缘值 |
7.3.14 树型控件消息
| 消息 | 含义 |
|---|
| TVM_ADDITEM | 插入一个节点项 |
| TVM_DELTREE | 删除一个节点及其所有子项(包括子项的子项) |
| TVM_GETITEMINFO | 获取某个节点项的属性信息 |
| TVM_SETITEMINFO | 设置某个节点项的属性 |
| TVM_GETITEMTEXT | 获取某个节点项的文字标题 |
| TVM_GETITEMTEXTLEN | 获取节点项的文字标题的长度 |
| TVM_SETSELITEM | 选择某个节点项 |
| TVM_GETSELITEM | 获取当前被选择的节点项 |
| TVM_GETROOT | 获取树型控件的根节点 |
| TVM_GETRELATEDITEM | 获取指定节点的相关节点项 |
| TVIR_PARENT | 获取item节点的父节点 |
| TVIR_FIRSTCHILD | 获取item节点的第一个子节点 |
| TVIR_NEXTSIBLING | 获取item节点的下一个兄弟节点 |
| TVIR_PREVSIBLING | 获取item节点的前一个兄弟节点 |
| TVM_SEARCHITEM | 查找某个特定的节点项，整个节点树中查找 |
| TVM_FINDCHILD | 查找节点项的特定子节点，只在子节点中查找 |
| TVM_SETSTRCMPFUNC | 设置新的树型控件字符串比较函数 |
7.3.15 列表型控件消息
| 消息 | 含义 |
|---|
| LVM_ADDCOLUMN | 添加一列或依次添加多列 |
| LVM_GETCOLUMN | 获取列表型控件中某一列的属性 |
| LVM_SETCOLUMN | 设置和修改列的各项属性 |
| LVM_MODIFYHEAD | 是LVM_SETCOLUMN的简化,可以用来设置列表头的标题 |
| LVM_GETCOLUMNWIDTH | 获取某列的宽度 |
| LVM_GETCOLUMNCOUNT | 获取列表型控件中列的数量 |
| LVM_DELCOLUMN | 删除列表型控件中的一列 |
| LVM_SETHEADHEIGHT | 设置列表头的高度 |
| LVM_ADDITEM | 往列表型控件中添加列表项 |
| LVM_FILLSUBITEM | 设置列表项中各个子项的内容 |
| LVM_SETSUBITEM | 设置列表项中各个子项的内容 |
| LVM_GETITEM | 获取一个列表项的信息 |
| LVM_GETITEMCOUNT | 获取列表型控件的列表项数量 |
| LVM_GETITEMADDDATA | 获取列表项的附加数据 |
| LVM_SETITEMADDDATA | 设置列表项的附加数据 |
| LVM_SETITEMHEIGHT | 设置一个列表型控件的列表项高度，如果不设置的话,列表型控件的列表项高度将采用缺省值 |
| LVM_DELITEM | 在列表型控件中删除一个列表项 |
| LVM_DELALLITEM | 删除所有的列表项 |
| LVM_GETSUBITEMTEXT | 获取子项的文字内容 |
| LVM_SETSUBITEMTEXT | 设置子项的文字内容 |
| LVM_GETSUBITEMLEN | 获取子项字符串的长度 |
| LVM_SETSUBITEMCOLOR | 设置子项的文字颜色 |
| LVM_SELECTITEM | 选择一个列表项,被选中的项将高亮显示 |
| LVM_GETSELECTEDITEM | 用来确定当前被选中的列表项 |
| LVM_SHOWITEM | 使一个列表项在列表型控件中成为可见的条目 |
| LVM_CHOOSEITEM | 是LVM_SELECTIEM和LVM_SHOWITEM功能的组合,它使一个列表项被选中而且成为可见的项 |
| LVM_FINDITEM | 在列表型控件中查找一个特定的列表项 |
| LVM_SETCOLUMN | 设置新的比较函数 |
| LVM_SORTIEMS | 使之对列表项进行排序 |
| LVM_COLSORT | 使列表型控件依据某列来进行比较排序 |
| LVM_SETSTRCMPFUNC | 设置自定义的字符串比较函数 |
| LVM_GETRELATEDITEM | 获取一个节点的相关树型节点 |
| LVM_GETRELATEDITEM | 返回所获取到的相关节点的句柄 |
| LVM_FOLDITEM | 折叠或者展开一个包含子节点的节点项 |
7.3.16 月历控件消息
| 消息 | 含义 |
|---|
| MCM_GETCURDAY | 获取当前选择的日期中是当月中的第几天 |
| MCM_GETCURMONTH | 获取当前选择的日期中的月份值 |
| MCM_GETCURYEAR | 获取当前选择日期中的年份 |
| MCM_GETFIRSTWEEKDAY | 确定当前月份中的第一天是星期几 |
| MCM_GETCURDATE | 获取月历控件中当前选择的日期 |
| MCM_GETTODAY | 获取"今天"的日期 |
| MCM_SETCURDAY | 设置当前选择的"天" |
| MCM_SETCURMONTH | 设置当前的月 |
| MCM_SETCURYEAR | 设置当前的年 |
| MCM_SETCURDATE | 设置当前选择的日期 |
| MCM_SETTODAY | 把"今天"设为当前选择的日期 |
| MCM_GETCOLOR | 获取月历控件中各部分的颜色设置 |
| MCM_SETCOLOR | 改变月历控件中各部分的颜色设置 |
| MCM_GETMINREQRECTW | 获取最小宽度值 |
| MCM_GETMINREQRECTH | 获取最小高度值 |
7.3.17 旋钮控件消息
| 消息 | 含义 |
|---|
| SPM_SETINFO | 设置控件的属性和状态 |
| SPM_GETINFO | 获取旋钮控件的属性 |
| SPM_SETCUR | 设置旋钮控件的当前位置值 |
| SPM_GETCUR | 获取当前的位置值 |
| SPM_DISABLEDOWN | 禁止下箭头的滚动能力，仅对没有SPS_AUTOSCROLL风格的旋钮控件有效 |
| SPM_ENABLEDOWN | 恢复下箭头的滚动能力，仅对没有SPS_AUTOSCROLL风格的旋钮控件有效 |
| SPM_DISABLEUP | 禁止上箭头的滚动能力，仅对没有SPS_AUTOSCROLL风格的旋钮控件有效 |
| SPM_ENABLEUP | 恢复上箭头的滚动能力，仅对没有SPS_AUTOSCROLL风格的旋钮控件有效 |
| SPM_SETTARGET | 设置旋钮控件的目标窗口 |
| SPM_GETTARGET | 获取旋钮控件的目标窗口 |
7.3.18 网格控件消息
| 消息 | 含义 |
|---|
| GRIDM_ADDCOLUMN | 往控件中增加列 |
| GRIDM_ADDCOLUMN | 增加网格控件的一列 |
| GRIDM_DELCOLUMN | 删除网格控件中的一列 |
| GRIDM_GETCOLWIDTH | 获取控件列的宽度 |
| GRIDM_GETCOLCOUNT | 获取网格控件中列的数量 |
| GRIDM_SETROWHEIGHT | 设置控件行的高度 |
| GRIDM_GETROWHEIGHT | 获取控件行的高度 |
| GRIDM_ADDROW | 往网格控件中添加一行 |
| GRIDM_DELROW | 删除网格控件中的一行 |
| GRIDM_GETROWCOUNT | 获取网格控件中行的数量 |
| GRIDM_SETCELLPROPERTY | 设置一个或多个单元格 |
| GRIDM_GETCELLPROPERTY | 获得单元格的属性 |
| GRIDM_SETNUMFORMAT | 设置数字单元格(GRIDCELLDATANUMBER)的数字格式 |
| GRIDM_SETSELECTED | 设置高亮的单元格 |
| GRIDM_GETSELECTED | 得到所有高亮的单元格 |
| GRIDM_ADDDEPENDENCE | 往网格控件中添加一个单元格关联 |
| GRIDM_DELDEPENDENCE | 删除网格控件中已有的一个单元格关联 |
7.3.18 酷工具栏消息
| 消息 | 含义 |
|---|
| CBM_ADDITEM | 往工具栏中添加按钮项 |
| CBM_ENABLE | 禁止或恢复某个按钮项 |
7.3.19 动画控件消息
| 消息 | 含义 |
|---|
| ANM_SETANIMATION | 设置ANIMATION对象 |
| ANM_GETANIMATION | 获取当前的ANIMATION对象 |
| ANM_STARTPLAY | 开始播放。在发送ANM_STARTPLAY消息给动画控件之前,动画控件将仅仅显示ANIMATION对象的第一帧图象;只有发送了ANM_STARTPLAY消息之后,动画控件才会按ANIMATION对象中的信息播放动画 |
| ANM_PAUSE_RESUME | 暂停/继续播放。用来暂停动画的播放(正在播放时),或者用来继续动画的播放(已被暂停时) |
| ANM_STOPPLAY | 停止动画的播放。动画控件将返回到ANIMATION的第一帧图象 |
7.3.20 图标型控件消息
| 消息 | 含义 |
|---|
| IVM_ADDITEM | 往该控件中添加图标项 |
| IVM_RESETCONTENT | 对应SVM_RESETCONTENT,用于清空图标型控件中的图标项 |
| IVM_DELITEM | 对应SVM_DELITEM,用于删除图标型控件中的图标项 |
| IVM_SETITEMDRAW | 对应SVM_SETITEMDRAW,用于设置图标项的绘制函数 |
| IVM_SETCONTWIDTH | 对应SVM_SETCONTWIDTH,用于设置滚动窗口的宽度 |
| IVM_SETCONTHEIGHT | 对应SVM_SETCONTHEIGHT,用于设置滚动窗口的高度 |
| IVM_SETITEMOPS | 对应SVM_SETITEMOPS,用于设置图标项相关操作的一些回调函数 |
| IVM_GETMARGINS | 对应SVM_GETMARGINS,用于获取图标型控件的边缘范围值 |
| IVM_SETMARGINS | 对应SVM_SETMARGINS,用于设置图标型控件的边缘范围值 |
| IVM_GETLEFTMARGIN | 对应SVM_GETLEFTMARGIN,用于获取图标型控件中的左边缘值 |
| IVM_GETTOPMARGIN | 对应SVM_GETTOPMARGIN,用于获取图标型控件中的上边缘值 |
| IVM_GETRIGHTMARGIN | 对应SVM_GETRIGHTMARGIN,用于获取图标型控件中的右边缘值 |
| IVM_GETBOTTOMMARGIN | 对应SVM_GETBOTTOMMARGIN,用于获取图标型控件中的下边缘值 |
| IVM_GETCONTWIDTH | 对应SVM_GETCONTWIDTH,用来获取内容区域的宽度 |
| IVM_GETCONTHEIGHT | 对应SVM_GETCONTHEIGHT,用来获取内容区域的高度 |
| IVM_GETVISIBLEWIDTH | 对应SVM_GETVISIBLEWIDTH,用来获取可视区域的宽度 |
| IVM_GETVISIBLEHEIGHT | 对应SVM_GETVISIBLEHEIGHT,用来获取可视区域的高度 |
| IVM_SETCONTRANGE | 对应SVM_SETCONTRANGE,用于设置滚动窗口的内容区域的大小 |
| IVM_GETCONTENTX | 对应SVM_GETCONTENTX,用于获取内容区域的当前位置值 |
| IVM_GETCONTENTY | 对应SVM_GETCONTENTY,用于获取内容区域的当前位置值 |
| IVM_SETCONTPOS | 对应SVM_SETCONTPOS,用于设置内容区域的当前位置值,也就是在可视区域中移动内容区域到某个指定位置 |
| IVM_GETCURSEL | 对应SVM_GETCURSEL,用于获取控件的当前高亮图标项 |
| IVM_SETCURSEL | 对应SVM_SETCURSEL,用于设置控件的当前高亮图标项 |
| IVM_SELECTITEM | 对应SVM_SELECTITEM,用于选择一个列表项,被选中的项将高亮显示 |
| IVM_SHOWITEM | 对应SVM_SHOWITEM,用于显示一个图标项 |
| IVM_CHOOSEITEM | 对应SVM_CHOOSEITEM,是IVM_SELECTITEM和IVM_SHOWITEM消息的组合,用来选中一个图标项并使之可见 |
| IVM_SETITEMINIT | 对应SVM_SETITEMINIT,用于设置图标项的初始操作 |
| IVM_SETITEMDESTROY | 对应SVM_SETITEMDESTROY,用于设置图标项的销毁操作 |
| IVM_SETITEMCMP | 对应SVM_SETITEMCMP,用于设置图标型控件图标项的比较函数 |
| IVM_MAKEPOSVISIBLE | 对应VM_MAKEPOSVISIBLE,用于使内容区域中的某个位置点成为可见 |
| IVM_GETHSCROLLVAL | 对应SVM_GETHSCROLLVAL,用来获取滚动窗口的当前水平滚动值(点击滚动条箭头的滚动范围大小) |
| IVM_GETVSCROLLVAL | 对应SVM_GETVSCROLLVAL,用来获取滚动窗口的当前垂直滚动值(点击滚动条箭头的滚动范围大小) |
| IVM_GETHSCROLLPAGEVAL | 对应SVM_GETHSCROLLPAGEVAL,用来获取滚动窗口的当前水平页滚动值(翻页操作时的滚动范围大小) |
| IVM_GETVSCROLLPAGEVAL | 对应SVM_GETVSCROLLPAGEVAL,用来获取滚动窗口的当前垂直页滚动值(翻页操作时的滚动范围大小) |
| IVM_SETSCROLLVAL | 对应SVM_SETSCROLLVAL,用于设置滚动窗口的水平和(或者)垂直滚动值 |
| IVM_SETSCROLLPAGEVAL | 对应SVM_SETSCROLLPAGEVAL,用于设置滚动窗口的水平和(或者)垂直页滚动值 |
| IVM_SORTITEMS | 对应SVM_SORTITEMS,用于对图标项进行一次性的排序 |
| IVM_GETITEMCOUNT | 对应SVM_GETITEMCOUNT,用于获取当前图标项的数量 |
| IVM_GETITEMADDDATA | 对应SVM_GETITEMADDDATA,用于获取当前图标项的附加信息 |
| IVM_SETITEMADDDATA | 对应SVM_SETITEMADDDATA,用于设置当前图标项的附加信息 |
| IVM_REFRESHITEM | 对应SVM_REFRESHITEM,用于刷新一个图标项区域 |
| IVM_GETFIRSTVISIBLEITEM | 对应SVM_GETFIRSTVISIBLEITEM,用于获取第一个可见的图标项 |
7.3.21 独立滚动条消息
| 消息 | 含义 |
|---|
| SBM_GETSCROLLINFO | 获取滚动条控件的最大值、最小值 |
| SBM_SETSCROLLINFO | 进行滚动条信息设置 |
| SBM_GETPOS | 获取当前游标的位置 |
| SBM_SETPOS | 设置当前游标的位置 |
| SBM_GETRANGE | 获取滚动条滚动范围 |
| SBM_SETRANGE | 设置滚动条滚动范围 |
| SBM_SETRANGEREDRAW | 设置滚动条滚动范围,并立即重绘 |
| SBM_ENABLE_ARROW | 启用或者禁用滚动条箭头 |
8 通知码
8.1 滚动条通知码
| 标识符 | 含义 |
|---|
| SB_LINEUP | 鼠标点击竖直按钮的上箭头1次 |
| SB_LINEDOWN | 鼠标点击竖直滚动条的下箭头1次 |
| SB_LINELEFT | 鼠标点击水平滚动条的左箭头1次 |
| SB_LINERIGHT | 鼠标点击水平滚动条的右箭头1次 |
| SB_PAGEUP | 鼠标点击竖直按钮的上箭头与滑块之间的区域1次 |
| SB_PAGEDOWN | 鼠标点击竖直按钮的下箭头与滑块之间的区域1次 |
| SB_PAGELEFT | 鼠标点击水平按钮的左箭头与滑块之间的区域1次 |
| SB_PAGERIGHT | 鼠标点击水平按钮的右箭头与滑块之间的区域1次 |
| SB_THUMBTRACK | 鼠标拖动滑块移动时窗口不断地收到的消息,注意,该值表示对鼠标位置经换算后对应的数值(通过lParam传递的),该值有可能大于设置的最大值,也有可能<小于设置的最小值,在程序中需要作相应的判断 |
| SB_THUMBPOSITION | 用户拖动滑块结束 |
8.2 静态框通知码
| 标识符 | 含义 |
|---|
| STN_DBLCLK | 用户在静态框内双击了鼠标左键 |
| STN_CLICKED | 用户在静态框内单击了鼠标左键 |
8.3 按钮通知码
| 标识符 | 含义 |
|---|
| BN_CLICKED | 表明用户单击此按钮 |
| BN_PUSHED | 表明用户将此按钮按下 |
| BN_UNPUSHED | 表明用户将此按钮释放 |
| BN_DBLCLK | 表明用户在此按钮上进行了鼠标左键的双击操作 |
| BN_SETFOCUS | 表明按钮获得了输入焦点 |
| BN_KILLFOCUS | 表明按钮失去了输入焦点 |
8.4 列表通知码
| 标识符 | 含义 |
|---|
| LBN_ERRSPACE | 内存分配失败 |
| LBN_SELCHANGE | 单项选择列表框的当前选择项发生变化 |
| LBN_CLICKED | 用户在列表框某条目上单击了鼠标左键 |
| LBN_DBLCLK | 用户在列表框某条目上双击了鼠标左键 |
| LBN_SELCANCEL | 用户取消了某个条目的选择 |
| LBN_SETFOCUS | 列表框获得了输入焦点 |
| LBN_KILLFOCUS | 列表框失去了输入焦点 |
| LBN_CLICKCHECKMARK | 用户单击了条目的检查框 |
| LBN_ENTER | 用户在列表框中按下ENTER键 |
8.5 编辑框通知码
| 标识符 | 含义 |
|---|
| EN_SETFOCUS | 编辑控件已经获得输入焦点 |
| EN_KILLFOCUS | 编辑控件已经失去输入焦点 |
| EN_CHANGE | 编辑控件的内容已经改变 |
| EN_UPDATE | 编辑控件在接收到MSG_SETTEXT,EM_RESETCONTENT或EM_SETLINEHEIGHT消息后,内容已经改变 |
| EN_ENTER | 用户在编辑框中按下了Enter键 |
| EN_MAXTEXT | 编辑控件在插入时超出了限定长度 |
| EN_DBLCLK | 编辑控件被鼠标左键双击 |
| EN_CLICKED | 编辑控件被鼠标左键点击 |
8.6 组合框通知码
| 标识符 | 含义 |
|---|
| CBN_ERRSPACE | 内存不足 |
| CBN_SELCHANGE | 条目选择变化 |
| CBN_EDITCHANGE | 方框区域的文本发生了变化 |
| CBN_DBLCLK | 用户双击了组合框中的某个条目 |
| CBN_CLICKED | 用户点击了组合框 |
| CBN_SETFOCUS | 组合框获得了输入焦点。如果组合框具有CBS_AUTOFOCUS风格,则内部编辑框将同时获得输入焦点 |
| CBN_KILLFOCUS | 组合框失去了输入焦点 |
| CBN_DROPDOWN | 用户下拉列表框使之显示。当用户点击编辑框旁边的向下箭头按钮或者在编辑框中键入光标控制键,比如向下、向上箭头键,PageDown或者PageUp等键时,也会下拉并显示列表框 |
| CBN_CLOSEUP | 下拉的列表框被隐藏(关闭) |
| CBN_SELENDOK | 用户从下拉列表框中选择了某个条目 |
| CBN_SELENDCANCEL | 用户未选择任何条目而关闭下拉列表框 |
8.7 菜单按钮通知码
| 标识符 | 含义 |
|---|
| MBN_ERRSPACE | 内存分配失败,存储空间不足 |
| MBN_SELECTED | 对菜单按钮控件进行了选择。不管前后选择的菜单项是否改变,均会产生该通知消息 |
| MBN_CHANGED | 菜单按钮控件的选择项发生了变化 |
| MBN_STARTMENU | 用户激活了菜单按钮的弹出式菜单 |
| MBN_ENDMENU | 弹出式菜单关闭 |
8.8 进度条通知码
| 标识符 | 含义 |
|---|
| PBN_REACHMAX | 已到达最大进度位置 |
| PBN_REACHMIN | 已到达最小进度位置 |
8.9 滑块通知码
| 标识符 | 含义 |
|---|
| TBN_CHANGE | 滑块的位置发生了变化 |
| TBN_REACHMAX | 已到达了上限 |
| TBN_REACHMIN | 已到达了下限 |
8.10 属性表通知码
| 标识符 | 含义 |
|---|
| PSN_ACTIVE_CHANGED | 当属性表中的活动属性页发生变化时,属性表控件将产生该通知消息 |
8.11 滚动型控件通知码
| 标识符 | 含义 |
|---|
| SVN_SELCHANGED | 当前高亮列表项发生改变 |
| SVN_CLICKED | 用户点击列表项 |
| SVN_SELCHANGING | 当前高亮列表项正发生改变 |
8.12 树型控件通知码
| 标识符 | 含义 |
|---|
| TVN_SELCHANGE | 当前选择的节点项发生改变 |
| TVN_DBLCLK | 用户双击节点项 |
| TVN_SETFOCUS | 树型控件获得焦点 |
| TVN_KILLFOCUS | 树型控件失去焦点 |
| TVN_CLICKED | 用户单击节点项 |
| TVN_ENTER | 用户按下回车键 |
| TVN_FOLDED | 节点项被折叠 |
| TVN_UNFOLDED | 节点项被展开 |
8.13 列表型控件通知码
| 标识符 | 含义 |
|---|
| LVN_ITEMRDOWN | 用户鼠标右键在列表项上按下 |
| LVN_ITEMRUP | 用户鼠标右键在列表项上抬起 |
| LVN_HEADRDOWN | 用户鼠标右键在表头上按下 |
| LVN_HEADRUP | 用户鼠标右键在表头上抬起 |
| LVN_KEYDOWN | 键按下 |
| LVN_ITEMDBCLK | 用户双击某个列表项 |
| LVN_ITEMCLK | 用户单击某个列表项(保留) |
| LVN_SELCHANGE | 当前选择的列表项改变 |
| LVN_FOLDED | 用户鼠标点击某个列表项,使之折叠 |
| LVN_UNFOLDED | 用户鼠标点击某个列表项,使之展开 |
| LVN_SELCHANGE | 鼠标右键在列表项上按下时,该项将被选中 |
| LVN_ITEMRDOWN | 鼠标右键在列表项上按下时,该项将被选中 |
8.14 月历控件通知码
| 标识符 | 含义 |
|---|
| MCN_DATECHANGE | 当用户点击月历控件并造成当前日期发生改变时 |
8.15 旋钮控件通知码
| 标识符 | 含义 |
|---|
| SPN_REACHMAX | 旋钮控件在大于等于最大位置时 |
| SPN_REACHMIN | 旋钮控件在小于等于最小位置时 |
8.16 网格控件通知码
| 标识符 | 含义 |
|---|
| GRIDN_HEADLDOWN | 用户鼠标左键在表头上按下 |
| GRIDN_HEADLUP | 用户鼠标左键在表头上抬起 |
| GRIDN_KEYDOWN | 键按下 |
| GRIDN_CELLDBCLK | 用户双击某个单元格 |
| GRIDN_CELLCLK | 用户单击某个单元格 |
| GRIDN_FOCUSCHANGED | 当前选择的单元格改变 |
| GRIDN_CELLTEXTCHANGED | 单元格内容改变 |
8.17 图标型控件通知码
| 标识符 | 含义 |
|---|
| LVN_SELCHANGE | 对应SVN_SELCHANGE,当前高亮图表项发生改变 |
| LVN_CLICKED | 对应SVN_CLICKED,用户点击图标项 |
8.18 独立滚动条通知码
| 标识符 | 含义 |
|---|
| SB_LINEUP | 垂直滚动条向上滚一行 |
| SB_LINEDOWN | 垂直滚动条向下滚一行 |
| SB_PAGEUP | 垂直滚动条向上滚一页 |
| SB_PAGEDOWN | 垂直滚动条向下滚一页 |
| SB_LINELEFT | 水平滚动条向左滚一列 |
| SB_LINERIGHT | 水平滚动条向右滚一列 |
| SB_PAGELEFT | 水平滚动条向左滚一列页 |
| SB_PAGERIGHT | 水平滚动条向右滚一页 |
| SB_THUMBPOSITION | 当游标被鼠标左键按住拖动,然后释放,此时的游标位置将由此通知码传给父窗口 |
| SB_THUMBTRACK | 当游标被鼠标左键按住,在拖动游标的过程中,游标的位置将由此通知码不断的传给父窗口 |
| SB_TOP | 游标到了水平滚动条的最左边或者是垂直滚动条的最上边,即到了滚动条的最小值 |
| SB_BOTTOM | 游标到了水平滚动条的最右边或者是垂直滚动条的最下边,即到了滚动条的最大值 |
9 发送和投递消息
9.1 窗口消息函数
| 函数 | 含义 |
|---|
| PostMessage | 该函数将消息放到指定窗口的消息队列后立即返回。这种发送方式称为"邮寄"消息。如果消息队列中的邮寄消息缓冲区已满,则该函数返回错误值。在下一个消息循环中,由GetMessage函数获得这个消息之后,窗口才会处理该消息PostMessage一般用于发送一些非关键性的消息。比如在MiniGUI中,鼠标和键盘消息就是通过PostMessage函数发送的 |
| SendMessage | 应用程序一般通过发送一条消息来通知窗口过程立即完成某项任务。该函数和PostMessage函数不同,它把一条消息发送给指定窗口的窗口过程,而且等待该窗口过程完成消息的处理之后才会返回。当需要知道某个消息的处理结果时,使用该函数发送消息,然后根据其返回值进行处理。在MiniGUI-Threads当中,如果发送消息的线程和接收消息的线程不是同一个线程,发送消息的线程将阻塞并等待另一个线程的处理结果,然后继续运行;如果发送消息的线程和接收消息的线程是同一个线程,则与MiniGUI-Processes的SendMessage一样,直接调用接收消息窗口的窗口过程函数 |
| SendNotifyMessage | 该函数和PostMessage消息类似,也是不等待消息被处理即返回。但和PostMessage消息不同,通过该函数发送的消息不会因为缓冲区满而丢失,因为系统采用链表的形式处理这种消息。通过该函数发送的消息称为"通知消息",一般用来从控件向其父窗口发送通知消息 |
| PostQuitMessage | 该消息在消息队列中设置一个QS_QUIT标志。GetMessage在从指定消息队列中获取消息时,会检查该标志,如果有QS_QUIT标志,GetMessage消息将返回FALSE,从而可以利用该返回值终止消息循环 |
| BroadcastMessage | 该函数将指定消息广播给桌面上的所有主窗口 |
| ThrowAwayMessages | 该函数丢弃和指定窗口相关的消息队列中的所有消息,并返回所丢弃的消息个数。 |
| WaitMessage | 该函数等待主窗口消息队列中的消息,消息队列中一有消息就返回。不同于GetMessage,这个函数并不从消息队列中移走消息 |
| TranslateMessage | 把击键消息转换为MSG_CHAR消息,然后直接发送到窗口过程函数 |
| DispatchMessage | 最终把消息发往消息的目标窗口的窗口过程 |
| GetMessage | 调用从应用程序的消息队列中取出一个消息 |
| NotifyParentEx | 发送控件通知消息 |
10.2 进程/线程间通信
10.2.1 异步事件处理
MAX_NR_LISTEN_FD 宏定义了系统能够监听的最多文件描述符数,默认定义为5
| 函数 | 含义 |
|---|
| RegisterListenFD | 函数在系统当中注册一个需要监听的文件描述符,并指定监听的事件类型(type参数,可取POLLIN、POLLOUT或者POLLERR),接收MSG_FDEVENT消息的窗口句柄以及一个上下文信息 |
| UnregisterListenFD | 函数注销一个被注册的监听文件描述符 |
10.2.2 简单请求/应答处理
| 函数 | 含义 |
|---|
| ClientRequest | 向服务器发送请求 |
| ServerSendReply | 将结果发送给客户 |
| RegisterRequestHandler | 服务器可以通过调用该函数注册一些请求处理函数 |
| GetRequestHandler | 获取到处理函数 |
10.2.3 UNIX Domain Socket封装
| 函数 | 含义 | 备注 |
|---|
| serv_listen | 服务器调用该函数建立一个监听套接字,并返回套接字文件描述符 | 建议将服务器监听套接字建立在/var/tmp/目录下 |
| serv_accept | 服务器调用该函数接受来自客户的连接请求 | |
| cli_conn | 客户调用该函数连接到服务器,其中name是客户的监听套接字 | 该函数为客户建立的套接字将保存在/var/tmp/目录中,并且以-c的方式命名,其中c是用来区别不同套接字通讯用途的字母,由project参数指定。MiniGUI-Processes内部使用了 'a',所以由应用程序建立的套接字,应该使用除'a'之外的字母 |
| sock_write_t | 在建立并连接之后,客户和服务器之间就可以使用sock_write_t函数和sock_read_t函数进行数据交换 | 和系统调用write类似,但可以传递进入一个超时参数,注意该参数以10ms为单位,为零时超时设置失效,且超时设置只在mginit程序中有效 |
| sock_read_t | 和系统调用read类似,但可以传递进入一个超时参数 | 注意该参数以10ms为单位,为零时超时设置失效,且超时设置只在mginit程序中有效 |
| sock_write | sock_write_t的宏定义，超时时间为零 | |
| sock_read | sock_read_t的宏定义，超时时间为零 | |
11 界面外观及特效
11.1 窗口属性操作函数
| 函数 | 含义 | 备注 |
|---|
| GetWindowElementAttr | 获取指定窗口的某个元素属性的属性值 | we_attr_id是窗口元素属性ID |
| SetWindowElementAttr | 设置窗口的某个元素属性的属性值 | |
| GetWindowElementPixelEx | 获取窗口元素的颜色值 | |
| SetWindowElementRenderer | 设置当前窗口的渲染器 | werdr_name为所要设置的渲染器的名字,we_attrs是修改的窗口属性的结构体数组 |
| GetWindowRendererFromName | 通过名称获取渲染器 | |
| AddWindowElementRenderer | 添加渲染器到MiniGUI | |
| RemoveWindowElementRenderer | 从MiniGUI删除渲染器 | |
| GetDefaultWindowElementRenderer | 获取默认渲染器 | |
| SetDefaultWindowElementRenderer | 设置默认渲染器 | |
| SetWindowElementRenderer | 指定窗口渲染器 | |
11.2 窗口元素属性名称
| 配置文件中的名称 | 代码名称 | 说明 |
|---|
| caption | WE_METRICS_CAPTION | 窗口标题栏大小 |
| WE_FONT_CAPTION | 窗口标题栏字体 |
| fgc_active_caption | WE_FGC_ACTIVE_CAPTION | 焦点状态窗口标题栏前景色 |
| bgca_active_caption | WE_BGCA_ACTIVE_CAPTION | 焦点状态窗口标题栏背景渐变起始色 |
| bgcb_active_caption | WE_BGCB_ACTIVE_CAPTION | 焦点状态窗口标题栏背景渐变终止色 |
| fgc_inactive_caption | WE_FGC_INACTIVE_CAPTION | 非焦点状态窗口标题栏前景色 |
| bgca_inactive_caption | WE_BGCA_INACTIVE_CAPTION | 非焦点状态窗口标题栏背景色渐变起始色 |
| bgcb_inactive_caption | WE_BGCB_INACTIVE_CAPTION | 非焦点状态窗口标题栏背景色渐变终止色 |
| menu | WE_METRICS_MENU | 菜单项、菜单栏的高度 |
| | WE_FONT_MENU | 菜单字体 |
| fgc_menu | WE_FGC_MENU | 菜单前景色 |
| bgc_menu | WE_BGC_MENU | 菜单背景色 |
| border | WE_METRICS_WND_BORDER | 窗口边框宽度 |
| fgc_active_border | WE_FGC_ACTIVE_WND_BORDER | 焦点状态窗口边框颜色 |
| fgc_inactive_border | WE_FGC_INACTIVE_WND_BORDER | 非焦点状态窗口边框颜色 |
| scrollbar | WE_METRICS_SCROLLBAR | 滚动条大小 |
| fgc_msgbox | WE_FGC_MESSAGEBOX | 消息框前景色 |
| | WE_FONT_MESSAGEBOX | 消息框字体 |
| fgc_tip | WE_FGC_TOOLTIP | 提示框前景色 |
| bgc_tip | WE_BGC_TOOLTIP | 提示框背景色 |
| WE_FONT_TOOLTIP | 提示框字体 |
| fgc_window | WE_FGC_WINDOW | 窗口前景色 |
| bgc_window | WE_BGC_WINDOW | 窗口背景色 |
| fgc_3dbox | WE_FGC_THREED_BODY | 三维立体框表面上符号的颜色,如对勾、箭头等的颜色 |
| mainc_3dbox | WE_MAINC_THREED_BODY | 三维立体框边框及表面颜色 |
| fgc_selected_item | WE_FGC_SELECTED_ITEM | 选定菜单项(列表项)的前景色 |
| bgc_selected_item | WE_BGC_SELECTED_ITEM | 选定菜单项(列表项)的背景色 |
| bgc_selected_lostfocus | WE_BGC_SELECTED_LOSTFOCUS | 选定菜单项(列表项)失去焦点后的背景色 |
| fgc_disabled_item | WE_FGC_DISABLED_ITEM | 无效菜单项(列表项)的前景色 |
| bgc_disabled_item | WE_BGC_DISABLED_ITEM | 无效菜单项(列表项)的背景色 |
| fgc_hilight_item | WE_FGC_HIGHLIGHT_ITEM | 高亮菜单项(列表项)的前景色 |
| bgc_hilight_item | WE_BGC_HIGHLIGHT_ITEM | 高亮菜单项(列表项)的背景色 |
| fgc_significant_item | WE_FGC_SIGNIFICANT_ITEM | 重要菜单项(列表项)的前景色 |
| bgc_significant_item | WE_BGC_SIGNIFICANT_ITEM | 重要菜单项(列表项)的背景色 |
| bgc_desktop | WE_BGC_DESKTOP | 桌面背景色 |
11.3 窗口皮肤属性名称
| 配置文件中的名称 | 代码名称 | 说明 |
|---|
| skin_bkgnd | WE_LFSKIN_WND_BKGND | 桌面背景皮肤图片 |
| skin_caption | WE_LFSKIN_CAPTION | 窗口标题栏皮肤图 |
| skin_caption_btn | WE_LFSKIN_CAPTION_BTN | 窗口标题栏按钮皮肤图片 |
| skin_scrollbar_hshaft | WE_LFSKIN_SCROLLBAR_HSHAFT | 水平滚动条滚槽皮肤图片 |
| skin_scrollbar_vshaft | WE_LFSKIN_SCROLLBAR_VSHAFT | 垂直滚动条滚槽皮肤图片 |
| skin_scrollbar_hthumb | WE_LFSKIN_SCROLLBAR_HTHUMB | 水平滚动条游标皮肤图片 |
| skin_scrollbar_vthumb | WE_LFSKIN_SCROLLBAR_VTHUMB | 垂直滚动条游标皮肤图片 |
| skin_scrollbar_arrows | WE_LFSKIN_SCROLLBAR_ARROWS | 滚动条箭头皮肤图 |
| skin_tborder | WE_LFSKIN_BORDER_TOP | 顶部边框皮肤图片 |
| skin_bborder | WE_LFSKIN_BORDER_BOTTOM | 底部边框皮肤图片 |
| skin_lborder | WE_LFSKIN_BORDER_LEFT | 左边边框皮肤图片 |
| skin_rborder | WE_LFSKIN_BORDER_RIGHT | 右边边框皮肤图片 |
| skin_arrows | WE_LFSKIN_ARROWS | 箭头皮肤图片 |
| skin_arrows_shell | WE_LFSKIN_ARROWS_SHELL | 肩头外围皮肤图片 |
| skin_pushbtn | WE_LFSKIN_PUSHBUTTON | PUSH 按钮皮肤图 |
| skin_radiobtn | WE_LFSKIN_RADIOBUTTON | 单选按钮皮肤图片 |
| skin_checkbtn | WE_LFSKIN_CHECKBUTTON | 复选按钮皮肤图片 |
| skin_tree | WE_LFSKIN_TREE | 树控件皮肤图片 |
| skin_header | WE_LFSKIN_HEADER | 表头皮肤图片 |
| skin_tab | WE_LFSKIN_TAB | 属性页皮肤图片 |
| skin_tbslider_h | WE_LFSKIN_TBSLIDER_H | 水平滑动条皮肤图 |
| skin_tbslider_v | WE_LFSKIN_TBSLIDER_V | 垂直滑动条皮肤图 |
| skin_trackbar_horz | WE_LFSKIN_TRACKBAR_HORZ | 水平轨迹条皮肤图 |
| skin_trackbar_vert | WE_LFSKIN_TRACKBAR_VERT | 垂直轨迹条皮肤图 |
| skin_progressbar_htrack | WE_LFSKIN_PROGRESS_HTRACKBAR | 水平进度条滑轨皮肤图片 |
| skin_progressbar_vtrack | WE_LFSKIN_PROGRESS_VTRACKBAR | 垂直进度条滑轨皮肤图片 |
| skin_progressbar_hchunk | WE_LFSKIN_PROGRESS_HCHUNK | 水平进度条滑块皮肤图片 |
| skin_progressbar_vchunk | WE_LFSKIN_PROGRESS_VCHUNK | 垂直进度条滑块皮肤图片 |
11.4 渲染器结构体成员
| 成员名称 | 说明 |
|---|
| name | 渲染器名称,长度为LEN_RENDERER_NAM。宏LEN_RENDERER_NAME定义为15 |
| init | 渲染器初始化函数指针。用来初始化渲染器的基本信息,包括窗口元素的尺寸、字体、颜色等窗口属性信息和渲染器私有信息。 |
| deinit | 渲染器销毁函数指针。用来释放渲染器所占用的资源。 |
| calc_3dbox_color | 三维立体颜色计算函数指针，此函数根据三维立体边框和表面颜色color和计算标志flag获取一个颜色值 |
| draw_3dbox | 三维立体框绘制函数指针 |
| draw_radio | 单选框绘制函数指针 |
| draw_checkbox | 非选中复选框绘制函数指针 |
| draw_checkmark | 选中复选框绘制函数指针 |
| draw_arrow | 箭头绘制函数指针 |
| draw_fold | 打开的或者是关闭的文件夹、树控件的缩进、展开标志的绘制函数指针 |
| draw_focus_frame | 焦点方框绘制函数指针 |
| draw_normal_item | 无效状态的列表框子项的绘制函数指针 |
| draw_significant_item | 需重点标识的列表框子项的绘制函数指针 |
| draw_push_button | PUSH按钮绘制函数指针 |
| draw_radio_button | 单选按钮绘制函数指针 |
| draw_check_button | 复选框按钮绘制函数指针 |
| draw_border | 窗口边框绘制函数指针 |
| draw_caption | 窗口标题栏绘制函数指针 |
| draw_caption_button | 窗口标题栏按钮绘制函数指针。标题栏按钮包括:最小化按钮、最大化按钮、关闭按钮 |
| draw_scrollbar | 滚动条绘制函数指针 |
| calc_trackbar_rect | 轨迹条外框绘制函数指针 |
| draw_trackbar | 轨迹条绘制函数指针 |
| calc_we_area | 窗口各元素区域计算函数指针。元素区域包括边框、标题栏、标题栏按钮、工具栏、菜单、客户区、窗口水平滚动条和垂直滚动条 |
| calc_we_metrics | 窗口各元素尺寸的计算函数指针。所包含的元素与calc_we_area函数所包含的元素相同 |
| hit_test | 获取鼠标所点击的窗口元素的函数指针 |
| on_click_hotspot | 当鼠标点击到热点区域时,进行相应处理的函数指针 |
| draw_custom_hotspot | 热点区域的绘制函数指针 |
| calc_thumb_area | 水平滚动条和垂直滚动条游标区域的计算函数指针 |
| disabled_text_out | 无效区域文字的输出函数指针 |
| draw_tab | 属性页控件标签的绘制函数指针 |
| draw_progress | 进度条绘制函数 |
| draw_header | 列表框或者网格控件的表头绘制函数指针 |
| on_get_rdr_attr | 渲染器私有信息获取函数指针 |
| on_set_rdr_attr | 渲染器私有信息设置函数指针 |
| erase_background | 窗口背景擦除绘制函数指针 |
| draw_normal_menu_item | 正常状态菜单项绘制函数指针 |
| draw_hilite_menu_item | 高亮状态菜单项绘制函数指针 |
| draw_disabled_menu_item | 无效状态菜单项绘制函数指针 |
| we_metrics | 窗口尺寸属性 |
| we_colors | 窗口颜色属性 |
| we_fonts | 窗口字体属性 |
| we_icon | 窗口所使用的图标句柄 |
| refcount | 渲染器引用计数 |
| private_info | 渲染器私有信息指针 |
11.5 双缓冲区操作函数
| 函数 | 含义 | 备注 |
|---|
| CreateSecondaryDC | 双缓冲区DC创建函数 | 根据传入的窗口大小,创建兼容的内存DC并返回 |
| SetSecondaryDC | 将已经创建好的内存DC设置为目标主窗口的双缓冲区,并设置从双缓冲区的屏幕DC数据复制回调函数 | |
| GetSecondaryDC | 双缓冲区句柄获取函数 | |
| GetSecondaryClientDC | 该函数用于双缓冲窗体的客户区绘制DC，如果窗体不支持双缓冲,则直接返回一般的客户区DC,相当于调用GetClientDC | |
| ReleaseSecondaryDC | 该函数用于释放双缓冲DC,如果是主窗体本身的双缓冲DC,则什么也不处理;否则释该DC | |
| DeleteSecondaryDC | 该函数删除由CreateSecondaryDC创建的内存DC | |
| GetSecondarySubDC | 该函数仅针对双缓冲,在私有窗口DC基础上创建子DC | 使之可以作为主窗口的客户DC,或者控件的DC使用 |
| ReleaseSecondarySubDC | 该函数释放私有DC的子DC | |
在调用 SetSecondaryDC 函数时要注意以下几点
- 如果主窗口具有WS_EX_AUTOSecondaryDC风格,则会取消该风格,并调用 DeleteSecondaryDC函数删除已有的双缓冲区,并返回HDC_SCREEN
- 如果主窗口没有WS_EX_AUTOSecondaryDC风格,则返回原先的双缓冲区句柄。原先的双缓冲区由应用程序自行管理
- 如果传入HDC_SCREEN,将取消窗口的双缓冲机制
- 如果调用该函数时,传递进入的ON_UPDATE_SecondaryDC回调函数为NULL,则这时MiniGUI不会自动完成屏幕DC到屏幕的显示的绘制,用户需要使用基本的块拷贝函数完成双缓冲区到屏幕DC的复制;否则调用该回调函数由应用程序负责从双缓冲区到屏幕DC的复制,应用程序可在此时完成界面特效
12 图形设备接口
12.1 设备上下文句柄
| 函数 | 含义 | 备注 |
|---|
| BeginPaint | 接收到MSG_PAINT消息时，获取句柄 | |
| EndPaint | 绘制结束之后，释放设备上下文句柄 | |
| GetDC | 获取的设备上下文是针对整个窗口的 | 避免同时使用多个设备上下文,并避免在递归函数中调用 |
| GetSubDC | 获取指定DC的兼容子DC | |
| GetClientDC | 获取的设备上下文是针对窗口客户区 | |
| ReleaseDC | 释放上面三个函数获取的设备上下文 | |
| CreatePrivateDC | 创建私有设备环境上下文，如果主窗口的扩展风格中指定了WS_EX_USEPRIVATECDC风格,则CreateMainWindow函数会自动为该窗口的客户区建立私有设备上下文 | |
| CreatePrivateSubDC | 创建私有设备环境上下文的兼容子DC | |
| CreatePrivateClientDC | 创建客户区私有设备环境上下文，如果控件类具有CS_OWNDC属性,则所有属于该控件类的控件将自动建立私有设备上下文 | |
| GetPrivateClientDC | 获取私有设备环境上下文 | |
| DeletePrivateDC | 删除私有设备环境上下文，自动创建的，系统将在销毁窗口时自动调用 | |
| SaveDC | 保存设备环境上下文 | |
| RestoreDC | 恢复设备环境上下文 | |
| CreateCompatibleDCEx | 内存设备上下文的创建，在系统内存中建立一个类似显示内存的区域,然后在该区域中进行绘图操作,结束后再复制到显示内存中 | 速度很快,减少直接操作显存造成的闪烁现象 |
| CreateCompatibleDC | 内存设备上下文的创建，在系统内存中建立一个类似显示内存的区域,然后在该区域中进行绘图操作,结束后再复制到显示内存中 | |
| CreateMemDC | 指定新建内存DC的高度、宽度、颜色深度,以及必要的RGBA组成方式 | |
| ConvertMemDC | 将一个任意的内存DC对象,根据给定的参考DC的象素格式进行转换 | |
| DeleteMemDC | 删除创建的内存设备上下文 | |
| DeleteCompatibleDC | 删除创建的内存设备上下文 | |
| SetMemDCAlpha | 设定或者取消整个内存DC对象的Alpha通道值 | Alpha通道值作用在DC的所有象素点上 |
| SetMemDCColorKey | 设定或者取消整个内存DC对象的ColorKey | 即透明象素值 |
| CreateMemDCFromBitmap | 创建一个指向设备相关位图并和指定DC兼容的内存DC | |
| CreateMemDCFromMyBitmap | 创建指向设备无关位图的内存DC | |
| LockDC | 锁定给定HDC的指定矩形区域,然后返回缓冲区头指针 | |
| UnlockDC | 解开已锁定的HDC | |
| InitSlaveScreen | 创建副屏 | 可以根据指定的引擎和显示模式构造打开双屏并返回一个图形设备上下文句柄 |
| TerminateSlaveScreen | 销毁副屏 | hdc 参数是InitSlaveScreen函数返回的表示副屏的图形设备上下文句柄 |
12.2 矩形/区域/剪切域操作
| 函数 | 含义 | 备注 |
|---|
| SetRect | 对RECT对象的各个分量进行赋值 | |
| SetRectEmpty | 将RECT对象设置为空 | |
| IsRectEmpty | 判断给定RECT对象是否为空 | |
| NormalizeRect | 对给定矩形进行正规化处理 | 满足(right>left并且 bottom>top) |
| CopyRect | 复制矩形 | |
| EqualRect | 判断两个RECT对象是否相等 | |
| IntersectRect | 求两个RECT对象之交集 | 不相交,返回FALSE |
| DoesIntersect | 仅仅判断两个矩形是否相交 | |
| IsCovered | 判断对象A是否全部覆盖对象B | |
| UnionRect | 求两个矩形之并 | 不相并,返回FALSE |
| GetBoundRect | 求两个矩形的外包最小矩形 | |
| SubstractRect | 从一个矩形中减去另外一个矩形 | |
| OffsetRect | 对给定的RECT对象进行平移处理 | |
| InflateRect | 对给定的RECT对象进行膨胀处理 | 给定膨胀值的两倍 |
| InflateRectToPt | 将给定的RECT对象膨胀到指定的点 | |
| PtInRect | 判断给定的点是否位于指定的RECT中 | |
| SetClipRgn | 将剪切域设为仅包含一个矩形的剪切域 | |
| ClipRgnCopy | 复制剪切域 | |
| ClipRgnIntersect | 求两个剪切域的交集 | |
| GetClipRgnBoundRect | 求剪切域的外包最小矩形 | |
| IsEmptyClipRgn | 判断剪切域是否为空 | |
| EmptyClipRgn | 释放剪切域中的剪切矩形,并清空剪切域 | |
| AddClipRect | 将一个剪切矩形追加到剪切域中 | |
| IntersectClipRect | 求剪切区域和给定矩形相交的剪切区域 | |
| SubtractClipRect | 从剪切区域中减去指定的矩形 | |
| CreateClipRgn | 创建一个剪切区域 | |
| DestroyClipRgn | 清空并且销毁一个剪切区域 | |
| ExcludeClipRect | 从设备上下文的当前可见区域中排除给定的矩形区域 | 设备上下文的可见区域将缩小 |
| IncludeClipRect | 向当前设备上下文的可见区域中添加一个矩形区域 | 设备上下文的可见区域将扩大 |
| ClipRectIntersect | 将设备上下文的可见区域设置为已有区域和给定矩形区域的交集 | |
| SelectClipRect | 将设备上下文的可见区域重置为一个矩形区域 | |
| SelectClipRegion | 将设备上下文的可见区域设置为一个指定的区域 | |
| GetBoundsRect | 获取当前可见区域的外包最小矩形 | |
| PtVisible | 判断给定的点是否可见 | |
| RectVisible | 判断给定的矩形是否可见 | |
| PtInRegion | 检查给定点是否位于给定的区域中 | |
| RectInRegion | 检查给定矩形是否和给定区域相交 | |
| OffsetRegionEx | 将剪切域处于两个矩形区域的重叠区的剪切矩形进行位移 | |
| OffsetRegion | 对剪切域简单的进行位移 | |
| IntersectRegion | 对两个给定区域进行求交运算 | |
| UnionRegion | 合并两个不同的区域 | |
| SubtractRegion | 从一个区域中减去另外一个区域 | |
| XorRegion | 对两个区域进行异或运算 | |
| GetRasterOperation | 获取当前的光栅操作 | |
| SetRasterOperation | 设置当前的光栅操作 | |
12.3 像素与RGB操作函数
| 函数 | 含义 |
|---|
| SetPixel | 直接设置像素值 |
| SetPixelRGB | 通过RGB值设置像素值 |
| GetPixel | 直接获取像素值 |
| GetPixelRGB | 通过RGB值获取像素值 |
| RGB2Pixel | RGB值转换成像素值 |
| Pixel2RGB | 像素值转换成RGB值 |
12.4 位图操作函数
| 函数 | 含义 | 备注 |
|---|
| FillBox | 填充指定矩形颜色 | 设置刷子颜色后，受当前光栅操作的影响 |
| FillCircle | 填充指定的圆颜色 | 设置刷子颜色后，受当前光栅操作的影响 |
| FillEllipse | 填充指定的椭圆颜色 | 设置刷子颜色后，受当前光栅操作的影响 |
| FillPolygon | 填充指定的多边形颜色 | 设置刷子颜色后，受当前光栅操作的影响 |
| FloodFill | 指定点开始填注 | 设置刷子颜色后，受当前光栅操作的影响 |
| FillBoxWithBitmap | 用设备相关位图对象填充矩形框 | 可以用来扩大或者缩小位图 |
| FillBoxWithBitmapPart | 用设备相关位图对象的部分填充矩形框 | 也可以扩大或缩小位图 |
| BitBlt | 用来实现两个相同或不同的设备上下文之间的显示内存复制 | |
| StretchBlt | 在BitBlt的基础上进行缩放操作 | |
| LoadBitmapEx | 将位图对象的逐个扫描行装载成设备无关的位图对象 | 可以减少对内存资源的占用 |
| LoadBitmapFromFile | 从文件加载位图，设备相关 | |
| LoadBitmapFromMemory | 从内存加载位图，设备相关 | |
| LoadBitmap | LoadBitmapFromFile函数宏定义 | |
| UnloadBitmap | 卸载位图 | |
| LoadMyBitmapEx | 将位图文件装载成设备无关的位图对象 | |
| LoadMyBitmapFromFile | 从文件加载位图，设备无关 | |
| LoadMyBitmapFromMemory | 从内存加载位图，设备无关 | |
| UnloadMyBitmap | 卸载位图 | |
| InitMyBitmapSL | 为LoadMyBitmapSL函数的装载进行初始化 | |
| LoadMyBitmapSL | 每加载完一行后,将调用传入该函数的用户定义回调函数cb | 对装载后的一条扫描线进行处理 |
| CleanupMyBitmapSL | LoadMyBitmapSL加载完释放资源 | |
| PaintImageEx | 将指定的图形直接绘制到屏幕上，无需装载为BITMAP对象 | 减少图片装载和绘制中内存消耗 |
| PaintImageFromFile | 从文件绘制 | |
| PaintImageFromMem | 从内存绘制 | |
| ExpandMyBitmap | 将设备无关位图转换为和特定设备上下文相关的位图 | |
| ScaleBitmap | 将源BITMAP对象进行伸缩处理 | |
| GetBitmapFromDC | 将指定矩形范围内的象素复制到BITMAP对象中 | |
| GetPixelInBitmap | 获得BITMAP对象中指定位置的象素值 | |
| SetPixelInBitmap | 设置BITMAP对象中指定位置的象素值 | |
BitBlt 函数的各参数含义如下
- hsdc:源设备上下文
- sx,sy:源设备上下文中所选矩形的左上角坐标
- sw,sh:所选矩形的宽度和高度
- hddc:目标设备上下文
- dx,dy:目标设备上下文中目标矩形的左上角坐标
- dwRop:光栅操作,目前被忽略
12.5 图片缩放/旋转函数
| 函数 | 含义 |
|---|
| StretchPaintImageFromFile | 从文件读入图片信息并进行缩放处理 |
| StretchPaintImageFromMem | 从内存中读取图片信息并进行缩放处理 |
| StretchPaintImageEx | 从数据源中读取图片信息并同时进行缩放处理 |
| PivotScaledBitmapFlip | 将位图进行垂直或水平翻转,并且可以缩放至指定宽度、高度,同时绕指定点旋转一指定的角度angle并将它画在DC的指定位置 |
| RotateBitmap | 可对位图进行绕中心旋转 |
| PivotBitmap | 可对位图进行绕指定旋转中心进行旋转 |
| RotateScaledBitmap | 将位图缩放至指定的宽度和高度并绕中心旋转指定的角度 |
| RotateBitmapVFlip | 将位图垂直翻转并绕中心旋转 |
| RotateBitmapHFlip | 将位图水平翻转并绕中心旋转 |
| RotateScaledBitmapVFlip | 将位图垂直翻转,缩放到指定的宽度和高度并绕中心旋转 |
| RotateScaledBitmapHFlip | 将位图水平翻转,缩放到指定的宽度和高度并绕中心旋转 |
12.6 调色板操作函数
| 函数 | 含义 |
|---|
| CreatePalette | 创建一个新的调色板 |
| GetDefaultPalette | 得到默认的调色板 |
| GetPaletteEntries | 获取调色板的入口项 |
| SetPaletteEntries | 设置调色板的入口项 |
| ResizePalette | 重设调色板的大小 |
| GetNearestPaletteIndex | 得到调色板的最接近的索引值 |
| GetNearestColor | 得到调色板的最接近的颜色 |
12.7 画线操作函数
| 函数 | 含义 |
|---|
| LineClipper | 直线剪切器，对给定的直线进行剪切 |
| LineGenerator | 直线生成器 |
| CircleGenerator | 圆生成器 |
| EllipseGenerator | 椭圆生成器 |
| CircleArcGenerator | 圆弧生成器 |
| PolygonIsMonotoneVertical | 判断给定的多边形是否是垂直单调多边形 |
| MonotoneVerticalPolygonGenerator | 垂直多边形生成器 |
| PolygonGenerator | 一般多边形生成器 |
| FloodFillGenerator | 填注生成器 |
| LineTo | 从当前画笔点画直线到给定点 |
| MoveTo | 将当前画笔的起始点移动到给定点 |
| Rectangle | 绘制矩形 |
| RoundRect | 绘制圆角矩形 |
| PollyLineTo | 利用LineTo函数画折线 |
| SplineTo | 利用LineTo函数画三次样条曲线 |
| Circle | 绘制圆 |
| Ellipse | 绘制椭圆 |
| CircleArc | 绘制圆弧 |
| InitFreeClipRectList | 为区域创建剪切矩形的私有堆 |
| InitClipRgn | 初始化区域,并指定区域使用已创建的私有堆 |
| InitCircleRegion | 将某个区域分别初始化为圆 |
| InitEllipseRegion | 将某个区域分别初始化为椭圆 |
| InitPolygonRegion | 将某个区域分别初始化为多边形 |
12.8 高级二维绘图函数
在配置MiniGUI时,我们可以通过--enable-adv2dapi参数来打开MiniGUI中的高级二维绘图函数接口。当MiniGUI中包含高级二维绘图函数接口时,前面提到的所有填充类函数将受到当前画刷属性的影响,这些函数包括FillBox 、FillCircle、 FillEllipse、FillPolygon、FloodFill等等,但基本的线段绘制函数却不会受画笔属性的影响,这些函数包括MoveTo /LineTo、Rectangle、PolyLineTo、SplineTo、Circle、Ellipse、CircleArc等函数。这些基本的线段绘制函数仍将以零画笔绘制
| 函数 | 说明 |
|---|
| GetPenType/SetPenType | 获取/设置画笔类型 |
| GetPenWidth/SetPenWidth | 获取/设置画笔宽度,以象素为单位 |
| GetPenCapStyle/SetPenCapStyle | 获取/设置画笔端点风格 |
| GetPenJoinStyle/SetPenJoinStyle | 获取/设置画笔接合风格 |
| SetPenDashes | 设定画笔的虚实 |
| GetBrushType/SetBrushType | 获取/设置画刷类型 |
| SetBrushInfo | 设定画刷所使用的位图或者点刻位图 |
| 类型 | 说明 |
|---|
| PT_SOLID | 表示实画笔 |
| PT_ON_OFF_DASH | 开/关虚线，虚实线段中的偶数段会被绘制,而奇数段不会被绘制 |
| PT_DOUBLE_DASH | 双虚线，虚实线段中的偶数段会被绘制,而奇数段会根据画刷的设置进行绘制 |
| PT_CAP_BUTT | 线段的端点被绘制为矩形,并且扩展到端点的坐标处 |
| PT_CAP_ROUND | 线段的端点被绘制为半圆形,端点是圆弧的圆心,直径是线段的宽度 |
| PT_CAP_PROJECTING | 线段的端点被绘制为矩形,并超出端点坐标,超出的部分为线段宽度的一半 |
| PT_JOIN_MITER | 相连两条线段的边被扩展为一个斜角,又称"斜接合" |
| PT_JOIN_ROUND | 相连两条线段的边被扩展为圆弧,又称"圆接合" |
| PT_JOIN_BEVEL | 相连两条线段的接合形成了一个斜面,又称"斜面接合" |
| BT_SOLID | 实画刷。以当前的画刷颜色填充 |
| BT_TILED | 位图画刷。以当前设定的位图进行平铺式填充 |
| BT_STIPPLED | 透明点刻画刷。使用当前设定的点刻位图填充,点刻位图中被设置的位将以画刷颜色填充,而未被设置的位将不做绘制(即保留背景) |
| BT_OPAQUE_STIPPLED | 不透明点刻画刷 |
| 函数 | 说明 |
|---|
| LineEx | 函数将按照当前的画笔属性绘制一条直线段,从(x1,y1)到(x2,y2) |
| ArcEx | 函数将按照当前的画笔属性绘制一条圆弧线段,该圆弧的圆心为(x,y),所在圆或椭圆的最小外接矩形宽为width,高为 height;圆弧的起始角度为ang1,以1/64度为单位表示,ang2指的是圆弧终止角度相对起始角度的度数,以1/64度为单位表示; ang2为正,表示逆时针方向,为负表示顺时针方向。当ang2大于等于360x64时,表示要绘制的不是圆弧而是一个完整的圆弧或者椭圆 |
| FillArcEx | 函数将按照当前的画刷属性填充一个圆弧扇形。参数意义和ArcEx相同 |
| PolyLinEx | 函数按照当前的画笔属性绘制多条线段,如果有相连线段,则会根据画笔的属性进行接合处理 |
| PolyArcEx | 函数按照当前的画笔属性绘制多条圆弧,如果有相连圆弧,则会根据画笔的属性进行接合处理 |
| PolyFillArcEx | 函数填充多个圆弧 |
13 文本的处理与显示
13.1 字体的加载与创建
| 函数 | 含义 | 备注 |
|---|
| LoadDevFontFromFile | 动态加载设备字体 | |
| DestroyDynamicDevFont | 卸载动态加载的设备字体 | |
| CreateBMPDevFont | 创建位图设备字体，不能在MiniGui.cfg中配置 | |
| AddGlyphsToBMPFont | 用来往已创建的位图设备字体里面增加字符 | |
| DestroyBMPFont | 用来销毁位图设备字体 | |
| CreateLogFont | 创建逻辑字体 | |
| CreateLogFontByName | 通过名字创建逻辑字体 | |
| CreateLogFontIndirect | 间接的创建逻辑字体 | |
| DestroyLogFont | 销毁创建的逻辑字体 | 不能销毁被选中的逻辑字体 |
| GetLogFontInfo | 获取逻辑字体信息 | |
| GetSystemFont | 返回指定的系统逻辑字体 | |
| GetCurFont | 得到当前使用的字体 | |
| SelectFont | 给窗口设置字体 | |
GetSystemFont函数的参数
- SYSLOGFONT_DEFAULT:系统默认字体,必须是单字节字符集逻辑字体,必须由 RBF 设备字体组成
- SYSLOGFONT_WCHAR_DEF:系统默认多字节字符集字体,通常由RBF设备字体组成,并且多字节字体的宽度是SYSLOGFONT_DEFAULT
逻辑字体的两倍 - SYSLOGFONT_FIXED:固定宽度的系统字体
- SYSLOGFONT_CAPTION:用于显示标题栏文本的逻辑字体
- SYSLOGFONT_MENU:用于显示菜单文本的逻辑字体
- SYSLOGFONT_CONTROL:用于控件的默认逻辑字体
13.2 文本输出函数
| 函数 | 含义 | 备注 |
|---|
| GetTextExtentPoint | 计算在给定的输出宽度内输出多字节文本时,可输出的最大字符个数、每个字符所在的字节位置、每个字符的输出位置,以及实际的输出高度和宽度 | |
| GetTabbedTextExtentPoint | 在GetTextExtentPoint函数的基础上,增加了对回车、换行和TAB键等格式化字符的处理 | |
| GetFontHeight | 返回逻辑字体的高度 | |
| GetMaxFontWidth | 返回逻辑字体的最大字符宽度 | |
| GetTextExtent | 计算文本的输出高度和宽度 | |
| GetTabbedTextExtent | 返回格式化字符串的输出高度和宽度 | |
| TextOutLen | 用来在给定位置输出指定长度的字符串,若长度为-1,则字符串必须是以'0' 结尾的 | |
| TabbedTextOutLen | 用来输出格式化字符串 | |
| TabbedTextOutEx | 用来输出格式化字符串,但可以指定字符串中每个TAB键的位置 | |
| GetLastTextOutPos | 获取最后的文本位置 | |
| TextOut | TextOutLen输出全部文本 | |
| TabbedTextOut | TabbedTextOutLen格式化全部文本 | |
| DrawText | 以不同的对齐方式在指定的矩形内部输出文本 | 尚不支持对UTF-16编码的文本输出 |
| DrawTextEx | 在DrawText函数的基础上增加了对输入文本首行缩进字符数的指定 | |
| DrawTextEx2 | 在前两者的基础上,增加了对首行能显示的字符个数的计算 | |
| GetTextCharacterExtra | 获取当前字符间距值 | |
| SetTextCharacterExtra | 设置字符间距值 | |
| GetTextAboveLineExtra | 获取行前间隔值 | |
| SetTextAboveLineExtra | 设置行前间隔值 | |
| GetTextBellowLineExtra | 获取行后间隔值 | |
| SetTextBellowLineExtra | 设置行后间隔值 | |
13.3 输出格式标识
| 格式标识符 | 含义 | 备注 |
|---|
| DT_TOP | 在垂直方向顶端对齐 | 只对单行输出有效(DT_SINGLELINE) |
| DT_VCENTER | 在垂直方向居中 | 只对单行输出有效(DT_SINGLELINE) |
| DT_BOTTOM | 在垂直方向底端对齐 | 只对单行输出有效(DT_SINGLELINE) |
| DT_LEFT | 水平方向左对齐 | |
| DT_CENTER | 水平对中 | |
| DT_RIGHT | 水平方向右对齐 | |
| DT_WORDBREAK | 当文本输出超过矩形区时按单词换行输出 | |
| DT_CHARBREAK | 当文本输出超过矩形区时按字符换行输出 | |
| DT_SINGLELINE | 单行输出 | 无此标志时会忽略垂直方向的对齐标志 |
| DT_EXPANDTABS | 扩展TAB字符 | |
| DT_TABSTOP | 格式参数的高8位用来指定TAB键宽度 | |
| DT_NOCLIP | 不作输出剪切，默认将把输出剪切到指定矩形 | |
| DT_CALCRECT | 不作实际输出,只计算实际的输出矩形大小 | |
13.4 字体渲染风格
| 逻辑字体风格名称 | 风格字符 | 逻辑字体风格值 | 含义 |
|---|
| weight: FONT_WEIGHT_REGULAR | 第一位"r" | FS_WEIGHT_REGULAR | 不作特殊处理 |
| weight: FONT_WEIGHT_BOLD | 第一位"b" | FS_WEIGHT_BOLD | 加粗显示 |
| weight: FONT_WEIGHT_LIGHT | 第一位"l" | FS_WEIGHT_LIGHT | 使用背景色描绘字型的边缘,其他地方透明显示 |
| weight: FONT_WEIGHT_BOOK | 第一位"b" | FS_WEIGHT_BOOK | 采用低通滤波算法处理矢量字型边缘或者放大后的字型边缘 |
| weight: FONT_WEIGHT_DEMIBOLD | 第一位"d" | FS_WEIGHT_DEMIBOLD | 加粗的同时,采用低通滤波算法处理矢量字型边缘或者放大后的字型边缘 |
| weight: FONT_WEIGHT_SUBPIXEL | 第一位"s" | FS_WEIGHT_SUBPIXEL | 采用sub-pixel技术渲染字型 |
| slant: FONT_SLANT_ROMAN | 第二位"r" | FONT_SLANT_ROMAN | 不作特殊处理 |
| slant: FONT_SLANT_ITALIC | 第二位"i" | FONT_SLANT_ITALIC | 斜体显示字型 |
| flip: FONT_OTHER_NIL | 第三位除H/V/T之外 | N/A | 不作任何处理 |
| flip: FONT_FLIP_HORZ | 第三位"H" | FS_FLIP_HORZ | 将字型水平翻转显示 |
| flip: FONT_FLIP_VERT | 第三位"V" | FS_FLIP_VERT | 将字型垂直翻转显示 |
| other: FONT_OTHER_NIL | 第四位除 S/N之外 | N/A | 不作任何处理 |
| other: FONT_OTHER_AUTOSCALE | 第四位"S" | FS_OTHER_AUTOSCALE | 根据逻辑字体期望的大小自动放大显示设备字体字型,仅适用于点阵字体 |
| other: FONT_OTHER_TTFNOCACHE | 第四位"N" | FS_OTHER_TTFNOCACHE | 在使用 TrueType字体渲染该逻辑时,关闭缓存 |
| other: FONT_OTHER_LCDPORTRAIT | 第四位"P" | FS_OTHER_LCDPORTRAIT | 在使用 TrueType字体渲染该逻辑时, LCD为PORTRAIT模式 |
| underline: FONT_UNDERLINE_NONE | 第五位"n" | FS_UNDERLINE_NONE | 无下划线线 |
| underline: FONT_UNDERLINE_LINE | 第五位"u" | FS_UNDERLINE_LINE | 添加下划线 |
| struckout: FONT_STRUCKOUT_NONE | 第六位"n" | FS_STRUCKOUT_NONE | 无删除线 |
| struckout: FONT_STRUCKOUT_LINE | 第六位"s" | FS_STRUCKOUT_LINE | 添加删除线 |
14 Mginit专用函数
| 函数 | 含义 |
|---|
| JoinLayer | 将自己添加到一个层中 |
| GetLayerInfo | 可以得到层的信息 |
| SetTopmostLayer | 将指定的层设置为最顶层 |
| DeleteLayer | 删除层 |
| ServerStartup | 创建监听套接字 |
| ServerSetTopmostLayer | 将把指定的层切换到最上面 |
| ServerCreateLayer | 将在系统中创建指定的层 |
| ServerDeleteLayer | 从系统中删除指定的层 |
| GetClientByPID | 根据客户的进程标识号返回客户标识号 |
| SetTopmostClient | 通过指定的客户标识号来设置顶层,它将把客户所在的层切换到最上面 |
| SetServerEventHook | 在mginit中设置底层事件的钩子,在钩子函数返回零给MiniGUI时,MiniGUI将继续事件的处理,并最终将事件发送到当前活动客户;反之将终止事件的处理 |
| Send2Client | 服务器可利用该消息将指定的消息发送到某个客户 |
| ServerGetNextZNode | 用于遍历所有的Z序节点 |
| ServerGetZNodeInfo | 用于获得某个特定Z序节点的信息 |
| ServerDoZNodeOperation | 用于完成切换主窗口Z序和/或设置某主窗口为当前活动窗口 |
| 事件类型 | 含义 |
|---|
| LCO_NEW_LAYER | 系统创建了新的层 |
| LCO_DEL_LAYER | 系统删除了一个层 |
| LCO_JOIN_CLIENT | 某个层中加入了一个客户 |
| LCO_REMOVE_CLIENT | 某个客户从所在的层中删除 |
| LCO_TOPMOST_CHANGED | 最上面的层改变了,即发生了层的切换 |
| ZNOP_ALLOCATE | z-node被创建 |
| ZNOP_FREE | z-node被销毁 |
| ZNOP_MOVE2TOP | z-node被移为TopMost结点 |
| ZNOP_SHOW | z-node已被显示 |
| ZNOP_HIDE | z-node已被隐藏 |
| ZNOP_MOVEWIN | z-node已被移动或其大小已改变 |
| ZNOP_SETACTIVE | z-node已被设置为活动态 |
| ZNOP_ENABLEWINDOW | z-node被disabled或enabled |
| ZNOP_STARTDRAG | 开始对z-node的拖拽 |
| ZNOP_CANCELDRAG | 取消对z-node的拖拽 |
| ZNOP_CHANGECAPTION | z-node的名称已改变 |
