PB控件：Graph图形控件
Graph图形控件
【其他】
■轴
类型轴--Category--String型、数值型、Date型、Datetime型和Time型
值轴--Value--数值型、Date型、Datatime型和Time型
系列轴--Series--String型
■图形外观
PowerBuilder提供了17种图形外观，可以粗略划分为平⾯图形和⽴体图形两⼤类，也可以更细致地划分为5类，即（1）条型、列型（包括它们的⽴体变形）；（2）区域和线型图形（包括它们的⽴体变形）；（3）堆积图；（4）饼型图（包括⽴体变形）；（5）散点图。
■图形控件的三种使⽤⽅式。使⽤Graph显⽰样式的数据窗⼝是Graph类型控件最常使⽤的⼀种⽅式，因
上海话绕口令
为这种⽅式提取数据⽐较⽅便，运⾏时动态改变要查看的范围也⽐较灵活。但是，由于这种使⽤⽅式的数据来源只局限于，所以当应⽤程序还需要应⽤处理其他来源的数据时可以考虑使⽤窗⼝中的Graph控件。最后⼀种是在数据窗⼝中的Graph控件，因为这种⽅式不能⾃动提取数据，需要编写的脚本⽐较多，所以这种⽅式使⽤⽐较少。但是，因为提取数据都是由脚本完成，所以开发⼈员可以有更多的灵活性，可以让⽤户在运⾏时根据需要更灵活地控制控件的运⾏，所以在⾼级的应⽤软件中该控件还是经常使⽤的。
【属性】
▲Title属性：该届性保存的是Graph的标题内容，在控件的上⽅显⽰的⼤字标题，是String类型的属性。创建Graph控件后⾸先就要修改该属性，该属性应该说明图形中数据的⽤途、统计范围等信息。该属性可以在运⾏时修改。⽐如，修改窗⼝中Graph控件gr_1的标题，可以使
联想和想象
⽤gr_1.title="商品销量统计"；要修改Graph显⽰样式的数据窗⼝对象的标题，可以使⽤dw__1.title="商品销量统计"；如果要修改数据窗⼝对象中Graph控件
gr_1的标题，可以使⽤语句dw__1.title="商品销量统计"。
▲GraphType属性：指定图形的外观类型。该属性的设定⽐较直观，都有相应样式的图标，在开发时
设定只要在相应的属性窗⼝中选择就可以了。如果在运⾏时设定，可以⽤脚本修改控件的属性取值。对于窗⼝中的Graph控件使⽤相应的枚举值，gr_1.GraphType = Pie3D!；对于数据窗⼝中的控件或者Graph显⽰祥式的数据窗⼝使⽤相应的数值，dw__1.graphtype= 17。
▲Axis.Label属性：该属性可以设定不同坐标轴的标签。其中Axis可以是category，values和ries三个。当统计图的设置需要根据⽤户的选择来确定时，需要在运⾏时修改坐标轴标签，可以使⽤该属性。
窗⼝中的Graph控件gr_1
gr_1.category.label = "haha"
gr_1.ries.label = "hoho"
gr_1.values.label = "hehe"
数据窗⼝控件对应的数据窗⼝对象中图形控件gr_1
dw__1.category.label = "xaxa"
dw__1.ries.label = "xoxo"
dw__1.values.label = "xexe"
图形显⽰样式的数据窗⼝中图形gr_1（同上）
▲Legend属性：当Graph中有系列时该属性可以控制例图（legend）是否显⽰以及显⽰在什么位置。数据窗⼝中取值为数字，窗⼝控件中的取值为枚举型。
窗⼝中的Graph控件gr_1：gr_1.legend = atleft!
数据窗⼝控件对应的数据窗⼝对象中图形控件gr_1和图形显⽰样式的数据窗⼝中图形gr_1:
dw__1.legend = 1
▲（其他属性见帮助）
**Graph控件的属性
General属性页
▲GraphType属性：该属性⽤来定义图形控件的外观。PowerBuilder提供了17种图形外观，见前⾯
▲SeriesSort和CategorySort属性：该属性确定系列轴和分类轴的排序⽅式，是枚举型属性，有三个可⽤的取值：Ascending!为升序排
列，Descending!为降序排列，Unsort!为原始顺序。
▲Legend属性：该属性⽤来定义是否显⽰例图以及显⽰在什么位置。可⽤的取值有atbottom!（底部），attop!（上⾯），atleft!（左
⾯），atright!（右⾯）和nolegend!（不显⽰）。
▲Perspective属性：该属性⽤来确定图形和窗⼝之间的距离，只适⽤于三维图形。通过拖动滑块可以调整该属性取值的⼤⼩，滑块拖动的同时就可以看见效果。
▲Elevation属性：该属性⽤来调整三维图形的视⾓，只适⽤于三维图形。拖动属性窗⼝中该属性的滑块向左移动时图形顺时针旋转，向右移动时图形做逆时针旋转。
▲Rotation属性：该属性在⽔平⾓度旋转图形，只适⽤于三维图形。该属性和上⾯的Elevation属性相配合，可以给⽤户最佳的观看⾓度。当然，在程序运⾏时允许⽤户修改这两个属性是最好的。
▲OverLapPercent属性：该属性确定图形的各个系列的重叠程度，以百分⽐的形式表⽰，该属性适⽤于平⾯图和列型图。在属性窗⼝中可以通过调节滑块来调整属性的取值。
▲Spacing属性：该属性⽤来确定分类轴上数据条或列之间的距离⼤⼩，以占⽤条或者列宽度的百分⽐表⽰。该属性不能⽤于平⾯区域图、平⾯线型图、平⾯饼图和散点图。例如，gr_1.Spacing=110表⽰数据条之间的距离为条本⾝宽度的110%。
▲Depth属性：该属性⽤来调整三维图形的厚度，只适⽤于三维图形。
Axis属性页
▲Axis下拉框：该下拉框⽤来选择要设置属性的坐标轴，可以选择的值有Category和Values，当图形外观为三维并且有系列轴时还可以选
择Series。进⼊到Axis属性页时⾸先就应该明确该下拉框的取值。选择不同的轴，该属性页中的属性即为选定轴对应的属性。当在脚本中修改图形控件的外观时，也应该指定是对哪个坐标轴的属性进⾏操作。语句格式是：Graphcontrolname.axisname.property=属性值。其
中，axisname的值和该下拉框的可⽤值相同，property为坐标轴的属性。
▲Label属性：该属性⽤来定义Axis下拉框中选中的坐标轴的标签。上⾯已经介绍过如何在脚本中修改该属性，在开发环境中可以直接输⼊标签的内容。
▲ShareBackEdge属性：布尔类型属性，该属性⽤来指定三维图形是否有背景阴影。该属性缺省为True，表⽰背景有阴影。
▲AutoScale属性：布尔类型的属性，表⽰是否⾃动根据添加的数据值确定轴上显⽰的数据的刻度，即是否⾃动确定数据的最⼤值和最⼩值。并不是对所有类型的图形外观都可以修改该属性的，绝⼤多数的图形外观中该属性都为True并且不允许为Fal，只有散点图可以修改该属性为Fal或者为True。
▲DataType属性：该属性⽤来确定在坐标轴上显⽰的数据的类型。不同的坐标轴可以使⽤的数据类型不同，在前⾯已经做过详细的介绍。在开发环境中通过选择可以指定坐标轴的数据类型。
▲RoundTo和RoundToUnit属性：这两个属性确定在AutoScale属性选中时轴上刻度的最⼤值和单位。当坐标轴变量的取值⼤于RoundTo属性的取值时，该坐标轴的最⼤刻度⾃动调整增加RoundTo的整数倍。⽐如，RoundTo取值为15，⽽坐标轴变量取值为18，则⾃动将该轴的最⼤刻度调整为30；如果坐标轴的最⼤取值为31，则坐标轴⾃动调整最⼤刻度为45。当坐标轴变量的最⼤取值都⼩于RoundTo属性值时，则坐标轴的最⼤刻度为RoundTo的取值。该属性的设置要和坐标轴的数据类型相匹配。RoundTo是Double类型，RoundToUnit是枚举类型，它的取值范围取决于坐标轴的数据类型，坐标轴的每种数据类型都对应⼀些可⽤的RoundToUnit取值。⽐如，当坐标轴的DataType属性为AdtDate!时，RoundToUnit的取值可以为rndDefault!，rndyears!，rndMonths!和rndDays!等。
▲MinimumValue和MaximunValue属性：当AutoScale属性为Fal时该属性可⽤，同时RoundTo和RoundToUnit属性不可⽤。所以只有散点图中可以使⽤该属性，该属性⽤来设置坐标轴的最⼤值和最⼩值。
▲ScaleType属性：该属性设置刻度的类型。通常的刻度类型是线型的，但有时也许需要对数类型的刻度。该属性的三个可⽤值
是Linear!，Log10!和Loge!。
▲设置主刻度线：坐标轴的刻度线可以进⾏⼆级划分，即主刻度线和次刻度线，这样读取数据更⽅便、快捷。主刻度线的设置需要⼀组属性，包括主刻度线的个数（Major Divisions），刻度线的类型（MajorTic属性，可⽤的取值有4个：Outside!表⽰向外，Inside!表⽰向
内，Straddle!表⽰交叉和Notic!表⽰没有刻度线），是否显⽰主刻度线⽹格线（MajorGridLine属性，有6个可⽤的值，可以直接在下拉框中选择需要的类型），每组⼏个刻度显⽰标签（DisplayEveryNLabels属性）等。
▲设置次刻度线：次刻度线的许多属性和主刻度线的类似，包括次刻度线的个数（MinorDivisions属性），次刻度线的类型（MinorTic）和是否显⽰次刻度⽹格线（MinorGridLine）等。
▲线条风格：⽤来指定主轴线（PrimaryLine属性）、辅助轴线（SecondaryLine属性）、0值线（OriginalLine）和框架线(Frame)等的线段类型。可以使⽤的类型有Continuous!，Dash!，Dot!，DashDot!，DashDotDot!和Transparent!。
Text属性页
该属性页中设置控件各个部分显⽰的⽂字内容和⽂字的显⽰⽅式。⽂字的这些显⽰属性是通过grDispAttr对象来定义的，可以在PB提供的⼯具Browr窗⼝中查看该对象的详细属性。在脚本中需要引⽤这些属性时可以使⽤如下格式：
DispAttrName.Property
小米手机忘记密码其中的Property可以从Browr窗⼝中查得，其他表⽰相应的属性。⽐如，要修改Graph控件gr_1的Series坐标轴的字体显⽰属性为Italic，可以使⽤下⾯的语句：
gr_1.Series.DispAttr.Italic=True
▲TextObject下拉框：在图形控件中有很多的⽂本对象，在设定属性之前应该⾸先指定需要设定哪些⽂本对象的属性，该下拉框中就是要选择设定属性的⽂本对象。各个取值的含义如下：
Title 图形控件的标题
Value Axis Label 数据轴的标签
Legend 例图
Value Axis Text 数据轴的⽂本
Category Axis Label 分类轴的标签绝境求生手册
Series Axis Label 系列轴的标签
Category Axis Text 分类轴的⽂本
Series Axis Text 系列轴的⽂本
▲DisplayExpression属性：该属性确定⽂本对象的显⽰内容，单击右侧的省略号按钮弹出编辑窗⼝，在编辑窗⼝中可以编辑表达式。表达式中可以使⽤运算符以及系统为Graph控件提供的⼀些缺省变量，这些都可以在编辑窗⼝中通过选择来组合表达式。
▲Escapement属性：该属性⽤来旋转⽂本对象的显⽰⽅向（对于标题和例图不可⽤）。例如，在TextObject下拉框中选择Category Axis Label⽂本时，然后在Escapement属性框中输⼊900，则⽂本
对象逆时针旋转了90度，变成了垂直显⽰。在脚本中需要控制⽂本对象的旋转⾓度，可以⽤脚本修改相关对象的Escapement属性。⽐如修改gr_1的分类轴上标签显⽰⽅
向：gr_1.Category.LabelDispAttr.Escapement=1800
数据窗⼝中的图形控件和Graph显⽰样式的数据窗⼝对象的属性
这两种情况下的图形实际上是相同的，都是图形控件，并且都可以为图形命名，使⽤该名称引⽤图形控件。下⾯的介绍中对这两种情况不加以区分。
▲Data属性页
该属性页⽤来设置Graph控件最重要的⼏个属性，即图形控件的数据来源。Category，Value与Series分别⽤来设定⼏个轴的数据来源，可以直接选择其中的字段或者表达式，也可以⼿⼯输⼊，数据窗⼝对象中的很多表达式在这⾥都可以直接使⽤。⽐如，可以定
义Day(RegDate)为Series的数据源，其中RegDate是⼀个Date类型的字段，Day是⼀个提取⽇期的函数。对于初学者如果不能确定表⽰式是否正确，⼀个好的⽅法是将表达式⾸先在数据窗⼝对象的计算字段表达式窗⼝中进⾏校验，如果通过则可以使⽤。使⽤表达式可以更⽅便、精确地控制图形的显⽰。
数据窗⼝中的Graph控件可以选择显⽰数据的范围为page或all，⽽Graph显⽰样式的数据窗⼝只能选择all，即所有的数据。
▲General属性页
该属性页中设置常⽤的属性，Graph显⽰样式的数据窗⼝有该属性页，实际上该属性页和其他显⽰样式的数据窗⼝区别不⼤，只是增加
第四单元
了Name，Line Color与ShadeColor三个属性，这三个属性分别⽤来设置图形控件的名称、线条的颜⾊和阴影的颜⾊，其他属性参见前⾯关于数据窗⼝对象的介绍。
▲Graph属性页
该属性页设置图形的外观，很多属性都和窗⼝中的Graph控件在General属性页中的同名属性含义是相同的，在此不再赘述。
【函数】
Graph控件函数
★AddCategory函数：函数的语法是controlname.AddCategory(categoryname)，作⽤是添加⼀个分类轴。只有当分类轴的数据类型
为string时可以使⽤该函数。函数执⾏成功返回新添加分类轴的索引号，如果已经有同名的分类轴存在则返回同名分类轴的索引号。当原分类轴设置了排序属性，则新添加的分类轴按照原规则⾃动调整到适当的位置。函数执⾏错误返回-1。当需要在指定的位置添加分类轴时可以使⽤InrtCategory函数，当需要添加⾮string类型的分类袖时使⽤InrtCategory函数。例如，gr_1.addcatagory("pcs")的作是向图形控件中添加⼀个名称为pcs的分类轴。
★AddSeries函数：函数的语法是controlname.AddSeries(riesname)，作⽤是向图形控件controlname中添加名称为riesname的系列轴。其中，riesname为string类型的参数，
是要添加的系列轴的名称。函数执⾏成功返回新添加的系列轴的索引号，如果已经有同名系列轴存在，则返回同名系列轴的索引号。函数执⾏错误返回-l。当需要添加其他类型的系列轴时使⽤InrtSeries函数。例如，向图形控件gr_1中添加⼀个名称为costs的系列轴，并保存它的索引号，可以使⽤语句：ls_s = gr_1.addries("costs")
★AddData函数：作⽤是向图形控件的数据轴添加数据，该函数有两种语法格式。controlname.AddData(riesnumber,datavalue
{,categoryvalue})⽤于除了散点图之外的所有形式的图形控件，⽽controlname.AddData(riesnumber,xvalue,yvalue)专门⽤于散点图。第⼀种语法格式时，将数据添加到指定系列轴的指定分类轴上(如果指定了分类轴)或者最后⼀个分类轴上(没有指定分类轴)；当指定的分类轴不存在时则直接创建该分类轴，并按照原来分类轴的排序规则直接将该分类轴调整到适当的位置，然后将数据添加到相应的位置；如果指定的分类轴已经存在则数据将替换原来的数据。第⼆种语法格式时，xvalue和yvalue分别为要添加的X和Y轴数据的⼤⼩，添加的位置由参
数riesnumber确定。这两种格式的函数，不管哪种都经常和函数FindSeries搭配使⽤，除⾮只有数量确定的系列轴。
★SetDataStyle函数：该函数有三种语法格式，分别⽤来设定图形控件的颜⾊，线型和填充⽅式等。语法如下：
controlname.SetDataStyle(riesnumber,datapointnumber,colortype,color)
controlname.SetDataStyle(riesnumber,datapointnumber,linestyle,linewidth)
controlname.SetDataStyle(riesnumber,datapointnumber,enumvalue)
其中controlname是Graph控件的名称。各个参数的含义如下：
riesnumber：integer类型，是要设置的数据所在系列的索引号
datapointnumber：integer类型，是要设置的数据所在数据点的索引号（也可以理解成是category的索引号）
colortype：GrcolorType枚举类型，⽤来指定要设置数据哪⽅⾯的颜⾊。可⽤的取值有Foreground!（⽂本颜⾊），Background!（背景颜⾊），LineColor!（线段的颜⾊）和Shade!（阴影的颜⾊，只适⽤于三维图形）
color：long类型，为colortype的新颜⾊。经常使⽤GRB函数来计算颜⾊，也可以按65536*Blue + 256*Green + Red的公式⾃⼰来计算颜⾊的取值
linestyle：LineStyle枚举类型，⽤来指定线段的类型。可⽤的取值有Continuous!，Dash!，DashDot!，DashDotDot!，Dot!与Transparent! linewidth：integer类型，是⽤象素数量来表⽰的线段的宽度
enumvalue：枚举类型，⽤来设置数据点的填充⽅式或者符号类型，系统会根据参数的取值⾃动识别是设置填充⽅式还是符号类型。当设置填充⽅式时的可⽤值有Bdiagonal!，Diamond!，Fdiagonal!，Horizontal!，Solid!，Square!和Vertical!
三种语法格式中前⾯的两个参数都相同。如果想要将经过颜⾊设置的数据点恢复到缺省的颜⾊，可以使⽤函
数gr_1.RetDataColors(riesnumber,datapointnumber)。
★SetDataPieExplore函数：该函数是⼀个⾮常有⽤的函数，可以使饼型图中某部分的图形分离出来，在进⾏数据分析时经常使⽤该函数进⾏强调显⽰。该函数只适⽤于饼型图，语法是：controlname.SetDataPieExplode(risnumber,datapoint,percentage)，其中，参
数percentage表⽰分离的饼块离开饼型图中⼼的距离占饼型图半径的百分⽐，取值范围为0-100，可以为⼩数。函数执⾏成功返回1，执⾏失败返回-1，如果参数为NULL，则返回NULL。经常在图形控件的DoubleClicked事件中调⽤该函数和函数ObjectAtPointer配合。使⽤户双击部分分离显⽰。如：
integer li_ries,li_datapoint
grobjecttype lgobt_clicked
aphtype <> piegraph! aphtype <> pie3d! thenreturn
lgobt_clicked = this.objectatpointer(li_ries,li_datapoint)
if (li_ries > 0 and li_datapoint > 0) then
this.tdatapieexplode(li_ries,li_datapoint,50)
鹿油的功效和作用end if
和该函数相关的函数是GetDataPieExplode，它的作⽤是查看某个饼块是否从饼型图中分离出来，并且得到分离出来的饼块的百分⽐。函数的语法是：controlname.GetDataPieExplode(ries,datapoint.percentage)
★SetSeriesStyle函数：该函数有四种语法格式，分别⽤来设置系列轴的颜⾊、线型、填充⽅式与是否重叠等。语法如下：controlname.SetSeriesStyle(riesname,colortype,color)
controlname.SetSeriesStyle(riesname,linestyle,linewidth)
controlname,SetSeriesStyle(riesname,enumvalue)
其中，参数riesname为string类型的系列轴的名称，其他参数的意义和函数SetDataStyle中的同名参数是相同的。该函数经常
和SeriesName函数配合使⽤，来读取已知索引号的系列轴的名称，然后再调⽤该函数设置其风格。如，下⾯的脚本⽤来改变⽤户点击处的系列轴的填充⽅式：
string ls_riesname
integer li_riesnbr,li_riespoint
grobjecttype lgobt_mouhit
lgobt_mouhit = this.objectatpointer(li_riesnbr,li_riespoint) //获取⽤户点击信息
if lgobt_mouhit = typeries! then //如果点击的是系列轴
ls_riesname = gr_1.riesname(li_riesnbr) //获取点击的系列轴的名称
end if
上⾯的函数可以允许应⽤程序在运⾏时让⽤户根据⾃⼰的偏爱来修改图形控件的外观，另外还应该让⽤户选择他所偏爱的图形类型。这可以通过改变控件的graphtype属性来实现，
可以构建下拉列表拒和下拉图形列表框等很多⽅式，让⽤户来选择图形控件的外观。
伏羲是谁★其他函数（具体语法见帮助）
FindaCategory 查找特定标签内容的分类轴的索引号
FindSeries 查找特定标签内容的系列轴的索引号
GetData 获取指定系列、数据点处的数据
GetDataPieExplode获取饼图分离的⽐例
GetDataStyle 获取数据点的外观属性，具体语法取决于要获取哪⽅⾯的属性
GetDataValue 获取指定系列轴、指定数据点的数据
GetSeriesStyle 获取系列轴的外观属性，具体语法取决于要获取哪⽅⾯的属性
ImportClipBoard 将剪贴板上的数据插⼊到图形控件中
ImportFile 从指定的⽂件中输⼊数据到图形控件中
ImportString 从指定的字符串中输⼊数据到图形控件中
ModifyData 修改指定系列轴、指定数据点的数据，有两种语法格式
SaveAs 按照指定的格式保存图形控件中的数据
SeriesCount 计算图形控件中系列的数⽬
SeriesName 获取指定索引号的序列的名称
CategoryCount 计算图形控件中分类轴的数⽬
CategoryName 获取指定索引号的分类轴的名称
DataCount 计算指定系列轴上数据点的数⽬
DeleteCategory 删除指定的分类轴
DeleteData 删除指定系列轴上的指定的数据点
DeleteSeries 删除指定的系列轴
ObjectAtPointer 获取⽤户⿏标点击处控件的相关信息
★ObjectAtPointer函数是⼀个⾮常重要的函数，经常在图形控件的Clicked事件或者DoubleClicked事件中⽤该函数获取⽤户⿏标点击处控件的相关信息，进⽽判断是否选择了图形控件的特定部件，从⽽决定是否继续执⾏其他脚本。该函数是⼀个⽐较重要的函数，应该加以掌握。函数语法是：
controlname.objectAtPointer({Graphcontrol,}riesnumber,datapoint)
其中，controlname是图形控件的名称，通常在图形控件的相关事件中编写脚本时可以使⽤
This指代词或者省略；当该函数⽤于数据窗⼝时参数Graphcontrol为数据窗⼝对象中的图形控件名称，这时controlname为数据窗⼝控件的名称。另外两个参数都是⽤来保存相关信息的，其中riesnumber保存⿏标点击的系列轴的索引号，datapoint⽤来保存⿏标点击处的数据点的⼀个integer类型的参数。函数返回值为grObjectType类型的枚举值，⽤来指明⽤户所点击的是图形控件的哪⼀部分。经常对该函数的返回值进⾏判断，看⽤户是否选择了控件的特定部分。返回值有如下取值：
TypeCategory! 分类的标签
TypeLegend! 在例图框中，但不在系列标签上
TypeCategoryAxis!分类轴或者标签间
TypeSeries! 联结系列的数据点的线（当图形为线型时），或者是例图框内的系列标签
TypeCategoryLabel!分类轴的标签
TypeSeriesAxis! 三维图形的系列轴
TypeData! 数据点或者其他数据标记
TypeSeriesLabel!三维图形系列轴的标签
TypeGraph! 图形控件内不是另⼀个grObjectType的任何位置
TypeTitle! 图形的标题
TypeValueAxis! 包括指标签的值轴
TypeValueLabel! 值轴的标签
**数据窗⼝中的Graph控件
如何在程序运⾏时控制数据宙⼝中的图形控什，使其外观、数据显⽰等都符合⽤户的要求，这些情况
华清池长恨歌
和窗⼝中的图形控件是类似的。因为数据窗⼝中的图形控件可以⾃动提取数据，所以⼤部分⼯作是修改控件的图形外观以及如何获取图形控件中的相关信息。窗⼝中图形控件的很多函数也可以使⽤，语法稍微有些区别，⼀般都⽐其多⼀个参数⽤来指定图形控件的名称，并且这个参数是第⼀个参数。⽐如，获取⽤户在数据窗⼝中图形控件上点击的信息，可以使⽤如下语法格式的ObjectAtPointer函数：
controlname.objectatpointer(graphcontrol,riesnumber,datapoint)
⽽在窗⼝中的语法格式如下：
controlname.objectatpointer(riesnumber,datapoint)
其中，参数Graphcontrol为string类型的参数，为数据窗⼝中的图形控件的名称。函数执⾏后的返回值和窗⼝中Graph控件的同名函数的返回值相同。
