第45篇emWin(ucgui)GRAPH-图形控件.pdf

STM32-V5 开发板 STemW in 教程 STM32-V5 开发板 STemW in 教程 第45章 GRAPH-图形控件 本期教程讲解 STemWin 支持的绘图控件。 45. 1 绘图件介绍 45. 2 官方 WIDGET_GraphYT 实例 45. 3 使用官方 GUIBulder 建立 Graph 控件 45. 4 总结 45.1 图形控件介绍 图形控件可用于可视化数据。图形控件的典型应用是显示测量值或函数图形的曲线，可同时显示多条曲 线。可使用水平和垂直刻度来标记曲线。可在背景上显示具有不同水平和垂直间距的网格。如果数据阵列不 能容纳进图形的可见区域，小工具可自动显示滚动条，从而可在大的数据阵列中进行滚动。 45.1.1 图形控件的结构 图形控件由不同种类的对象组成：  图形控件自身，可以附加数据对象和刻度对象。  可选的一个或多个数据对象。  可选的一个或多个刻度对象。 下图显示了图形控件的详细结构： 截图中每个参数表示的含义如下： 第 1 页 共 14 页 第 1 页 共 14 页 STM32-V5 开发板 STemW in 教程 STM32-V5 开发板 STemW in 教程 参数 描述 Border 可选边框是图形小工具的一部分。 Frame 数据区四周的细线，是图形小工具的一部分。 Grid 显示在数据区的背景中，是图形小工具的一部分。 Data area 网格和数据对象的显示区域。 Data object(s) 对于每条曲线，应向图形小工具添加一个数据对象。 Appdefined graphic 应用程序定义的一种回调函数，可用于绘制任何应用程序定义的文本和/或图形。 Scrollbar(s) 如果数据对象的范围大于图形小工具的数据区，则图形小工具可自动显示水平 Scale object(s) 可附加到图形小工具的水平和垂直刻度。 X-Size 数据区的 X 尺寸。 Y-Size 数据区的 Y 尺寸。 45.1.2 创建和删除图形小工具 创建图形控件的过程如下：  创建图形控件并设置所需的属性。  创建数据对象。  将数据对象附加到图形控件。  创建可选的刻度对象。  将刻度对象附加到图形控件。 附加到图形控件后，就不需要通过应用程序来删除数据和刻度对象，而由图形控件完成。 示例 GRAPH_DATA_Handle hData; GRAPH_SCALE_Handle hScale; WM_HWIN hGraph; hGraph = GRAPH_CreateEx(10, 10, 216, 106, WM_HBKWIN, WM_CF_SHOW, 0, GUI_ID_GRAPH0); hData = GRAPH_DATA_YT_Create(GUI_DARKGREEN, NumDataItems, aData0, MaxNumDataItems);