■チャートエディタ

チャートエディタの目的の一つは、いかにプログラマがコードを書かずにチャートを作成する機能を提供するかにあります。
プログラマはデザイン時にチャートエディタを使いチャートやそのデータに関する様々な定義をビジュアルに設定できます。

たとえば、SQL Server データベース上の販売データテーブルを対象にその販売量と販売年月をグラデーション付きの 3D の縦棒グラフを作成することができます。

また、もう一つの目的として、プログラマがいかにコードを書かずにエンドユーザにチャートを加工する様々な機能を提供するか、ということがあげられます。
プログラマはユーザへのチャートエディタの開放を指定するだけで、ユーザはチャートエディタを使って、チャートに対して様々な追加や変更を加えたり、データ活用することができます｡

たとえば、既存系列間の累積を新しい系列として追加したり、軸の目盛やタイトルの変更、パネルグラデーションの設定などの視覚的な項目設定が可能です。また、ユーザが現在のチャートデータをExcel形式やXMLデータとしてエクスポートする、といったこともチャートエディタだけの機能で実現できます。

【チャートエディタ画面の系列タブ】

【TeeChart ギャラリ】

【面系列の［系列］-〔形式〕タブ】

【チャートツール】　（Windows Forms 用）

【チャートツール】　（Web Forms 用）

【エクスポート】

新たに、XAML(WPF) と Flex(Flash) をサポートしました。

■TeeChart Pro .NET 2010Jの関数

TeeChart Pro .NET 2010J には、41種類の関数があります。

ここでは、関数のいくつかを紹介します。

【ヒストグラム関数】 ヒストグラム関数は、一つの系列の X あるいは Y 値からヒストグラムを作成します。

【S.A.R （Stop And Reversal）関数】 SAR はロングポジション（買い）とショートポジション（売り）に対して退去ポイントを作成するよう設計されています。ポジションの最初の段階で反動または変動を考慮しますが、変動が頂点に達すると（ロングポジションの場合は）上向きに、（ショートポジションの場合は）下向きに加速します。

【モード関数】 モード関数は、ソース系列データの中で重複数の多い値を計算します。 Null ソース値を無視するためのオプションがあります。

【メディアン関数】 メディアン関数は、ソートされたソース値で中央に配置された値を計算します。 中央に配置された値が2つある場合、この関数はその2つの値の平均値になります。Null ソース値は、計算に含めたり含めないこともできます。

【相関関数】 同じトレンドに従ってソースの X 値と Y 値をどのように示すか -1 から 1 への係数値を計算します。

【分散関数】 分散関数は、分布の広がり具合を返します。 標準偏差関数は分散の平方根を表します。

【境界関数】 境界関数は、ソース系列のリミット（境界）を構成するソースポイントのサブセットを計算します。

【ダウンサンプリング関数】 ダウンサンプリング関数は、下記の方法で系列のポイント数を減らします。 + Max : ポイントのグループをグループの最大値に置換します。 + Min : ポイントのグループをグループの最小値に置換します。 + MinMax : ポイントのグループを2つのポイント（グループの最小値とグループの最大値）に置換します。 + MinMaxFirstLast : ポイントのグループを2つのポイント（グループの最小値と最大）に置換します。1つのグループの最後の値から次のグループの最初の値まで描画します。 + Average : ポイントのグループをグループの平均値に置換します。

【指数トレンド関数】 指数トレンド関数は、指数(e)の重み付けを使用すること以外はトレンド関数と同様です。

【MACD 関数】 MACD（Moving Average Convergence Divergence）関数は、金融チャートで使用されます。

【ボリンジャー関数】 ボリンジャーバンドは、金融インジケーターとして使用される特別な関数です。 これは、移動平均値（指数の有無）あるいは標準偏差を使用して2つの線を計算し描画します。

