| 包 | mx.charts |
| 类 | public class GridLines |
| 继承 | GridLines  ChartElement DualStyleObject UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Flex 可绘制与父级图表的刻度线对齐的网格线。默认情况下，Flex 会沿相应的轴在每个刻度线上绘制一条线。
通常可将 GridLines 类用作图表控件的 backgroundElements 属性或 annotationElements 属性的子标签。
隐藏 MXML 语法The <mx:GridLines> tag inherits all the properties
of its parent classes and adds the following properties:
显示 MXML 语法
<mx:GridLines
Styles
direction="horizontal|vertical|both"
horizontalAlternateFill="null"
horizontalChangeCount="1"
horizontalFill="null"
horizontalOriginStroke="IStroke; No default"
horizontalShowOrigin="Default depends on type of chart"
horizontalStroke="IStroke; No default"
horizontalTickAligned="true|false"
verticalAlternateFill="null"
verticalChangeCount="1"
verticalFill="null"
verticalOriginStroke="IStroke; No default"
verticalShowOrigin="Default depends on type of chart"
verticalStroke="IStroke; No default"
verticalTickAligned="true|false"
/>
另请参见
| 方法 | 定义方 | ||
|---|---|---|---|
构造函数。 | GridLines | ||
 | 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | ChartElement | |
