ChartLabels はグラフデータ上に表示するラベルです。グラフラベルは完全にグラフから独立しているので、グラフがグラフラベルを調整することはありません。グラフラベルは、重要なデータ点を強調するために使用されますが、通常はデータまたはグラフ上に何らかの情報を添付するためにも使用されます。

Label オブジェクトは、独立した矩形の領域を定義し、これをグラフに添付することができます。LabelsCollection コレクションには、特定のグラフ用に定義されたすべてのグラフラベルが含まれます。

個々のグラフラベルにアクセスするために、LabelsCollection コレクションにインデックス番号を指定することができます。

Visual Basic コードの書き方

C1Chart1.ChartLabels.LabelsCollection(0).Text = "First label in collection"

C# コードの書き方

c1Chart1.ChartLabels.LabelsCollection[0].Text = "First label in collection";

Label オブジェクトを生成するには、AddNewLabel メソッドを呼び出します。

Visual Basic コードの書き方

Dim Clabel As C1.Win.C1Chart.Label
Clabel = C1Chart1.ChartLabels.LabelsCollection.AddNewLabel()

C# コードの書き方

C1.Win.C1Chart.Label Clabel;
Clabel = c1Chart1.ChartLabels.LabelsCollection.AddNewLabel();

１つのグラフに表示できるグラフラベルの数に制限はありません。各グラフラベルには、ラベル、ラベルの内側の色、枠線、および添付位置などを設定する属性があり、これらをカスタマイズできます。

Label オブジェクトには、グラフラベルの定義と配置に役立つ多くのプロパティが用意されています。これらのプロパティの内、最も重要なものは次のとおりです。

• Compass プロパティは、ラベルの表示位置を添付点の周囲に指定します。たとえば、Compass プロパティを East に設定すると、ラベルは添付点の右に配置されます。
• AttachMethod プロパティは、ラベルをグラフに添付する方法を指定します。ラベルは、座標、データ座標、またはデータ点に添付することができます。
• Text プロパティは、グラフラベルに表示するテキストを指定します。
• Connected プロパティはブール型で、グラフラベルと添付点を結ぶ引き出し線を描画するかどうかを指定します。True の場合、引き出し線が描画されます。
• Offset プロパティは、グラフラベルから添付する位置までの添付点方向の距離を指定します。データ型は長整数型です。
• DefaultLabelStyle プロパティは、すべてのラベルが継承するデフォルトのスタイルを設定します。たとえば、デフォルトスタイルの BackColor プロパティを黒に設定すると、それ以降のすべてのラベルの背景色は黒になります。