emWin5用户手册（中文）

emWin 图形库 图形用户界面 版本 5.12 手册修订版 0 emWin V5.12 用户参考手册 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG 9 1 emWin 简介....................................................................................................................23 1.1 本文档的目的 ............................................................................................24 1.2 假定 .......................................................................................................24 1.3 如何使用本手册 .........................................................................................24 1.4 语法句子的印刷规范 ....................................................................................24 1.5 要求 .......................................................................................................25 1.5.1 目标系统 （硬件）.......................................................................................25 1.5.2 开发环境 （编译器）....................................................................................25 1.6 特性 .......................................................................................................26 1.7 示例和演示 ...............................................................................................27 1.8 初学者套装 ...............................................................................................27 1.9 屏幕和坐标 ...............................................................................................27 1.10 如何将显示器连接到微控制器 .........................................................................28 1.11 数据类型..................................................................................................29 2 入门指南.........................................................................................................................31 2.1 推荐目录结构 ............................................................................................32 2.1.1 子目录 ....................................................................................................32 2.1.2 包含目录..................................................................................................32 2.2 添加 emWin 到目标程序...............................................................................32 2.3 创建库 ....................................................................................................33 2.3.1 改编库批处理文件以适应不同系统 ...................................................................33 2.4 要包含在项目中的 C 文件..............................................................................35 2.5 emWin 的配置 ..........................................................................................35 2.6 初始化 emWin ..........................................................................................36 2.7 有目标硬件时使用 emWin ............................................................................37 2.8 “Hello world”示例程序 .............................................................................37 3 模拟................................................................................................................................39 3.1 使用模拟..................................................................................................40 3.1.1 通过 emWin 试用版使用模拟 .........................................................................40 3.1.1.1 目录结构..................................................................................................40 3.1.1.2 Visual C++ 工作空间 .................................................................................40 3.1.1.3 编译演示程序 ............................................................................................41 3.1.1.4 编译示例..................................................................................................41 3.1.2 通过 emWin 源代码使用模拟 .........................................................................42 3.1.2.1 目录结构..................................................................................................42 3.1.2.2 Visual C++ 工作空间 .................................................................................42 3.1.2.3 编译应用程序 ............................................................................................43 3.1.3 模拟的高级功能 .........................................................................................43 3.1.3.1 暂停和恢复 ...............................................................................................43 3.1.3.2 查看系统信息 ............................................................................................43 3.1.3.3 复制到剪贴板 ............................................................................................43 3.2 设备模拟..................................................................................................44 3.2.1 生成的框架视图 .........................................................................................45 3.2.2 自定义位图视图 .........................................................................................45 3.2.3 窗口视图..................................................................................................46 3.3 设备模拟 API ............................................................................................47 3.4 硬键模拟..................................................................................................52 3.4.1 硬键模拟 API ............................................................................................5310 emWin V5.12 用户参考手册 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG 3.5 集成 emWin 模拟到现有模拟中...................................................................... 56 3.5.1 目录结构 ................................................................................................. 56 3.5.2 使用模拟库 .............................................................................................. 56 3.5.2.1 修改 WinMain .......................................................................................... 56 3.5.2.2 应用程序示例............................................................................................ 57 3.5.3 集成到 embOS 模拟中 ................................................................................ 58 3.5.3.1 WinMain................................................................................................. 58 3.5.3.2 目标程序 (main) ....................................................................................... 59 3.5.4 GUI 模拟 API ........................................................................................... 60 4 查看器 ............................................................................................................................63 4.1 使用查看器 .............................................................................................. 64 4.1.1 使用模拟和查看器 ...................................................................................... 64 4.1.2 使用带虚拟页面的查看器 .............................................................................. 65 4.1.3 总在顶部显示............................................................................................ 65 4.1.4 打开显示输出的更多窗口 .............................................................................. 65 4.1.5 缩放....................................................................................................... 66 4.1.6 将输出复制到剪贴板 ................................................................................... 66 4.1.7 使用带多种显示的查看器 .............................................................................. 67 4.1.8 使用带多种显示的查看器 .............................................................................. 67 5 显示文本.........................................................................................................................69 5.1 基本例程 ................................................................................................. 70 5.2 文本 API ................................................................................................. 71 5.3 显示文本的例程 ......................................................................................... 72 5.4 选择文本绘制模式 ...................................................................................... 79 5.5 选择文本对齐模式 ...................................................................................... 81 5.6 设置当前文本位置 ...................................................................................... 83 5.7 返回当前文本位置 ...................................................................................... 84 5.8 清除窗口或部分窗口的例程 ........................................................................... 84 6 显示数值.........................................................................................................................85 6.1 评估 API ................................................................................................. 86 6.2 显示十进制数值 ......................................................................................... 87 6.3 显示浮点数值............................................................................................ 91 6.4 显示二进制数值 ......................................................................................... 94 6.5 显示十六进制数值 ...................................................................................... 95 6.6 emWin 版 ............................................................................................... 96 7 2-D 图形库......................................................................................................................97 7.1 图形 API ................................................................................................. 98 7.2 绘制模式 ................................................................................................100 7.3 查询当前客户区矩形 ..................................................................................102 7.4 画笔大小 ................................................................................................102 7.5 基本绘制例程...........................................................................................103 7.6 Alpha 混合 .............................................................................................110 7.7 绘制位图 ................................................................................................113 7.8 绘制流位图 .............................................................................................116 7.9 绘制线条 ................................................................................................122 7.10 绘制多边形 .............................................................................................126 7.11 绘制圆 ...................................................................................................131 7.12 绘制椭圆 ................................................................................................133 7.13 绘制弧线 ................................................................................................135 7.14 绘制线图 ................................................................................................137 7.15 绘制饼图 ................................................................................................138 7.16 保存和恢复 GUI 环境 .................................................................................139 7.17 裁剪......................................................................................................140 8 显示位图文件 ...............................................................................................................141emWin V5.12 用户参考手册 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG 11 8.1 BMP 文件支持 ......................................................................................... 142 8.1.1 支持的格式 ............................................................................................. 142 8.1.2 BMP 文件 API ......................................................................................... 142 8.2 JPEG 文件支持 ........................................................................................ 148 8.2.1 支持的 JPEG 压缩方法 ............................................................................... 148 8.2.2 将 JPEG 文件转换为 C 源 ............................................................................ 148 8.2.3 显示 JPEG 文件........................................................................................ 148 8.2.4 存储器使用 ............................................................................................. 149 8.2.5 渐进式 JPEG 文件..................................................................................... 149 8.2.6 JPEG 文件 API ........................................................................................ 149 8.3 GIF 文件支持 .......................................................................................... 154 8.3.1 将 GIF 文件转换为 C 源.............................................................................. 154 8.3.2 显示 GIF 文件 ......................................................................................... 154 8.3.3 存储器使用 ............................................................................................. 154 8.3.4 GIF 文件 API .......................................................................................... 155 8.4 PNG 文件支持 ......................................................................................... 163 8.4.1 将 PNG 文件转换为 C 源 ............................................................................. 163 8.4.2 显示 PNG 文件 ........................................................................................ 163 8.4.3 存储器使用 ............................................................................................. 163 8.4.4 PNG 文件 API ......................................................................................... 163 8.5 使用 ...Ex() 函数获取数据 .......................................................................... 167 9 字体..............................................................................................................................169 9.1 简介 ..................................................................................................... 170 9.2 字体类型................................................................................................ 170 9.3 字体格式................................................................................................ 172 9.3.1 C 文件格式 ............................................................................................. 172 9.3.2 系统独立字体 (SIF) 格式 ............................................................................ 172 9.3.3 外部位图字体 (XBF) 格式 ........................................................................... 173 9.3.4 TrueType 字体 (TTF) 格式 ......................................................................... 174 9.4 将 TTF 文件转换为 C 源.............................................................................. 174 9.5 声明自定义字体 ....................................................................................... 175 9.6 选择字体................................................................................................ 175 9.7 字体 API................................................................................................ 176 9.8 C 文件相关的字体函数 ............................................................................... 177 9.9 “SIF”文件相关的字体函数 ........................................................................ 178 9.10 “TTF”文件相关的字体函数 ........................................................................ 179 9.11 “XBF”文件相关的字体函数........................................................................ 183 9.12 常见字体相关的函数 .................................................................................. 184 9.13 字符集 .................................................................................................. 188 9.13.1 ASCII................................................................................................... 188 9.13.2 ISO 8859-1 西方拉丁字符集....................................................................... 189 9.13.3 Unicode................................................................................................ 190 9.14 字体转换器 ............................................................................................. 191 9.14.1 添加字体................................................................................................ 191 9.15 标准字体................................................................................................ 192 9.15.1 字体标识符命名约定 .................................................................................. 192 9.15.2 字体文件命名约定..................................................................................... 193 9.15.3 字体的计量、 ROM 大小和字符集 .................................................................. 193 9.15.4 比例字体................................................................................................ 194 9.15.4.1 概述 ..................................................................................................... 194 9.15.4.2 计量、 ROM 大小和使用的文件..................................................................... 194 9.15.4.3 字符 ..................................................................................................... 196 9.15.5 比例字体，带边框..................................................................................... 202 9.15.5.1 概述 ..................................................................................................... 202 9.15.5.2 计量、 ROM 大小和使用的文件..................................................................... 202 9.15.5.3 字符 ..................................................................................................... 202 9.15.6 等宽字体................................................................................................ 203 9.15.6.1 概述 ..................................................................................................... 203 9.15.6.2 计量、 ROM 大小和使用的文件..................................................................... 204 9.15.6.3 字符 ..................................................................................................... 20512 emWin V5.12 用户参考手册 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG 9.15.7 数字字体 （比例）.....................................................................................209 9.15.7.1 概述......................................................................................................209 9.15.7.2 计量、 ROM 大小和使用的文件 .....................................................................209 9.15.7.3 字符......................................................................................................209 9.15.8 数字字体 （等宽）.....................................................................................210 9.15.8.1 概述......................................................................................................210 9.15.8.2 计量、 ROM 大小和使用的文件 .....................................................................211 9.15.8.3 字符......................................................................................................211 10 位图转换器.................................................................................................................213 10.1 功能......................................................................................................214 10.2 加载位图 ................................................................................................214 10.2.1 支持的输入文件格式 ..................................................................................214 10.2.2 从文件加载 .............................................................................................214 10.2.3 使用剪贴板 .............................................................................................215 10.3 从位图生成 C 文件.....................................................................................215 10.3.1 支持的位图格式 ........................................................................................215 10.3.2 调色板信息 .............................................................................................215 10.3.3 透明性 ...................................................................................................216 10.3.4 Alpha 混合 .............................................................................................216 10.3.5 选择最佳格式...........................................................................................217 10.3.6 保存文件 ................................................................................................218 10.4 色彩转换 ................................................................................................219 10.5 生成 C 流文件 ..........................................................................................220 10.6 压缩位图 ................................................................................................220 10.7 使用定制调色板 ........................................................................................221 10.7.1 保存调色板文件 ........................................................................................221 10.7.2 C 文件格式..............................................................................................221 10.7.3 固定调色板模式的调色板文件 .......................................................................221 10.7.4 转换位图 ................................................................................................222 10.8 命令行用法 .............................................................................................222 10.8.1 命令的格式 .............................................................................................222 10.8.2 有效的命令行选项 .....................................................................................222 10.9 转换位图示例...........................................................................................224 11 颜色............................................................................................................................227 11.1 预定义的颜色...........................................................................................228 11.2 颜色条测试例程 ........................................................................................228 11.3 固定调色板模式 ........................................................................................229 11.4 固定调色板模式的详细说明 ..........................................................................230 11.5 应用程序定义的色彩转换 .............................................................................240 11.6 定制调色板模式 ........................................................................................241 11.7 颜色 API ................................................................................................241 11.8 基本颜色函数...........................................................................................242 11.9 索引和色彩转换 ........................................................................................244 12 存储设备.....................................................................................................................247 12.1 使用存储设备：图示 ..................................................................................248 12.2 支持的色彩深度 (bpp)................................................................................248 12.3 存储设备和窗口管理器................................................................................249 12.4 存储设备和多层 ........................................................................................249 12.5 内存要求 ................................................................................................249 12.6 性能......................................................................................................250 12.7 基本函数 ................................................................................................251 12.8 使用存储设备的准备操作 ... .........................................................................251 12.9 多层 / 多显示配置 .....................................................................................251 12.10 配置选项 ................................................................................................251 12.10.1 GUI_USE_MEMDEV_1BPP_FOR_SCREEN....................................................251 12.11 存储设备 API...........................................................................................251 12.12 基本函数 ................................................................................................253emWin V5.12 用户参考手册 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG 13 12.13 分段存储设备 .......................................................................................... 266 12.14 自动设备对象 .......................................................................................... 267 12.15 测量设备对象 .......................................................................................... 269 12.16 动画函数................................................................................................ 271 12.17 动画函数 （需要使用窗口管理器）................................................................. 272 13 执行模型：单任务 / 多任务.........................................................................................277 13.1 支持的执行模型 ....................................................................................... 278 13.2 单任务系统 （超循环）............................................................................... 278 13.2.1 描述 ..................................................................................................... 278 13.2.2 超循环示例 （无 emWin）.......................................................................... 278 13.2.3 优势 ..................................................................................................... 278 13.2.4 缺点 ..................................................................................................... 278 13.2.5 使用 emWin ........................................................................................... 278 13.2.6 超循环示例 （有 emWin）.......................................................................... 279 13.3 多任务系统：一个任务调用 emWin ............................................................... 279 13.3.1 描述 ..................................................................................................... 279 13.3.2 优势 ..................................................................................................... 279 13.3.3 缺点 ..................................................................................................... 279 13.3.4 使用 emWin ........................................................................................... 279 13.4 多任务系统：多个任务调用 emWin ............................................................... 280 13.4.1 描述 ..................................................................................................... 280 13.4.2 优势 ..................................................................................................... 280 13.4.3 缺点 ..................................................................................................... 280 13.4.4 使用 emWin ........................................................................................... 280 13.4.5 建议 ..................................................................................................... 280 13.4.6 示例 ..................................................................................................... 280 13.5 支持多任务的 GUI 配置函数 ........................................................................ 281 13.6 支持多任务的 GUI 配置宏 ........................................................................... 283 13.7 内核接口 API .......................................................................................... 284 13.7.1 示例 ..................................................................................................... 287 14 窗口管理器 (WM) .......................................................................................................289 14.1 术语说明................................................................................................ 290 14.2 回调机制，无效化和渲染 ............................................................................ 291 14.2.1 不使用回调渲染 ....................................................................................... 291 14.2.2 使用回调渲染 .......................................................................................... 292 14.2.3 背景窗口重绘和回调 .................................................................................. 292 14.2.4 无效化 .................................................................................................. 293 14.2.5 渲染透明窗口 .......................................................................................... 293 14.2.6 自动使用存储设备..................................................................................... 293 14.2.7 自动使用多帧缓冲..................................................................................... 294 14.2.8 自动使用显示驱动缓存 ............................................................................... 294 14.3 消息 ..................................................................................................... 295 14.3.1 消息结构................................................................................................ 295 14.3.2 消息清单................................................................................................ 295 14.3.3 系统定义的消息 ....................................................................................... 296 14.3.4 指针输入设备 (PID) 消息............................................................................ 300 14.3.5 系统定义的通知代码 .................................................................................. 303 14.3.6 应用定义的消息 ....................................................................................... 303 14.4 配置选项................................................................................................ 304 14.5 WM API ................................................................................................ 305 14.5.1 使用 WM API 函数.................................................................................... 307 14.6 基本函数................................................................................................ 307 14.7 存储设备支持 （可选）............................................................................... 336 14.8 定时器相关函数 ....................................................................................... 336 14.9 小工具相关函数 ....................................................................................... 339 14.10 示例 ..................................................................................................... 342 15 窗口对象 （小工具）...................................................................................................34514 emWin V5.12 用户参考手册 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG 15.1 基础知识 ................................................................................................346 15.1.1 可用小工具 .............................................................................................346 15.1.2 了解重绘机制...........................................................................................347 15.1.3 如何使用小工具 ........................................................................................347 15.2 配置选项 ................................................................................................349 15.3 通用小工具 API ........................................................................................350 15.3.1 用于小工具的 WM 例程...............................................................................350 15.3.2 常用例程 ................................................................................................350 15.3.3 用户绘制小工具 ........................................................................................354 15.4 BUTTON：按钮小工具 ...............................................................................356 15.4.1 配置选项 ................................................................................................356 15.4.2 通知代码 ................................................................................................357 15.4.3 键盘反应 ................................................................................................357 15.4.4 BUTTON API ..........................................................................................357 15.4.5 示例......................................................................................................370 15.5 CHECKBOX：复选框小工具.........................................................................371 15.5.1 配置选项 ................................................................................................372 15.5.2 通知代码 ................................................................................................372 15.5.3 键盘反应 ................................................................................................372 15.5.4 CHECKBOX API ......................................................................................372 15.5.5 示例......................................................................................................386 15.6 DROPDOWN：下拉列表小工具 ....................................................................387 15.6.1 配置选项 ................................................................................................388 15.6.2 通知代码 ................................................................................................388 15.6.3 键盘反应 ................................................................................................388 15.6.4 DROPDOWN API.....................................................................................388 15.6.5 示例......................................................................................................400 15.7 EDIT：“编辑”小工具 ...............................................................................402 15.7.1 配置选项 ................................................................................................402 15.7.2 通知代码 ................................................................................................402 15.7.3 键盘反应 ................................................................................................403 15.7.4 EDIT API...............................................................................................403 15.7.5 示例......................................................................................................418 15.8 FRAMEWIN：框架窗口小工具......................................................................419 15.8.1 框架窗口的结构 ........................................................................................420 15.8.2 配置选项 ................................................................................................421 15.8.3 键盘反应 ................................................................................................421 15.8.4 FRAMEWIN API ......................................................................................421 15.8.5 示例......................................................................................................442 15.9 GRAPH：图形小工具 .................................................................................443 15.9.1 图形小工具的结构 .....................................................................................443 15.9.2 创建和删除图形小工具................................................................................444 15.9.3 绘制过程 ................................................................................................444 15.9.4 支持的曲线类型 ........................................................................................444 15.9.4.1 GRAPH_DATA_XY ...................................................................................445 15.9.4.2 GRAPH_DATA_YT ...................................................................................445 15.9.5 配置选项 ................................................................................................445 15.9.5.1 图形小工具 .............................................................................................445 15.9.5.2 刻度对象 ................................................................................................445 15.9.6 键盘反应 ................................................................................................445 15.9.7 图形 API ................................................................................................445 15.9.7.1 常用例程 ................................................................................................447 15.9.7.2 GRAPH_DATA_YT 相关的例程.....................................................................455 15.9.7.3 GRAPH_DATA_XY 相关的例程.....................................................................459 15.9.7.4 刻度相关的例程 ........................................................................................463 15.9.8 示例......................................................................................................467 15.10 HEADER：标题小工具 ...............................................................................469 15.10.1 配置选项 ................................................................................................470 15.10.2 通知代码 ................................................................................................470 15.10.3 键盘反应 ................................................................................................470 15.10.4 HEADER API ..........................................................................................470emWin V5.12 用户参考手册 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG 15 15.10.5 示例 ..................................................................................................... 482 15.11 ICONVIEW：图标视图小工具 ...................................................................... 483 15.11.1 配置选项................................................................................................ 483 15.11.2 通知代码................................................................................................ 484 15.11.3 键盘反应................................................................................................ 484 15.11.4 ICONVIEW API ...................................................................................... 484 15.11.5 示例 ..................................................................................................... 494 15.12 LISTBOX：列表框小工具 ........................................................................... 496 15.12.1 配置选项................................................................................................ 496 15.12.2 通知代码................................................................................................ 496 15.12.3 键盘反应................................................................................................ 496 15.12.4 LISTBOX API......................................................................................... 497 15.12.5 示例 ..................................................................................................... 513 15.13 LISTVIEW：Listview 小工具 ...................................................................... 514 15.13.1 配置选项................................................................................................ 515 15.13.2 通知代码................................................................................................ 515 15.13.3 键盘反应................................................................................................ 515 15.13.4 LISTVIEW API ....................................................................................... 516 15.13.5 示例 ..................................................................................................... 537 15.14 LISTWHEEL：Listwheel 小工具 .................................................................. 539 15.14.1 配置选项................................................................................................ 539 15.14.2 通知代码................................................................................................ 539 15.14.3 键盘反应................................................................................................ 539 15.14.4 LISTWHEEL API ..................................................................................... 540 15.15 MENU：菜单小工具 .................................................................................. 553 15.15.1 菜单消息................................................................................................ 554 15.15.2 数据结构................................................................................................ 555 15.15.3 配置选项................................................................................................ 555 15.15.4 键盘反应................................................................................................ 556 15.15.5 “菜单” API ........................................................................................... 556 15.15.6 示例 ..................................................................................................... 570 15.16 MESSAGEBOX：消息框小工具 .................................................................... 571 15.16.1 配置选项................................................................................................ 571 15.16.2 键盘反应................................................................................................ 571 15.16.3 MESSAGEBOX API.................................................................................. 571 15.17 MULTIEDIT：多行文本小工具 ..................................................................... 573 15.17.1 配置选项................................................................................................ 574 15.17.2 通知代码................................................................................................ 574 15.17.3 键盘反应................................................................................................ 574 15.17.4 MULTIEDIT API...................................................................................... 574 15.17.5 示例 ..................................................................................................... 584 15.18 MULTIPAGE：“多页”小工具 ..................................................................... 586 15.18.1 配置选项................................................................................................ 587 15.18.2 通知代码................................................................................................ 587 15.18.3 键盘反应................................................................................................ 587 15.18.4 MULTIPAGE API..................................................................................... 587 15.18.5 示例 ..................................................................................................... 598 15.19 PROGBAR：进度条小工具.......................................................................... 599 15.19.1 配置选项................................................................................................ 599 15.19.2 键盘反应................................................................................................ 599 15.19.3 PROGBAR API ....................................................................................... 599 15.19.4 示例 ..................................................................................................... 604 15.20 RADIO：单选按钮小工具 ........................................................................... 605 15.20.1 配置选项................................................................................................ 605 15.20.2 通知代码................................................................................................ 605 15.20.3 键盘反应................................................................................................ 606 15.20.4 RADIO API............................................................................................ 606 15.20.5 示例 ..................................................................................................... 615 15.21 SCROLLBAR：滚动条小工具....................................................................... 617 15.21.1 配置选项................................................................................................ 617 15.21.2 通知代码................................................................................................ 61716 emWin V5.12 用户参考手册 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG 15.21.3 键盘反应 ................................................................................................617 15.21.4 SCROLLBAR API .....................................................................................618 15.21.5 示例......................................................................................................625 15.22 SLIDER：滑块小工具 ................................................................................626 15.22.1 配置选项 ................................................................................................626 15.22.2 通知代码 ................................................................................................626 15.22.3 键盘反应 ................................................................................................626 15.22.4 SLIDER API ...........................................................................................626 15.22.5 示例......................................................................................................632 15.23 文本文本小工具 ........................................................................................633 15.23.1 配置选项 ................................................................................................633 15.23.2 键盘反应 ................................................................................................633 15.23.3 文本 API ................................................................................................633 15.23.4 示例......................................................................................................639 15.24 TREEVIEW：树形视图小工具.......................................................................640 15.24.1 术语说明 ................................................................................................641 15.24.2 配置选项 ................................................................................................642 15.24.3 通知代码 ................................................................................................642 15.24.4 键盘反应 ................................................................................................642 15.24.5 TREEVIEW API .......................................................................................643 15.24.5.1 常用例程 ................................................................................................644 15.24.5.2 项目相关例程...........................................................................................657 15.24.6 示例......................................................................................................662 15.25 WINDOW：窗口小工具..............................................................................663 15.25.1 配置选项 ................................................................................................663 15.25.2 键盘反应 ................................................................................................663 15.25.3 WINDOW API.........................................................................................663 16 对话框 ........................................................................................................................665 16.1 对话框的基本原理 .....................................................................................666 16.2 创建对话框 .............................................................................................666 16.2.1 资源表 ...................................................................................................666 16.2.2 对话框过程函数 ........................................................................................667 16.2.2.1 初始化对话框...........................................................................................668 16.2.2.2 定义对话框行为 ........................................................................................669 16.3 对话框 API..............................................................................................670 16.4 对话框 ...................................................................................................670 17 GUIBuilder .................................................................................................................673 17.1 简介......................................................................................................674 17.2 入门指南 ................................................................................................675 17.3 创建对话框 .............................................................................................676 17.3.1 选择父小工具...........................................................................................676 17.3.2 在编辑器中调整大小和定位 ..........................................................................676 17.3.3 修改小工具属性 ........................................................................................676 17.3.4 向小工具添加其他函数................................................................................676 17.3.5 删除小工具属性 ........................................................................................677 17.3.6 删除小工具 .............................................................................................677 17.4 保存当前的对话框 .....................................................................................678 17.5 GUIBuilder 的输出 ...................................................................................679 17.6 修改 C 文件 .............................................................................................681 17.7 如何使用 C 文件 .......................................................................................681 18 换肤............................................................................................................................683 18.1 “皮肤”是什么？ ......................................................................................684 18.2 从使用 API 函数到换肤 ...............................................................................684 18.3 可换肤的小工具 ........................................................................................685 18.4 使用皮肤 ................................................................................................685 18.4.1 运行时间配置...........................................................................................686 18.4.2 编译时间配置...........................................................................................686emWin V5.12 用户参考手册 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG 17 18.5 简单更改 “Flex”皮肤外观 ......................................................................... 686 18.6 对 “Flex”皮肤外观所作的重大更改 .............................................................. 687 18.6.1 换肤回调机制 .......................................................................................... 687 18.6.2 更改默认皮肤的外观 .................................................................................. 687 18.6.3 命令列表................................................................................................ 688 18.7 常用的换肤 API........................................................................................ 690 18.8 BUTTON_SKIN_FLEX .............................................................................. 693 18.8.1 配置结构................................................................................................ 693 18.8.2 配置选项................................................................................................ 693 18.8.3 换肤 API................................................................................................ 694 18.8.4 命令列表................................................................................................ 695 18.9 CHECKBOX_SKIN_FLEX .......................................................................... 696 18.9.1 配置结构................................................................................................ 696 18.9.2 配置选项................................................................................................ 696 18.9.3 换肤 API................................................................................................ 697 18.9.4 命令列表................................................................................................ 698 18.10 DROPDOWN_SKIN_FLEX......................................................................... 700 18.10.1 配置结构................................................................................................ 700 18.10.2 配置选项................................................................................................ 701 18.10.3 换肤 API................................................................................................ 701 18.10.4 命令列表................................................................................................ 702 18.11 FRAMEWIN_SKIN_FLEX .......................................................................... 703 18.11.1 配置结构................................................................................................ 703 18.11.2 配置选项................................................................................................ 704 18.11.3 换肤 API................................................................................................ 704 18.11.4 命令列表................................................................................................ 705 18.12 HEADER_SKIN_FLEX .............................................................................. 708 18.12.1 配置结构................................................................................................ 708 18.12.2 配置选项................................................................................................ 708 18.12.3 换肤 API................................................................................................ 709 18.12.4 命令列表................................................................................................ 709 18.13 PROGBAR_SKIN_FLEX ............................................................................ 711 18.13.1 配置结构................................................................................................ 711 18.13.2 配置选项................................................................................................ 711 18.13.3 换肤 API................................................................................................ 712 18.13.4 命令列表................................................................................................ 712 18.14 RADIO_SKIN_FLEX ................................................................................ 715 18.14.1 配置结构................................................................................................ 715 18.14.2 配置选项................................................................................................ 716 18.14.3 换肤 API................................................................................................ 716 18.14.4 命令列表................................................................................................ 717 18.15 SCROLLBAR_SKIN_FLEX......................................................................... 719 18.15.1 配置结构................................................................................................ 719 18.15.2 配置选项................................................................................................ 720 18.15.3 换肤 API................................................................................................ 720 18.15.4 命令列表................................................................................................ 721 18.16 SLIDER_SKIN_FLEX ............................................................................... 724 18.16.1 配置结构................................................................................................ 724 18.16.2 配置选项................................................................................................ 725 18.16.3 换肤 API................................................................................................ 725 18.16.4 命令列表................................................................................................ 726 19 多缓冲 ........................................................................................................................729 19.1 工作原理................................................................................................ 730 19.1.1 双缓冲 .................................................................................................. 730 19.1.2 三缓冲 .................................................................................................. 730 19.2 要求 ..................................................................................................... 731 19.3 限制 ..................................................................................................... 731 19.4 配置 ..................................................................................................... 731 19.4.1 LCD_X_Config() .................................................................................... 731 19.4.2 LCD_X_DisplayDriver()........................................................................... 73218 emWin V5.12 用户参考手册 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG 19.5 通过窗口管理器自动使用多个缓冲器 ...............................................................733 19.6 多缓冲 API..............................................................................................734 20 虚拟屏幕 / 虚拟页面 ...................................................................................................739 20.1 简介......................................................................................................740 20.2 要求......................................................................................................740 20.3 配置......................................................................................................741 20.4 示例.....................................................................................................741 20.4.1 基本示例 ................................................................................................741 20.4.2 使用窗口管理器的实时示例 ..........................................................................743 20.4.3 使用窗口管理器的对话框示例 .......................................................................744 20.5 虚拟屏幕 API...........................................................................................746 21 多层 / 多显示支持 .......................................................................................................747 21.1 简介......................................................................................................748 21.1.1 选择绘图操作所使用的层 .............................................................................748 21.1.2 选择窗口所使用的层 ..................................................................................748 21.1.2.1 把窗口从一层移到另一层 .............................................................................749 21.2 使用多层支持...........................................................................................751 21.2.1 透明......................................................................................................751 21.2.2 Alpha 混合 .............................................................................................752 21.2.3 硬件游标 ................................................................................................753 21.2.4 多层示例 ................................................................................................753 21.3 使用多显示支持 ........................................................................................753 21.3.1 启用多显示支持 ........................................................................................753 21.3.2 运行时间屏幕旋转 .....................................................................................754 21.3.3 多显示示例 .............................................................................................754 21.4 配置多层支持...........................................................................................754 21.5 配置多显示支持 ........................................................................................755 21.6 多层 API .......................................