| 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | ChartElement | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
| 指示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | |
| 排队稍后调用的函数。 | UIComponent | |
| 封闭图表调用此方法来指示该图表的当前状态已更改。 | ChartElement | |
| 图表调用此方法来允许相关元素声明其 chartSeriesStyles Array 中的样式选择器。 | ChartElement | |
| 删除此组件实例中的样式属性。 | UIComponent | |
| 封闭图表调用此方法来收集特定元素在图表状态发生更改时可能执行的任何过渡。 | ChartElement | |
| 确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | |
| 将 Point 对象由内容坐标转换为全局坐标。 | UIComponent | |
| 将 Point 对象由内容坐标转换为本地坐标。 | UIComponent | |
| 返回标识此容器中的子项的一组属性。 | UIComponent | |
| 在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | |
| 将数据值元组转换为屏幕上的 x-y 坐标。 | ChartElement | |
| 在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | |
| 由具有控制地位的 DataTransform 调用，以获得由此 IChartElement 表示的数据描述。 | ChartElement | |
| 返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | |
| 将事件调度到事件流中。 | UIComponent | |
| 在此组件周围显示或隐藏焦点指示符。 | UIComponent | |
| drawRoundRect(x:Number, y:Number, width:Number, height:Number, cornerRadius:Object = null, color:Object = null, alpha:Object = null, gradientMatrix:Matrix = null, gradientType:String = "linear", gradientRatios:Array = null, hole:Object = null):void 通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | UIComponent | |
| 停止在组件上播放效果实例时，由效果实例调用。 | UIComponent | |
| 开始在组件上播放效果实例时，由效果实例调用。 | UIComponent | |
| 结束组件上当前播放的所有效果。 | UIComponent | |
| 将数据绑定到此 UIComponent 对象。 | UIComponent | |
| 在给定坐标“下方”查找由该元素表示的最近数据点。 | ChartElement | |
| 打印完成后调用。 | UIComponent | |
| 返回所有基础 ChartElement 的项目的 HitData 数组，在 showAllDataTips 设置为 true 时将在图表上显示此 ChartElement 的 dataTip。 | ChartElement | |
| 在指定的索引位置提供自动化对象。 | UIComponent | |
| 返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
| 返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | |
| 返回具有指定名称的子显示对象。 | DisplayObjectContainer | |
| 返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | |
| 查找此 UIComponent 实例的类型选择器。 | UIComponent | |
| 返回一个约束布局值，这与获取此组件的约束样式的方式类似。 | UIComponent | |
| 确定是使用显式高度还是测量高度的一种简便方法 | UIComponent | |
| 确定是使用显式宽度还是测量宽度的一种简便方法 | UIComponent | |
| 获取当前具有焦点的对象。 | UIComponent | |
| 返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。 | DisplayObjectContainer | |
| 返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。 | DisplayObject | |
| 返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目；如果此 Repeater 未重复，则返回 null。 | UIComponent | |
| 获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | |
| 将 Point 对象由全局坐标转换为内容坐标。 | UIComponent | |
| 将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。 | DisplayObject | |
| 将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。 | DisplayObject | |
| 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
指示对象是否已经定义了指定的属性。 | Object | |
| 计算显示对象，以确定它是否与 obj 显示对象重叠或相交。 | DisplayObject | |
| 计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | |
| 返回一个框 Matrix，在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | |
| 初始化此组件的内部结构。 | UIComponent | |
| 初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | |
| 标记组件，以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | |
| 标记组件，以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | |
| 标记组件，以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | |
|
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
| 将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。 | DisplayObject | |
| 将 Point 对象由本地坐标转换为内容坐标。 | UIComponent | |
| 将屏幕上的坐标转换成数据值元组。 | ChartElement | |
| 将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。 | DisplayObject | |
| 在一个或多个关联轴的映射发生更改时调用此方法。 | ChartElement | |
| 测量指定的 HTML 文本（该文本中可能包含 <font> 和 <b> 等 HTML 标记），假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。 | UIComponent | |
| 测量指定的文本，假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。 | UIComponent | |
| 将组件移动到其父项内的指定位置。 | UIComponent | |
| 将样式更改传播到子项。 | UIComponent | |
| 如果 owner 属性链从 child 指向此 UIComponent，则返回 true。 | UIComponent | |
| 当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | |
| 准备 IFlexDisplayObject 用于打印。 | UIComponent | |
|
指示指定的属性是否存在、是否可枚举。 | Object | |
| 为此组件构建或重新构建 CSS 样式缓存；如果 recursive 参数为 true，还会为此组件的所有后代执行同样的操作。 | UIComponent | |
| 针对每个效果事件，将 EffectManager 注册为一个事件侦听器。 | UIComponent | |
| 从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | |
| 从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | |
| 从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
| 重放指定的事件。 | UIComponent | |
| 使用提供的 ID 解析子项。 | UIComponent | |
| [静态] 在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | |
| 调整对象大小。 | UIComponent | |
| 更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | |
| 设置一个布局约束值的方式，与设置此组件的约束样式的方式相同。 | UIComponent | |
| 设置当前状态。 | UIComponent | |
| 设置此组件的焦点。 | UIComponent | |
|
设置循环操作动态属性的可用性。 | Object | |
| 对此组件实例设置样式属性。 | UIComponent | |
| 当 visible 属性发生更改时调用。 | UIComponent | |
| 允许用户拖动指定的 Sprite。 | Sprite | |
| 结束 startDrag() 方法。 | Sprite | |
| 检测对样式属性的更改。 | UIComponent | |
| 首次初始化组件样式时，Flex 会调用 stylesInitialized() 方法。 | UIComponent | |
| [静态] 阻止对使用 callLater() 排队的方法进行背景处理，直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | |
| 交换两个指定子对象的 Z 轴顺序（从前到后顺序）。 | DisplayObjectContainer | |
| 在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。 | DisplayObjectContainer | |
| 返回一个字符串，用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | |
| 验证子项的位置和大小，并绘制其它可视内容。 | UIComponent | |
| 验证并更新此对象的属性和布局，如果需要的话重绘对象。 | UIComponent | |
| 由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | |
| 如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法，随后在测量时调用了 validateSize() 方法，则验证组件的度量大小。 | UIComponent | |
| 处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | |
|
返回指定对象的原始值。 | Object | |
| 返回一个框 Matrix，在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | |
| 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | EventDispatcher | |
| 样式 | 说明 | 定义方 | ||
|---|---|---|---|---|
| 类型: String CSS 继承: no 从内容区域的上边缘到控件的基线位置的垂直距离（以像素为单位）。如果设置此样式，则组件的基线锚定在其内容区域的上边缘；调整组件容器大小后，这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
| 类型: String CSS 继承: no 从组件的下边缘到其内容区域的下边缘的垂直距离（以像素为单位）。如果设置此样式，则组件的下边缘锚定在其内容区域的下边缘；调整组件容器大小后，这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
direction | 类型: String CSS 继承: no 指定网格线的方向。允许值为 horizontal、vertical 或 both。默认值为 horizontal。
| GridLines | ||
| 类型: uint 格式: Color CSS 继承: yes 验证失败时，组件加亮部分的颜色。验证失败时，Flex 还会将组件的 borderColor 样式设置为 errorColor。. | UIComponent | ||
| 类型: String CSS 继承: no 焦点矩形使用的混合模式。有关详细信息，请参阅 flash. | UIComponent | ||
| 类型: Class CSS 继承: no 用于绘制焦点矩形的外观。. | UIComponent | ||
| 类型: Number 格式: Length CSS 继承: no 焦点矩形轮廓的粗细，以像素为单位。. | UIComponent | ||
horizontalAlternateFill | 类型: mx.graphics.IFill CSS 继承: no 指定水平交替带的填充模式， fill 属性并未进行定义。使用 IFill 类可将填充属性定义为 MXML 中的子标签，或在 ActionScript 中创建 IFill 对象。设置为 null 不会填充交替带。默认值为 null。
| GridLines | ||
| 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的水平距离（以像素为单位）。如果设置此样式，则组件的中心锚定在其内容区域的中心；调整组件容器大小后，这两个中心将保持它们的水平间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
horizontalChangeCount | 类型: int CSS 继承: no 指定水平网格线之间的刻度线数量。将 horizontalChangeCount 属性设置为 3 沿轴每隔两个刻度线绘制一个网格线。填充样式每隔一个网格线应用一次，因此如果增大 horizontalChangeCount，将显著增大交替带。默认值为 1。
| GridLines | ||
horizontalFill | 类型: mx.graphics.IFill CSS 继承: no 在由网格线创建的水平带中，指定每隔一个水平带应用一次的填充模式。使用 IFill 类可将填充的属性定义为 MXML 中的子标签，或在 ActionScript 中创建 IFill 对象。设置为 null 不会填充交替带。默认值为 null。
| GridLines | ||
horizontalOriginStroke | 类型: mx.graphics.IStroke CSS 继承: no 指定水平原点的线条样式。使用 Stroke 类可将此属性定义为 MXML 中的子标签，或在 ActionScript 中创建 Stroke 对象。 | GridLines | ||
horizontalShowOrigin | 类型: Boolean CSS 继承: no 确定是否绘制水平原点。如果为 true，并且原点落在图表边界上，则网格线将使用 horizontalOriginStroke 样式绘制此原点。对于 ColumnChart、LineChart、PlotChart、BubbleChart 和 AreaChart 控件，默认值为 true。对于 BarChart 控件，默认值为 false。此属性不适用于 PieChart 控件。
| GridLines | ||
horizontalStroke | 类型: mx.graphics.IStroke CSS 继承: no 指定水平网格线的线条样式。使用 Stroke 类可将此属性定义为 MXML 中的子标签，或在 ActionScript 中创建 Stroke 对象。 | GridLines | ||
horizontalTickAligned | 类型: Boolean CSS 继承: no 确定是否将水平网格线与刻度线对齐。如果为 true，则将水平网格线绘制为与刻度线对齐。如果为 false，则 Flex 将在刻度线之间绘制垂直网格线。默认值为 true。
| GridLines | ||
| 类型: String CSS 继承: no 从组件内容区域的左边缘到组件左边缘的水平距离（以像素为单位）。如果设置此样式，则组件的左边缘锚定在其内容区域的左边缘；调整组件容器大小后，这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
| 类型: String CSS 继承: no 从组件的右边缘到其内容区域的右边缘的水平距离（以像素为单位）。如果设置此样式，则组件的右边缘锚定在其内容区域的右边缘；调整组件容器大小后，这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
| 类型: uint 格式: Color CSS 继承: yes 组件的主题颜色。此属性控制加亮内容的外观、选中组件时的外观和其它相似的形象化提示，但是它对此组件的常规边框和背景颜色不起作用。虽然可以使用任意有效的颜色值，但首选值为 haloGreen、haloBlue、haloOrange 和 haloSilver。 | UIComponent | ||
| 类型: String CSS 继承: no 从控件内容区域的上边缘到组件上边缘的垂直距离（以像素为单位）。如果设置此样式，则组件的上边缘锚定在其内容区域的上边缘；调整其容器大小后，这两个边缘将保持其间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
verticalAlternateFill | 类型: mx.graphics.IFill CSS 继承: no 指定垂直交替带的填充模式不由填充属性定义。使用 IFill 类可将填充属性定义为 MXML 中的子标签，或在 ActionScript 中创建 IFill 对象。设置为 null 不会填充交替带。默认值为 null。
| GridLines | ||
| 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的垂直距离（以像素为单位）。如果设置此样式，则组件的中心锚定在其内容区域的中心；调整其容器大小后，这两个中心将保持其垂直间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
verticalChangeCount | 类型: int CSS 继承: no 指定垂直网格线之间的刻度线数目。将 verticalChangeCount 设置为 3 沿轴每隔两个刻度线绘制一条网格线。填充样式将在每条网格线处交替，因此如果增大 verticalChangeCount，交替带将显著增大。默认值为 1。
| GridLines | ||
verticalFill | 类型: mx.graphics.IFill CSS 继承: no 指定由网格线创建的垂直交替带的填充模式。使用 IFill 类可将填充的属性定义为 MXML 中的子标签，或在 ActionScript 中创建 IFill 对象。设置为 null 不会填充交替带。默认值为 null。
| GridLines | ||
verticalOriginStroke | 类型: mx.graphics.IStroke CSS 继承: no 指定垂直原点的线条样式。使用 Stroke 类可将此属性定义为 MXML 中的子标签，或在 ActionScript 中创建 Stroke 对象。 | GridLines | ||
verticalShowOrigin | 类型: Boolean CSS 继承: no 确定是否绘制垂直原点。如果设置为 true，并且原点落在图表边界上，则 Flex 将使用 verticalOriginStroke 样式绘制此原点。对于 ColumnChart、LineChart 和 AreaChart 控件，默认值为 false。对于 PlotChart、BubbleChart 和 BarChart 控件，默认值为 true。此属性不适用于 PieChart 控件。
| GridLines | ||
verticalStroke | 类型: mx.graphics.IStroke CSS 继承: no 指定垂直网格线的线条样式。使用 Stroke 类可将此属性定义为 MXML 中的子标签，或在 ActionScript 中创建 Stroke 对象。 | GridLines | ||
verticalTickAligned | 类型: Boolean CSS 继承: no 确定是否将垂直网格线与刻度线对齐。如果设置为 true，则 Flex 将绘制与刻度线对齐的垂直网格线。如果为 false，则 Flex 将在刻度线之间绘制垂直网格线。默认值为 true。
| GridLines | ||
| GridLines | () | 构造函数 |
public function GridLines()构造函数。
<?xml version="1.0"?>
<!-- Simple example to demonstrate the GridLines class. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
<mx:Script>
<![CDATA[
import mx.collections.ArrayCollection;
[Bindable]
private var expensesAC:ArrayCollection = new ArrayCollection( [
{ Month: "Jan", Profit: 2000, Expenses: 1500, Amount: 450 },
{ Month: "Feb", Profit: 1000, Expenses: 200, Amount: 600 },
{ Month: "Mar", Profit: 1500, Expenses: 500, Amount: 300 },
{ Month: "Apr", Profit: 1800, Expenses: 1200, Amount: 900 },
{ Month: "May", Profit: 2400, Expenses: 575, Amount: 500 } ]);
]]>
</mx:Script>
<mx:Panel title="GridLines Example" height="100%" width="100%">
<mx:LineChart id="linechart" height="100%" width="100%"
paddingLeft="5" paddingRight="5"
showDataTips="true" dataProvider="{expensesAC}">
<mx:horizontalAxis>
<mx:CategoryAxis categoryField="Month"/>
</mx:horizontalAxis>
<mx:backgroundElements>
<mx:GridLines direction="horizontal">
<mx:horizontalStroke>
<mx:Stroke weight="1"/>
</mx:horizontalStroke>
<mx:horizontalFill>
<mx:SolidColor color="0xCCCCCC" alpha=".66"/>
</mx:horizontalFill>
</mx:GridLines>
</mx:backgroundElements>
<mx:series>
<mx:LineSeries yField="Profit" form="curve" displayName="Profit"/>
<mx:LineSeries yField="Expenses" form="curve" displayName="Expenses"/>
<mx:LineSeries yField="Amount" form="curve" displayName="Amount"/>
</mx:series>
</mx:LineChart>
<mx:Legend dataProvider="{linechart}"/>
</mx:Panel>
</mx:Application>