【R.S.I 関数】 R.S.I（Relative Strength Index）関数には、2種類の計算方法があります。 デフォルトは、データソースのキャンドル系列の始値と終値を使用して計算します。もう1つの方法は、終値のみ使用します。

【ADX 関数】 A.D.X ( Average Directional Change )は、金融のチャートアプリケーションで一般に使用されるインジケータ関数です。 ADX関数は、データソースとしてOHLC（キャンドル）を使用して3つのライン（DMI+/ADX/DMI-）を描画します。

■チャートツール TeeChart は、チャートの表示方法や、実行時のチャート上の操作方法を強力に支援する多くのチャートツールを備えています。 　 系列 イメージ/カーソル/ガントドラッグ/サーフェス近傍/ドラッグポイント/ドラッグマーカ/ドローライン/マーカチップ/円スライス/拡張凡例/近傍点/系列アニメーション/フィボナッチ /系列領域/凡例パレット/系列統計/クリップ系列/系列バンド ホットスポット/拡張凡例 軸 カラーバンド/カラーライン/グリッドバンド/軸スクロール/軸矢印/軸細分ツール New! カラーバンド/グリッドバンド その他 2D 照明/ 3D グリッド置換/アノテーション/ズーム/ページ数/回転/凡例スクロールバー/サブチャート/フェーダ/矩形/セレクタ/系列置換/データテーブル/バナー/虫眼鏡 /ビデオクリエイターツール New! /ビデオプレイヤーツール New! アノテーション/ズーム/ページ数/矩形/バナー/虫眼鏡/スクロール/マーカ ここでは、ツールのいくつかを紹介します。

TeeChart を ADO.NET データベースに接続する方法は、デザイン時にチャートエディタで行う方法と実行時にコードの記述による方法があります。
どんな系列でもチャートエディタで ADO.NET のテーブルやクエリーに接続でき、また全ての系列はいろいろな ADO.NET データベースを使用してあらゆるテーブルに接続できます。これにより柔軟にデータベースをチャートで使用できます。

全ての系列には DataSource プロパティがあり、全ての系列は、データベースの値（テーブルあるいはクエリー）を定義する「DataSource」プロパティを持ち、「YValues.DataMember」プロパティや「LabelMember」プロパティは、表示させるフィールドを指定します。

またデザイン時に実際のデータを見ながら開発ができます。

▼テーブルデータ全体のバインディング

Visual Studio .NET のツールボックスのデータタブから必要な DataAdapter を Form にドラッグするか、Visual Studio .NET のサーバーエクスプローラから必要なデータベースのテーブルなどをドラッグします。自動的に作成される DataAdapter オブジェクトの構成を必要に応じて変更します。

たとえば、次のようなテーブルを DataAdapter で構成したとします。

TeeChart のチャートエディタの系列タブの中のデータソースタブを選択して、下図のようにデータセットを設定します。

すると、下図のようなチャートがとても簡単に完成します。

▼1レコード単位（単一レコード）のバインディング

TeeChart は、データベースの単一レコードを簡単にチャートにすることができます。
たとえば、1年1レコードで月毎の売上データから構成されているデータをチャートに表示する場合です。

たとえば、次のようなテーブルを DataAdapter で構成したとします。

【1】単一レコードのデータ接続に、TeeChart のチャートエディタを利用した場合

TeeChartのチャートエディタのバインドしたい系列タブのデータソースタブで、データソース型を「単一レコード」に設定します。
単一レコードのチャートはデータセット、テーブルやデータビューをサポートします。

すると、下図のように Visual Studio .NET のデザイナ画面の下方にある「コンポーネントトレイ」に TeeChart の「singleRecordSource」が表示されます。

この「singleRecordSource」は、DataAdapter を経由したデータソースとチャートデータを関連付けるコードを自動的に追加してくれます。
たとえば、上記の例では次のようなコードが自動的に付加されプログラマの負担が軽減されます。また、バインドしているデータに応じたチャートがデザイン時に確認できるというメリットもあります。

