33.16. <g:legend>

尽管每个图形构件提供了legend属性,用于设置图例的文本内容,但是功能过于简单,无法满足用户的特别要求。Legend构件用于显示数据表的图例,同时提供了一些属性,通过对这些属性的设置,可以产生出不同样式的图例,满足用户的特别要求。

33.16.1. 构件信息

表 33.43. 构件信息

Component Typeorg.operamasks.faces.graph.Legend
Component Familyorg.operamasks.faces.graph.Legend
Component Classorg.operamasks.faces.component.graph.UILegend
Tag Classorg.operamasks.faces.webapp.graph.LegendTag

继承体系

+java.lang.Object

++javax.faces.component.UIComponent

+++javax.faces.component.UIComponentBase

++++org.operamasks.faces.component.graph.UILegend

33.16.2. 属性

表 33.44. 属性

backgroundColor 定义类 org.operamasks.faces.component.graph.UILegend
类型 javax.el.ValueExpression(java.lang.Object)
是否必须 延时求值
指定构件背景色
binding 定义类 javax.faces.component.UIComponentBase
类型 javax.el.ValueExpression(javax.faces.component.UIComponent)
是否必须 延时求值
一个值表达式,用于把该组件链接到一个ManagedBean的某个属性。
borderColor 定义类 org.operamasks.faces.component.graph.UILegend
类型 javax.el.ValueExpression(java.lang.Object)
是否必须 延时求值
指定构件边框的颜色
borderWidth 定义类 org.operamasks.faces.component.graph.UILegend
类型 javax.el.ValueExpression(java.lang.Float)
是否必须 延时求值
指定构件边框的宽度
bottomMargin 定义类 org.operamasks.faces.component.graph.UILegend
类型 javax.el.ValueExpression(java.lang.Double)
是否必须 延时求值
指定构件与图片下边框之间的距离
id 定义类 javax.faces.component.UIComponentBase
类型 java.lang.String
是否必须 延时求值
这个组件的组件标识符。这个值在最近的命名容器类型的父组件范围内,必须是唯一的。
itemColor 定义类 org.operamasks.faces.component.graph.UILegend
类型 javax.el.ValueExpression(java.lang.Object)
是否必须 延时求值
指定字体颜色
itemFont 定义类 org.operamasks.faces.component.graph.UILegend
类型 javax.el.ValueExpression(java.lang.Object)
是否必须 延时求值
指定构件的字体,属性值的格式为"font-name,font-style,font-size"
leftMargin 定义类 org.operamasks.faces.component.graph.UILegend
类型 javax.el.ValueExpression(java.lang.Double)
是否必须 延时求值
指定构件与图片左边框之间的距离
position 定义类 org.operamasks.faces.component.graph.UILegend
类型 javax.el.ValueExpression(org.operamasks.faces.component.graph.PositionType)
是否必须 延时求值
指定构件在图片中的位置,属性值必须是org.operamasks.faces.component.graph.PositionType类型的枚举值
rendered 定义类 javax.faces.component.UIComponentBase
类型 boolean(boolean)
是否必须 延时求值
一个标志,指出该组件是否要在任何随后的form提交过程中被渲染或处理。 这个属性的缺省值是true。
rightMargin 定义类 org.operamasks.faces.component.graph.UILegend
类型 javax.el.ValueExpression(java.lang.Double)
是否必须 延时求值
指定构件与图片右边框之间的距离
topMargin 定义类 org.operamasks.faces.component.graph.UILegend
类型 javax.el.ValueExpression(java.lang.Double)
是否必须 延时求值
指定构件与图片上边框之间的距离

33.16.3. 构件API

33.16.3.1. PositionType(枚举类型)

表 33.45. 枚举成员

名称 说明
Top构件在图片内部的上方
Bottom构件在图片内部的下方
Left构件在图片内部的左方
Right构件在图片内部的右方
TopLeft构件在图片内部的左上方
TopRight构件在图片内部的右上方
BottomLeft构件在图片内部的左下方
BottomRight构件在图片内部的右下方
LeftTop构件在图片内部的左上方
LeftBottom构件在图片内部的左下方
RightTop构件在图片内部的右上方
RightBottom构件在图片内部的右下方
Center 
Stretch 

33.16.4. 示例

以下的例子介绍了g:legend标签使用方法,在这个例子中使用了构件中比较常用的属性,如背景色、字体样式、相对位置等:

<g:scatterChart title="XY Annotation Demo">
    <g:legend position="Right" rightMargin="5" backgroundColor="white" borderColor="gray" 
        itemFont="Arial,blod,12"/>
  
    ......

</g:scatterChart>