バージョン

ブレット グラフの追加

目的

このトピックでは、UltraBulletGraph™ コントロールを Windows Forms アプリケーションに追加する方法を説明します。

前提条件

本トピックの理解を深めるために、以下のトピックを参照することをお勧めします。

トピック 目的

このトピックでは、主要機能、最小要件、ユーザー機能など、 UltraBulletGraph コントロールに関する概念的な情報を提供します。

UltraBulletGraph の追加 – 概念的な概要

UltraBulletGraph の追加の概要

UltraBulletGraph をページに追加するには、コントロールのインスタンスを作成して、フォームに追加する必要があります。コントロールは、主目盛や副目盛に0 から 100 までの値を使用して、スケールを表示するようあらかじめ設定されています。さらに、配置されたコンテナーのサイズをデフォルトで測定します。

要件

以下の Infragistics アセンブリをメイン プロジェクトに追加します。

  • Infragistics.Win.DataVisualization.UltraGauges.dll

  • Infragistics.Win.DataVisualization.Shared.dll

  • Infragistics.Win.Portable.Core.dll

また、次の Infragistics 名前空間を追加します。

C# の場合:

using Infragistics.Win.DataVisualization;

VB の場合:

Imports Infragistics.Win.DataVisualization

手順

以下は、UltraBulletGraph を追加する一般的な手順です。

1.UltraBulletGraph コントロールの追加

2.スケールの構成

3.パフォーマンス バーの構成

4.比較マーカーの構成

5.追加要素の構成 (詳細は、UltraBulletGraph の追加 – コード例および UltraBulletGraph の構成を参照してください。)

UltraBulletGraph の追加 – コード例

概要

以下の手順は、UltraBulletGraph コントロールのインスタンスを作成して Windows Forms アプリケーションに追加し、パーフォーマンス バーと比較目盛マーカー、および 3 つの比較範囲をスケールに構成します。

プレビュー

以下のスクリーンショットは最終結果のプレビューです。

BulletGraph Adding BulletGraph 1.png

概要

以下はプロセスの概要です。

1. UltraBulletGraph コントロールの追加

2. スケールの構成

3. パフォーマンス バーの構成

4. 比較マーカーの構成

5. 比較範囲の追加

手順

以下の手順は、UltraBulletGraph コントロールをアプリケーションに追加する方法について説明します。

1.UltraBulletGraph コントロールを追加します。

UltraBulletGraph をフォームに追加し、サイズを設定します。

C# の場合:

UltraBulletGraph bulletGraph = new UltraBulletGraph();
bulletGraph.Height = 100;
bulletGraph.Width = 300;
this.Controls.Add(bulletGraph);

Visual Basic の場合:

Dim bulletGraph As New UltraBulletGraph()
bulletGraph.Height = 100
bulletGraph.Width = 300
Me.Controls.Add(bulletGraph)

この宣言は、 デフォルトの外観設定および固定サイズで、 UltraBulletGraph のインスタンスを作成します。これは、スケールが主目盛および副目盛を使用して 0 から 100 の範囲で表示されるため、追加構成が必要なことを意味します。

BulletGraph Adding BulletGraph 2.png

2.スケールを構成します。

スケールの値をカスタマイズするには、MinimumValue および MaximumValue プロパティを設定する必要があります。 この例では、スケールは 5 から開始され 55 で終了します。

C# の場合:

bulletGraph.MaximumValue = 55;
bulletGraph.MinimumValue = 5;

Visual Basic の場合:

bulletGraph.MaximumValue = 55
bulletGraph.MinimumValue = 5

変化したスケールを以下のスクリーンショットに示します。

BulletGraph Adding BulletGraph 3.png

3.パフォーマンス バーを追加します。

UltraBulletGraph の主要なメジャーはそのパフォーマンス バーにより視覚化されます。値は Value プロパティ設定で制御します。この例では、 Value プロパティを 35 に設定します。

C# の場合:

bulletGraph.Value = 35;

Visual Basic の場合:

bulletGraph.Value = 35

4.比較マーカーを構成します。

スケール上の比較目盛マーカーの配置は、TargetValue プロパティの値で制御します。この例では、 TargetValue プロパティを 43 に設定します。

C# の場合:

bulletGraph.TargetValue = 43;

Visual Basic の場合:

bulletGraph.TargetValue = 43

以下のスクリーンショットは、これまでの手順で UltraBulletGraph コントロールの外観がどのようになるかを示しています。

BulletGraph Adding BulletGraph 4.png

5.比較範囲を追加します。

パフォーマンス バーで表示された値とある意味を持たせた範囲の値を比較するためには、比較範囲をスケール上に表示する必要があります。比較範囲は、複数の LinearGraphRange を個別に内部で定義できる Ranges プロパティが制御します。各範囲には、独自の開始値と終了値 (StartValue および EndValue) と色 (Brush) があります。

この例では、3 つの比較範囲を構成します。それぞれ異なる灰色のグラデーションで、スケール目盛の 0、15、30 から開始します。

C# の場合:

LinearGraphRange range1 = new LinearGraphRange();
range1.StartValue = 0;
range1.EndValue = 15;
range1.Brush = new SolidColorBrush(Color.FromArgb(47, 47, 47));

LinearGraphRange range2 = new LinearGraphRange();
range2.StartValue = 15;
range2.EndValue = 30;
range2.Brush = new SolidColorBrush(Color.FromArgb(158, 158, 158));

LinearGraphRange range3 = new LinearGraphRange();
range3.StartValue = 30;
range3.EndValue = 55;
range3.Brush = new SolidColorBrush(Color.FromArgb(198, 198, 198));

bulletGraph.Ranges.Add(range1);
bulletGraph.Ranges.Add(range2);
bulletGraph.Ranges.Add(range3);
bulletGraph.TargetValueBrush = new SolidColorBrush(Color.FromArgb(255, 255, 255));

Visual Basic の場合:

Dim range1 As New LinearGraphRange()
range1.StartValue = 0
range1.EndValue = 15
range1.Brush = New SolidColorBrush(Color.FromArgb(47, 47, 47))

Dim range2 As New LinearGraphRange()
range2.StartValue = 15
range2.EndValue = 30
range2.Brush = New SolidColorBrush(Color.FromArgb(158, 158, 158))

Dim range3 As New LinearGraphRange()
range3.StartValue = 30
range3.EndValue = 55
range3.Brush = New SolidColorBrush(Color.FromArgb(198, 198, 198))

bulletGraph.Ranges.Add(range1)
bulletGraph.Ranges.Add(range2)
bulletGraph.Ranges.Add(range3)
bulletGraph.TargetValueBrush = New SolidColorBrush(Color.FromArgb(255, 255, 255))

グラフの最終的な外観を以下に示します。

BulletGraph Adding BulletGraph 1.png

関連コンテンツ

トピック

このトピックの追加情報については、以下のトピックも合わせてご参照ください。

トピック 目的

このトピック グループは、向きや方向および視覚要素を含む UltraBulletGraph コントロールのさまざまな要素を構成する方法を説明します。

このトピックでは、UltraBulletGraph コントロールに関連するキー クラスやプロパティに関する参考情報を提供します。