| //////////////////////////////////////////////////////////////////////////////// |
| // |
| // Licensed to the Apache Software Foundation (ASF) under one or more |
| // contributor license agreements. See the NOTICE file distributed with |
| // this work for additional information regarding copyright ownership. |
| // The ASF licenses this file to You under the Apache License, Version 2.0 |
| // (the "License"); you may not use this file except in compliance with |
| // the License. You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, software |
| // distributed under the License is distributed on an "AS IS" BASIS, |
| // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| // See the License for the specific language governing permissions and |
| // limitations under the License. |
| // |
| //////////////////////////////////////////////////////////////////////////////// |
| |
| package mx.charts |
| { |
| import flash.utils.Dictionary; |
| |
| import mx.charts.chartClasses.CartesianChart; |
| import mx.charts.chartClasses.DataTip; |
| import mx.charts.chartClasses.DataTransform; |
| import mx.charts.chartClasses.Series; |
| import mx.charts.series.CandlestickSeries; |
| import mx.charts.styles.HaloDefaults; |
| import mx.core.IFlexModuleFactory; |
| import mx.core.mx_internal; |
| import mx.graphics.IFill; |
| import mx.graphics.SolidColor; |
| import mx.graphics.SolidColorStroke; |
| import mx.graphics.Stroke; |
| import mx.styles.CSSStyleDeclaration; |
| |
| use namespace mx_internal; |
| |
| //-------------------------------------- |
| // Styles |
| //-------------------------------------- |
| |
| /** |
| * Specifies a ratio of how wide to draw the candlesticks |
| * relative to the horizontal axis's category widths, |
| * as a percentage in the range of 0 to 1. |
| * A value of 1 uses the entire space, |
| * while a value of 0.6 uses 60% of the column's available space. |
| * The actual candlestick width used is the smaller of the |
| * <code>columnWidthRatio</code> property and the |
| * <code>maxColumnWidth</code> property. |
| * Multiple candlestick series divide this space proportionally. |
| * The default value is 0.65. |
| * |
| * @langversion 3.0 |
| * @playerversion Flash 9 |
| * @playerversion AIR 1.1 |
| * @productversion Flex 3 |
| */ |
| [Style(name="columnWidthRatio", type="Number", inherit="no")] |
| |
| /** |
| * Specifies how wide to draw the candlesticks, in pixels. |
| * The actual column width used is the smaller of this property |
| * and the <code>columnWidthRatio</code> property. |
| * Multiple candlestick series divide this space proportionally. |
| * |
| * @langversion 3.0 |
| * @playerversion Flash 9 |
| * @playerversion AIR 1.1 |
| * @productversion Flex 3 |
| */ |
| [Style(name="maxColumnWidth", type="Number", format="Length", inherit="no")] |
| |
| //-------------------------------------- |
| // Other metadata |
| //-------------------------------------- |
| |
| [DefaultBindingProperty(destination="dataProvider")] |
| |
| [DefaultTriggerEvent("itemClick")] |
| |
| [IconFile("CandlestickChart.png")] |
| |
| /** |
| * The CandlestickChart control represents financial data |
| * as a series of candlesticks representing the high, low, |
| * opening, and closing values of a data series. |
| * The top and bottom of the vertical line in each candlestick |
| * represent the high and low values for the datapoint, |
| * while the top and bottom of the filled box |
| * represents the opening and closing values. |
| * Each candlestick is filled differently depending on |
| * whether the closing value for the datapoint |
| * is higher or lower than the opening value. |
| * |
| * <p>A CandlestickChart control expects its <code>series</code> property |
| * to contain an array of CandlestickSeries objects.</p> |
| * |
| * @mxml |
| * |
| * The <code><mx:CandlestickChart></code> tag inherits all the properties |
| * of its parent classes and adds the following properties:</p> |
| * |
| * <pre> |
| * <mx:CandlestickChart |
| * <strong>Styles</strong> |
| * columnWidthRatio=".65" |
| * maxColumnWidth="<i>No default</i>" |
| * /> |
| * </pre> |
| * |
| * @see mx.charts.series.CandlestickSeries |
| * |
| * @includeExample examples/CandlestickChartExample.mxml |
| * |
| * @langversion 3.0 |
| * @playerversion Flash 9 |
| * @playerversion AIR 1.1 |
| * @productversion Flex 3 |
| */ |
| public class CandlestickChart extends CartesianChart |
| { |
| include "../core/Version.as"; |
| |
| //-------------------------------------------------------------------------- |
| // |
| // Class initialization |
| // |
| //-------------------------------------------------------------------------- |
| |
| //-------------------------------------------------------------------------- |
| // |
| // Class constants |
| // |
| //-------------------------------------------------------------------------- |
| |
| /** |
| * @private |
| */ |
| private static var INVALIDATING_STYLES:Object = |
| { |
| columnWidthRatio: 1, |
| maxColumnWidth: 1 |
| } |
| |
| //-------------------------------------------------------------------------- |
| // |
| // Constructor |
| // |
| //-------------------------------------------------------------------------- |
| |
| /** |
| * Constructor. |
| * |
| * @langversion 3.0 |
| * @playerversion Flash 9 |
| * @playerversion AIR 1.1 |
| * @productversion Flex 3 |
| */ |
| public function CandlestickChart() |
| { |
| super(); |
| |
| dataTipMode = "single"; |
| } |
| |
| //-------------------------------------------------------------------------- |
| // |
| // Variables |
| // |
| //-------------------------------------------------------------------------- |
| |
| /** |
| * @private |
| */ |
| private static var _moduleFactoryInitialized:Dictionary = new Dictionary(true); |
| |
| /** |
| * @private |
| */ |
| private var _perSeriescolumnWidthRatio:Number; |
| |
| /** |
| * @private |
| */ |
| private var _perSeriesMaxColumnWidth:Number; |
| |
| /** |
| * @private |
| */ |
| private var _leftOffset:Number; |
| |
| //-------------------------------------------------------------------------- |
| // |
| // Overridden methods: UIComponent |
| // |
| //-------------------------------------------------------------------------- |
| |
| /** |
| * @private |
| */ |
| private function initStyles():Boolean |
| { |
| HaloDefaults.init(styleManager); |
| |
| var candlestickChartSeriesStyles:Array /* of Object */ = []; |
| var csChartStyle:CSSStyleDeclaration = HaloDefaults.findStyleDeclaration(styleManager, "mx.charts.CandlestickChart"); |
| if (csChartStyle) |
| { |
| csChartStyle.setStyle("chartSeriesStyles", candlestickChartSeriesStyles); |
| csChartStyle.setStyle("fill", new SolidColor(0xFFFFFF, 0)); |
| csChartStyle.setStyle("calloutStroke", new SolidColorStroke(0x888888,2)); |
| csChartStyle.setStyle("horizontalAxisStyleNames", ["blockCategoryAxis"]); |
| csChartStyle.setStyle("verticalAxisStyleNames", ["blockNumericAxis"]); |
| |
| var n:int = HaloDefaults.defaultColors.length; |
| for (var i:int = 0; i < n; i++) |
| { |
| var styleName:String = "haloCandlestickSeries" + i; |
| candlestickChartSeriesStyles[i] = styleName; |
| |
| var o:CSSStyleDeclaration = |
| HaloDefaults.createSelector("." + styleName, styleManager); |
| |
| var f:Function = function(o:CSSStyleDeclaration, boxStroke:Stroke, |
| declineFill:IFill):void |
| { |
| o.defaultFactory = function():void |
| { |
| this.boxStroke = boxStroke; |
| this.declineFill = declineFill; |
| } |
| } |
| |
| f(o, new Stroke(HaloDefaults.defaultColors[i], 0, 1), |
| new SolidColor(HaloDefaults.defaultColors[i])); |
| } |
| } |
| |
| return true; |
| } |
| |
| /** |
| * A module factory is used as context for using embedded fonts and for finding the style manager that controls the styles for this component. |
| * |
| * @langversion 3.0 |
| * @playerversion Flash 9 |
| * @playerversion AIR 1.1 |
| * @productversion Flex 3 |
| */ |
| override public function set moduleFactory(factory:IFlexModuleFactory):void |
| { |
| super.moduleFactory = factory; |
| |
| if (_moduleFactoryInitialized[factory]) |
| return; |
| |
| _moduleFactoryInitialized[factory] = true; |
| |
| // our style settings |
| initStyles(); |
| } |
| |
| /** |
| * @private |
| */ |
| override public function styleChanged(styleProp:String):void |
| { |
| if (styleProp == null || INVALIDATING_STYLES[styleProp] != undefined) |
| invalidateSeries(); |
| |
| super.styleChanged(styleProp); |
| } |
| |
| //-------------------------------------------------------------------------- |
| // |
| // Overridden methods: ChartBase |
| // |
| //-------------------------------------------------------------------------- |
| |
| /** |
| * @private |
| */ |
| override protected function customizeSeries(seriesGlyph:Series, i:uint):void |
| { |
| var series:CandlestickSeries = seriesGlyph as CandlestickSeries; |
| if (series) |
| { |
| if (!isNaN(_perSeriescolumnWidthRatio)) |
| series.columnWidthRatio = _perSeriescolumnWidthRatio; |
| |
| if (!isNaN(_perSeriesMaxColumnWidth)) |
| series.maxColumnWidth = _perSeriesMaxColumnWidth; |
| |
| series.offset = _leftOffset + i * _perSeriescolumnWidthRatio; |
| } |
| } |
| |
| /** |
| * @private |
| */ |
| override protected function applySeriesSet(seriesSet:Array /* of Series */, |
| transform:DataTransform):Array /* of Series */ |
| { |
| |
| var columnWidthRatio:Number = getStyle("columnWidthRatio"); |
| var maxColumnWidth:Number = getStyle("maxColumnWidth"); |
| |
| _perSeriescolumnWidthRatio = columnWidthRatio / seriesSet.length; |
| _perSeriesMaxColumnWidth = maxColumnWidth / seriesSet.length; |
| |
| _leftOffset = (1 - columnWidthRatio) / 2 + |
| _perSeriescolumnWidthRatio / 2 - 0.5; |
| |
| return super.applySeriesSet(seriesSet, transform); |
| } |
| } |
| |
| } |
