| パッケージ | mx.charts.effects |
| クラス | public class SeriesZoom |
| 継承 | SeriesZoom  SeriesEffect TweenEffect Effect EventDispatcher Object |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
showDataEffect または hideDataEffect のどちらのエフェクトトリガーに割り当てられているかによって決定します。
MXML シンタックス
MXML シンタックスを表示
MXML シンタックスを隠すThe <mx:SeriesZoom> tag
inherits all the properties of its parent classes,
and adds the following properties:
<mx:SeriesZoom
Properties
horizontalFocus="center|left|right|null"
relativeTo="series|chart"
verticalFocus="top|center|bottom|null"
/>
さらに例を参照
パブリックプロパティ
| プロパティ | 定義元 | ||
|---|---|---|---|
 | className : String [読み取り専用]
このエフェクトクラスの名前です。たとえば、"Fade" などがあります。 | Effect | |
| constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | |
| customFilter : mx.effects:EffectTargetFilter
エフェクトを再生するターゲットを特定するために、エフェクトによって使用されるタイプ EffectTargetFilter のカスタムフィルターオブジェクトを指定します。 | Effect | |
| duration : Number
エフェクトの継続時間を表します（ミリ秒単位）。 | Effect | |
| easingFunction : Function = null
アニメーションのイージング関数を表します。 | TweenEffect | |
| effectTargetHost : mx.effects:IEffectTargetHost
データエフェクトのターゲットリストコントロールにアクセスできるプロパティです。 | Effect | |
| elementOffset : Number = 20
系列内の各エレメントのエフェクトを遅延させる時間をミリ秒単位で指定します。 | SeriesEffect | |
| filter : String
エフェクトのターゲットをフィルタリングするアルゴリズムを指定します。 | Effect | |
| hideFocusRing : Boolean
エフェクトの開始時にエフェクトがフォーカス枠を非表示にするかどうかを指定します。 | Effect | |
| horizontalFocus : String
ズームの焦点の位置を定義します。 | SeriesZoom | ||
| instanceClass : Class
このエフェクトクラスのエフェクトインスタンスクラスを指定する Class 型のオブジェクトを表します。 | Effect | |
| isPlaying : Boolean [読み取り専用]
エフェクトのインスタンスのいずれかが現在再生中の場合に true、そうでない場合に false となる読み取り専用フラグです。 | Effect | |
| minimumElementDuration : Number = 0
個々のエレメントがエフェクトを完了するのに必要な時間をミリ秒単位で指定します。 | SeriesEffect | |
| offset : Number = 0
エフェクトの遅延時間をミリ秒単位で指定します。 | SeriesEffect | |
| perElementOffset : Number
エフェクトの最初のターゲットの後に発生する、エフェクトターゲットの追加遅延（ミリ秒）です。 | Effect | |
| playheadTime : Number
エフェクトの現在の時間位置です。 | Effect | |
| relativeTo : String = "series"
ズームの焦点を計算する基準の境界ボックスを指定します。 | SeriesZoom | ||
| relevantProperties : Array
フィルタリング実行時に使用するプロパティ名の配列を表します。 | Effect | |
| relevantStyles : Array
フィルタリング実行時に使用するスタイル名の配列を表します。 | Effect | |
| repeatCount : int = 1
エフェクトを繰り返す回数を表します。 | Effect | |
| repeatDelay : int = 0
エフェクトを繰り返す前の待機時間を表します（ミリ秒単位）。 | Effect | |
| startDelay : int = 0
エフェクトを開始する前の待機時間を表します（ミリ秒単位）。 | Effect | |
| suspendBackgroundProcessing : Boolean = false
true の場合、エフェクトの再生中にすべてのバックグラウンド処理をブロックします。 | Effect | |
| target : Object
このエフェクトが適用されるオブジェクトを表します。 | Effect | |
| targets : Array
エフェクトのターゲットであるオブジェクトの配列を表します。 | Effect | |
| triggerEvent : Event
エフェクトがトリガーされたときに EffectManager によってこの Effect に渡される Event オブジェクトです。EffectManager によってエフェクトが再生されていない場合は null です。 | Effect | |
| type : String = "show"
このエフェクトが使用されているトランジションのタイプを表します。 | SeriesEffect | |
| verticalFocus : String
ズームの焦点の位置を定義します。 | SeriesZoom | ||
プロテクトプロパティ
パブリックメソッド
| メソッド | 定義元 | ||
|---|---|---|---|
SeriesZoom(target:Object = null)
コンストラクターです。 | SeriesZoom | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | |
|
エフェクトのターゲットにおいて関連するプロパティの現在値をキャプチャし、終了値として保存します。 | Effect | |
|
ターゲットの追加セットの関連するプロパティの現在値をキャプチャします。この機能は、データ変更エフェクトを実行したときに Flex によって使用されます。
| Effect | |
|
エフェクトのターゲットにおいて関連するプロパティの現在値をキャプチャします。 | Effect | |
|
1 つのエフェクトインスタンスを作成し、それを初期化します。 | Effect | |
|
ターゲットオブジェクトの配列を取得し、各ターゲットで createInstance() メソッドを呼び出します。 | Effect | |
|
インスタンスからイベントリスナーを削除し、インスタンスのリストからインスタンスを削除します。 | Effect | |
|
イベントをイベントフローに送出します。 | EventDispatcher | |
|
現在再生中のエフェクトをすべて中断し、直ちにエフェクトの終わりにジャンプします。 | Effect | |
|
ストリングの配列を返します。各ストリングは、このエフェクトによって変更されるプロパティの名前です。 | Effect | |
|
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
resume() メソッドを呼び出すまで、エフェクトを一時停止します。 | Effect | |
|
エフェクトの再生を開始します。 | Effect | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
|
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
|
pause() メソッドを呼び出し、エフェクトを一時停止した後、再開させます。 | Effect | |
|
エフェクトが現在再生中の場合に、エフェクトの現在位置から開始して、逆順でエフェクトを再生します。 | Effect | |
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
|
エフェクトターゲットを現在の状態にしたまま、エフェクトを停止します。 | Effect | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
|
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
プロテクトメソッド
プロパティの詳細
horizontalFocus | プロパティ |
public var horizontalFocus:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ズームの焦点の位置を定義します。
horizontalFocus プロパティの有効な値は、"left"、"center"、"right"、および null です。
horizontalFocus プロパティと verticalFocus プロパティを組み合わせて、データ系列がズームインまたはズームアウトする場所を定義します。 例えば、horizontalFocus プロパティを "left" に設定し、verticalFocus プロパティを "top" に設定すると、エレメントまたはチャート（relativeTo プロパティの設定による）の左上を焦点として、データ系列がズームインまたはズームアウトします。
これらのプロパティの一方のみを指定した場合は、ズームインまたはズームアウトする先が点ではなく水平線または垂直線になります。 例えば、horizontalFocus を "left" に設定し、verticalFocus を null に設定すると、エレメントは境界線の左の垂直線にズームインまたはズームアウトします。 チャートエレメントをチャート境界ボックスの中央の水平線にズームインまたはズームアウトするには、verticalFocus プロパティを "center" に設定します。
デフォルト値： "center"。
relativeTo | プロパティ |
public var relativeTo:String = "series"| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ズームの焦点を計算する基準の境界ボックスを指定します。
relativeTo プロパティの有効な値は、"series" および "chart" です。
"series" に設定すると、各エレメントはそれ自体の位置を基準にズームします。 例えば、ColumnChart のそれぞれの縦棒は、縦棒の左上や縦棒の中央などにズームします。
"chart" に設定すると、各エレメントはチャートの領域を基準にズームします。 例えば、それぞれの縦棒は軸の左上や軸の中央などにズームします。
デフォルト値： "series"。
verticalFocus | プロパティ |
public var verticalFocus:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ズームの焦点の位置を定義します。 詳細については、horizontalFocus プロパティの説明を参照してください。
verticalFocus の有効な値は、"top"、"center"、"bottom"、および null です。
デフォルト値： "center"。
コンストラクターの詳細
SeriesZoom | () | コンストラクター |
例 この例の使用方法
SeriesZoomExample.mxml
<?xml version="1.0"?>
<!-- Simple example to demonstrate the CandlestickChart control. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<fx:Script>
<![CDATA[
import mx.collections.ArrayCollection;
[Bindable]
private var companyAAC:ArrayCollection = new ArrayCollection( [
{ Date: "25-Jul", Open: 40.75, High: 40.75, Low: 40.24, Close:40.31},
{ Date: "26-Jul", Open: 39.98, High: 40.78, Low: 39.97, Close:40.34},
{ Date: "27-Jul", Open: 40.38, High: 40.66, Low: 40, Close:40.63},
{ Date: "28-Jul", Open: 40.49, High: 40.99, Low: 40.3, Close:40.98},
{ Date: "29-Jul", Open: 40.13, High: 40.4, Low: 39.65, Close:39.95},
{ Date: "1-Aug", Open: 39.00, High: 39.50, Low: 38.7, Close:38.6},
{ Date: "2-Aug", Open: 38.68, High: 39.34, Low: 37.75, Close:38.84},
{ Date: "3-Aug", Open: 38.76, High: 38.76, Low: 38.03, Close:38.12},
{ Date: "4-Aug", Open: 37.98, High: 37.98, Low: 36.56, Close:36.69},
{ Date: "5-Aug", Open: 36.61, High: 37, Low: 36.48, Close:36.86} ]);
[Bindable]
private var companyBAC:ArrayCollection = new ArrayCollection( [
{ Date: "25-Jul", Open: 18.50, High: 19, Low: 18.48, Close:18.86},
{ Date: "26-Jul", Open: 19.56, High: 19.98, Low: 18.6, Close:18.69},
{ Date: "27-Jul", Open: 20.81, High: 20.99, Low: 20.03, Close:20.12},
{ Date: "28-Jul", Open: 20.70, High: 21.00, Low: 19.5, Close:20.84},
{ Date: "29-Jul", Open: 21.7, High: 21.79, Low: 20.45, Close:20.6},
{ Date: "1-Aug", Open: 22.45, High: 22.65, Low: 21.65, Close:21.95},
{ Date: "2-Aug", Open: 22.56, High: 22.6, Low: 22.05, Close:22.98},
{ Date: "3-Aug", Open: 22.42, High: 22.70, Low: 22.1, Close:22.63},
{ Date: "4-Aug", Open: 21.67, High: 22.82, Low: 21.67, Close:22.34},
{ Date: "5-Aug", Open: 22.44, High: 22.85, Low: 22.12, Close:22.31} ]);
]]>
</fx:Script>
<fx:Declarations>
<mx:SeriesZoom id="zoomIn" duration="1000"/>
<mx:SeriesZoom id="zoomOut" duration="1000"/>
</fx:Declarations>
<mx:Panel title="CandlestickChart Control Example" height="100%" width="100%"
paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">
<mx:CandlestickChart id="candlestickchart" height="100%" width="100%"
paddingRight="5" paddingLeft="5"
showDataTips="true" dataProvider="{companyAAC}">
<mx:verticalAxis>
<mx:LinearAxis id="vaxis" baseAtZero="false" title="Price"/>
</mx:verticalAxis>
<mx:horizontalAxis>
<mx:CategoryAxis id="haxis" categoryField="Date" title="Date"/>
</mx:horizontalAxis>
<mx:horizontalAxisRenderers>
<mx:AxisRenderer axis="{haxis}" canDropLabels="true"/>
</mx:horizontalAxisRenderers>
<mx:series>
<mx:CandlestickSeries
openField="Open" highField="High"
lowField="Low" closeField="Close"
showDataEffect="{zoomIn}"
hideDataEffect="{zoomOut}"/>
</mx:series>
</mx:CandlestickChart>
<mx:Label width="100%" color="blue"
text="Choose a company to view recent stock data."/>
<mx:HBox>
<mx:RadioButton groupName="stocks" label="View Company A"
selected="true" click="candlestickchart.dataProvider=companyAAC;"/>
<mx:RadioButton groupName="stocks" label="View Company B"
click="candlestickchart.dataProvider=companyBAC;"/>
</mx:HBox>
</mx:Panel>
</s:Application>
Tue Jun 12 2018, 10:34 AM Z