【2】単一レコードのデータ接続を、コーディングだけで行う場合

この場合は、デザイナ上に空のチャートコンポーネント（tChart）を配置し、DataAdapter でデータソースを指定した、下図のようなシンプルなデザイン画面となります。

▼CurrencyManager オブジェクトを利用したレコードナビゲーション

チャートのデータソースをナビゲートしたり、更新するには、Visual Studio .NETのWindows フォームの CurrencyManager オブジェクトを使用すると簡単です。

たとえば、上図のようにデータレコードの前進や後退ボタンにチャートの表示を連動させるには、CurrencyManager オブジェクトを利用した次のようなコーディングをする方法があります。

    private DataSet sourceTableSet;
    private DataTable sourceTable;

    private void Form1_Load(object sender, System.EventArgs e)
    {
        sourceTableSet = new System.Data.DataSet();
        oleDbDataAdapter1.Fill(sourceTableSet);
        sourceTable = sourceTableSet.Tables[0];
        ConnectChartToTable();
    }

    private CurrencyManager myCurrencyManager;

    public void ConnectChartToTable()
    {
        myCurrencyManager = (CurrencyManager)this.BindingContext[sourceTable];
        singleRecordSource1.RecordCurrency=myCurrencyManager;
        tChart1[0].CheckDataSource();
    }

    private void MovePrevious()
    {
        if (myCurrencyManager.Position>0)
        {
            myCurrencyManager.Position=myCurrencyManager.Position-1;
            tChart1[0].CheckDataSource();
        }
    }

    private void MoveNext()
    {
        if (myCurrencyManager.Position<myCurrencyManager.Count-1)
        {
            myCurrencyManager.Position=myCurrencyManager.Position+1;
            tChart1[0].CheckDataSource();
        }
    }

    ・・・・・・・・・・・・・・・・・・・・・

    private void bnPrev_Click(object sender, System.EventArgs e)
    {
        MovePrevious();
        CheckButtons();
    }

    private void bnNext_Click(object sender, System.EventArgs e)
    {
        MoveNext();
        CheckButtons();
    }

    ・・・・・・・・・・・・・・・・・・・・・

■TeeChart.NET と WebChart および ASP.NET

TeeChart.NET を Web アプリケーションで利用するには、2つの方法があります。ツールボックスより TeeChartのWebChart コンポーネントを使用する方法と、WebChart コンポーネントをの代わりに ASP ページのスクリプトにコードでチャートを作成する方法です。以下に、簡単に紹介します。

▼WebChartコンポーネントを使用する方法

【実行例】

WebフォームではTeeChart.NETのWebChartコンポーネントを使用します。
TeeChart.NETをインストールするとツールボックスにWebChartが追加されます。

　【ツールボックス内のWebChartアイコン】

●フォームにチャートを追加

ツールボックスからWebChartコンポーネントを選択し、Webフォーム上にWebChartをドラッグしサイズを調整します。
チャートをマウスで右クリックし、メニューから「編集」を選択してチャートエディタを起動します。
チャートエディタでは、系列や軸および他のチャートの特性が追加、変更できます。

●チャートのデザインとプロパティのオプション

チャートエディタは実行時におけるチャートのほとんどの項目を設定できます。設定はWebフォームに保存されます。
WebChartエディタの使い方は、Windows フォーム用のチャートと一部のチャートツールを除いて同じです。

●イメージフォーマット (PictureFormatプロパティ)
デフォルトのフォーマットはPNGですが、プロパティウィンドウでPictureFormatプロパティを変更できます。

●File あるいは Session の設定 (TempChartプロパティ)

TempChartプロパティは、テンポラリチャートをどのように保存するかを設定します。2つの利用可能な設定があります。

【1】File
デフォルトではTeeChartをインストールすると、テンポラリファイルの位置および同等な仮想フォルダ名を備えたレジストリキーを作成します。

【2】Session
セッションにもテンポラリファイルを保存できます。

