バージョン

注釈の作成

Infragistics 2005 Volume 1 リリースでは、注釈と呼ばれる新しい項目がチャート コントロールに追加されました。これらのチャート要素は、既存のチャート データを補足して、視覚的なキューまたは情報を提供するために使用できます。チャート上の特定の位置を指し示す追加のラベル、矢印、その他の形状で表示されます。

Note

:このトピックでは、チャートはすでに DataSource プロパティが設定されていることを前提とします。これを実行する詳細は、 「データ ソース」を参照してください。

グラフ注釈を作成するには、以下の手順に従ってください。

  1. フォームの [プロパティ] ウィンドウで、 Annotations プロパティをダブルクリックして展開します。

  2. image::images/Chart_Creating_Annotations_01.png[]

  1. Annotations プロパティで Annotations プロパティをクリックし、次に省略記号 (…​) ボタンをクリックして [グラフ注釈エディタ] ダイアログ ボックスを開きます。

  2. image::images/Chart_Creating_Annotations_02.png[]

  1. エディタの左側にある [追加] ボタンをクリックして、使用可能なすべての注釈のドロップダウンを表示します。

  2. image::images/Chart_Creating_Annotations_03.png[]

  1. この例の手順では、[吹き出し注釈を追加] をドロップダウン メニューから選択します。 CalloutAnnotation プロパティがダイアログ ボックスの左側ペインの注釈リストボックスに追加され、そのプロパティがダイアログ ボックスの右側のペインに表示されます。

  2. image::images/Chart_Creating_Annotations_04.png[]

  1. ダイアログ ボックスの右側ペインで、 Location プロパティをクリックして展開します。Location プロパティは、すべてのグラフ注釈の最も基本的なプロパティのひとつです。

  2. Location プロパティを設定する場合の最初の質問は、この注釈に使用する配置タイプです。Location プロパティでは、Type プロパティをクリックし、ドロップダウン矢印をクリックして使用できる配置タイプを表示します。 .

    • LocationType.RowColumn  — 注釈は、Row プロパティと Column プロパティに一致する各グラフ データ項目の上に配置されます。これらの値は、データソース内の対応する行と列のゼロベース インデックスに一致するように設定する必要があります。すべての行または列(あるいは両方)を一致させるには、Row または Column プロパティ(あるいは両方のプロパティ)を -2 に設定します。-2 は、行または列(あるいはその両方)一致のワイルドカードを表す値です。

    • LocationType.DataValues  — 注釈は、X 軸と Y 軸上にマップされたポイントに配置されます。これらの軸上にマップする値は、Location の ValueX および ValueY プロパティで指定します。

    • LocationType.Pixels  — 注釈は、グラフの左上隅からの距離(ピクセル単位)に基づいたポイントに配置されます。これらの水平と垂直方向(X と Y)の距離(ピクセル単位)は、Location の LocationX および LocationY プロパティで指定します。

    • LocationType.Percentage  — 注釈は、グラフの左上隅からの距離(パーセント)に基づいたポイントに配置されます。これらの水平と垂直方向(X と Y)の距離(パーセント単位)は、Location の LocationX と LocationY プロパティで指定します。注釈をグラフ領域に表示する場合、これらの値の有効範囲は 0~100 です。

  1. Type プロパティを RowColumn のデフォルト値にままにします。

  2. Column プロパティの値を 1 に変更します。

  3. Row プロパティの値を 2 に変更します。

  4. Text プロパティをクリックして、吹き出し注釈の名前を入力します。Text プロパティ フィールドの外側をクリックし、[グラフ注釈エディタ] エディタを移動すると、グラフに表示される吹き出し注釈を確認できます。

  5. [グラフ注釈エディタ] ダイアログ ボックスの右側の領域で、 PEPaintElement )プロパティをダブルクリックします。このプロパティによって、注釈の外観を変更できます。 .

この例の手順では、以下のプロパティ設定を変更します。 ElementType プロパティ — グラデーション Fill プロパティ — 茶色 FillGradientStyle プロパティ — 水平 FillStopColor プロパティ — RosyBrown

グラフ注釈は、以下のスクリーンショットの注釈のように見えます。

Chart Creating Annotations 06.png
  1. 注釈で吹き出しのテキストを自動調整できるようにするには、 Height および Width プロパティの両方の値を -1 に変更します。