摘要

　　经过用户多年的使用，紫金桥组态软件中已经保存了大量历史数据。随着历史数据的增多，紫金桥组态软件的应用范围也发生了一些变化，从最初的简单画面浏览，逐渐发展到现在的历史数据分析、工艺优化等。在发展过程中，饼图的应用变得逐渐增多，用户对饼图的要求也随之增加，分离饼图就是依据用户的最新需求而开发的。

关键词

　　组态软件、分离饼图、历史数据、GDI+

本文将要介绍紫金桥分离饼图组件的使用方法及接口函数说明。

一、分离饼图整体运行效果

　　首先看一下整体运行效果图：

立体运行效果图（图1）

平面运行效果图（图2）

　　分离饼图是在原有饼图基础上的渲染优化和功能增加。优化方面主要使用GDI+进行了图像渲染，使画面看起来更加流畅和平滑。功能方面增加了饼块的分离效果。

　　分离分为2种：立体分离和平面分离。立体分离的效果如图1所示，饼块按照Y轴向上分离；平面分离如图2所示，饼块按照自身角度背离其他饼块的方向分离。

二、分离饼图组件使用方法及接口函数说明

　　1、组件安装

　　紫金桥组态软件图库里选择【分离饼图】组件，如下图3所示：

选择分离饼图组件(图3)

　　2、组件属性

基本属性（图4）

高级属性（图5）

　　属性分为2类：基本属性和高级属性。基本属性定义了组件的主要外观设置，高级属性中可以设置标签、阴影、起始角度等。

　　3、组件接口函数说明：

　　1）GetTagName(Int nIndex) As String

　　函数说明:按照索引得到对应饼块的表达式或位号名。

　　参数说明:

　　nIndex : 整数类型，对应饼块的索引号。

　　2）SetTag(Int nIndex, String csTagName, String csDesc, Int nColor, String csTip) As Int

　　函数说明:按照索引增加或更改一个饼块。

　　参数说明:

　　nIndex : 整数类型，对应饼块的索引号。

　　csTagName : 字符串类型，饼块对应的位号名，注意在运行时动态增加的只可为位号名，不可是包括运算符在内的表达式。

　　csDesc : 字符串类型，饼块对应的标签。

　　nColor : 整数类型，饼块对应的颜色。

　　csTip : 字符串类型，饼块对应的提示。

　　3）ShowSetDlg()

　　函数说明:显示设置对话框。

　　4）SetSelTag(Int nIndex)

　　函数说明:设置指定索引号的饼块为选中项。

　　参数说明:

　　nIndex : 整数类型，指定饼块的索引号。

　　5）GetSelTag() As Int

　　函数说明:返回当前选中项的索引号。

三、总结：

　　随着紫金桥组态软件使用范围的不断拓展，对软件功能和画面会有更高的要求，紫金桥软件也会依据应用进行不断的完善。