●インタラクティブチャートイベントの使用 (AutoPostback プロパティ)

AutoPostbackプロパティをTrueに設定するとインタラクティブイベントを使用できます。
プロパティブラウザのイベントリストから必要とするイベントをダブルクリックすると、イベントが設定されます。

    private void WebChart1_ClickSeries(object sender, Steema.TeeChart.Styles.Series s, int valueIndex, System.EventArgs e)
    {
        Steema.TeeChart.Chart tChart=((WebChart)sender).Chart;
        clickedX=s.CalcXPos(valueIndex);
        clickedY=s.CalcYPos(valueIndex);
        msgText="Series: "+tChart.Series.IndexOf(s).ToString()+"\n\rValue: "+s.YValues[valueIndex].ToString("#0.00");
    }

▼ASPスクリプトでチャートを作成する方法

【実行例】

WebChartコンポーネントの代わりにASPXページのスクリプトにコードでチャートを作成します。

●スクリプトにチャートを追加
【1】新しいASP.NET Webアプリケーションのプロジェクトを作成します。作成されたWebフォームページをクライアントページとして使用します。
【2】新しいWebフォームページを追加します。このページはサーバーサイドでチャートコードを処理するために使用します。

●処理のフロー

クライアントのブラウザページ(SeriesTypes.aspx)はイメージを含んでいます。
そのイメージのリンクはaspxのサーバースクリプト(ProcessChart.aspx)です。
クライアントページの「チャートの更新」ボタンを選択すると、必要な変数を渡してサーバースクリプトを呼び出して、クライアントページに動的なチャートを表示します。

●TeeChartのコーディング
サーバーサイドでTeeChartをコーディングするには、スクリプトページに「using Steema.TeeChart」を追加します。

（例）  using Steema.TeeChart;

TChartの変数を宣言して、Page_Load イベントの最初の部分でクラスを作成します。

（例）

    private TChart tChart;

    private void Page_Load(object sender, System.EventArgs e)
    {
        tChart=new TChart();      

        ・・・・・・・・・
    }

●チャートの取得
クライアントのパラメータによりチャートをサーバーから取得します。
チャートのリクエストはURLのクエリ・ストリングで送信できます。
サーバースクリプトを呼び出すためのコードはWebフォームのコードページで記述します。

（例）
        この例では、Webフォームの変数をクエリ・ストリングでImageUrlに設定します。

        private void sendInfo()
        {
            seriesType=DropDownList1.Items[DropDownList1.SelectedIndex].ToString();
            viewType=CheckBox1.Checked.ToString();
            Image1.ImageUrl="http://"+webServer  /*use webserver variable for server*/
                +"/TeeChartForNET/ASPStream/ProcessChart.aspx?seriestype="
                +seriesType+"&view="+viewType;
        }

サーバースクリプトはクライアントからクエリ・ストリングを受け取り、Page_Loadイベントでチャートは作成されます。
チャートはイメージとして作成され、クライアントへストリームとして戻されます。

（例）
        private void Page_Load(object sender, System.EventArgs e)
        {
            tChart=new TChart();
            tChart.AfterDraw += new Steema.TeeChart.TChart.PaintChartEventHandler(this.tChart_AfterDraw);      
 
            /* ...add Series and data, etc ... */
 
            //Process Get parameters received from client
            if (Request.QueryString["view"]=="False")
                tChart.Aspect.View3D=false;
            else
                tChart.Aspect.View3D=true;
 
            MemoryStream tempStream = new MemoryStream();
            tChart.Export.Image.PNG.Save(tempStream);
            Response.ContentType="Image/PNG";
            Response.OutputStream.Write(tempStream.ToArray(),0,(int)tempStream.Length);
            tempStream.Close();
        }

●イベントの追加
ASPアプリケーションでは、チャート作成後にイベントを追加して処理できます。

（例）
        private void Page_Load(object sender, System.EventArgs e)
        {
            tChart=new TChart();
            tChart.AfterDraw += new Steema.TeeChart.TChart.PaintChartEventHandler(this.tChart_AfterDraw);      
 
            /* ...add Series and data, etc ... */
 
            MemoryStream tempStream = new MemoryStream();
            tChart.Export.Image.PNG.Save(tempStream);
            Response.ContentType="Image/PNG";
            Response.OutputStream.Write(tempStream.ToArray(),0,(int)tempStream.Length);
            tempStream.Close();
        }
 
        private void tChart_AfterDraw(object sender, Steema.TeeChart.Canvas.Graphics3D g)
        {
            string tmpStr="Copyright My Organisation "+DateTime.Now.ToString();
            g.TextOut(g.Chart.Width-(int)g.TextWidth(tmpStr)-5,g.Chart.Height-(int)g.TextHeight("H")-3,tmpStr);
        }

        AfterDrawイベントのコードはチャート作成時に実行されます。

TeeChart Pro .NET 2010J には、 .NET Compact FrameworkでのPocket PC、Windows CE 用のサンプルプログラムが付属しています。

【基本デザイン画面】

参照設定で TeeChart.Pocket を追加します。

 たとえば、次のようなコードで新しくチャートを作成し系列を定義していきます。

   public Form1()
    {
        //
        // Required for Windows Form Designer support
        //
        InitializeComponent();
       
        // Create Chart
        tChart1=new TChart();
        tChart1.Bounds=new Rectangle(6,60,220,176);
        tChart1.Parent=this;
       
        // Chart Title
        tChart1.Header.Text="TeeChart PocketPC";
       
        // Create horizontal bar series
        horizBar1=new Steema.TeeChart.Styles.HorizBar();
        horizBar1.FillSampleValues();
        horizBar1.ColorEach=true;
        tChart1.Series.Add(horizBar1);
       
        // Manage clicks
        horizBar1.Click+=new MouseEventHandler(series_Click);
        tChart1.ClickLegend+=new MouseEventHandler(tChart1_ClickLegend);
       
        // Other setup
        label1.Text="";
        AddComboStyles();
        tChart1.Panel.Color=Color.Wheat;
    }

【Pocket PC 2002 エミュレータによる実行例】

【Windows CE .NET エミュレータによる実行例】

■ランタイムライセンス/Web Server ランタイムライセンスについて

TeeChart Pro .NET 2010J を使用してお客様が作成したアプリケーションは、ユーザ登録をしていただくことで、無償で配布できます。但し、Web　ServerランタイムライセンスはWeb　Server毎に別途ライセンスが必要です｡詳しくは、「ライセンスパック」のページをご覧ください。

■開発ライセンスについて

TeeChart Pro .NET 2010J の通常パッケージには、開発PC1台分のPC開発ライセンスが付属しています。お客様がTeeChart Pro .NET 2010J を使用して複数のPCで開発される場合に、お得な開発ライセンスパックをご用意しております。詳しくは、「ライセンスパック」のページをご覧ください。

■更新ライセンスについて

お客様が TeeChart Pro .NET 2010J を使用する上で1年毎に更新となるライセンスで、ライセンスの更新により、更新時より1年以内に行われたメジャー/マイナーバージョンアップ（修正を含む）を受けられるものです。詳しくは 「更新ライセンス」のページをご覧ください。

■標準価格（シングルライセンス ）

■対応環境

■パッケージ内容

通常パッケージ	セットアップディスク、ユーザ登録カードなど （マニュアルなどのドキュメントはディスクに含まれます） ▼パッケージイメージ サイズ:W136×D15×H191mm(DVD/CD 用トールケース)
1 Web Server ランタイムライセンス	ライセンス許諾契約書、ユーザ登録カード （製品ディスクは付属していません）

※表記中の社名、製品名などは一般に各社の商標または、登録商標です。
※本仕様、及び価格などは予告なしに変更する場合があります。