Legend クラス

定義

public ref class Legend : System::Windows::Forms::DataVisualization::Charting::ChartNamedElement

public class Legend : System.Windows.Forms.DataVisualization.Charting.ChartNamedElement

type Legend = class
    inherit ChartNamedElement

Public Class Legend
Inherits ChartNamedElement

継承

Object

ChartElement

ChartNamedElement

Legend

注釈

Legend クラスは、Chart コントロールの凡例のすべての機能をカプセル化し、ルート Chart オブジェクトの Legends コレクション プロパティを使用して公開されます。

グラフ イメージには任意の数の凡例を指定できます。

凡例には次のことができます。

• ドッキングして整列します。

• プロットされたグラフ領域の内側または外側に表示されます。

• コンテンツを自動的に収める。

• 行、列、テーブルなどの定義済みのスタイルを使用します。

• ハッチング、グラデーションの色、背景画像を使用します。

• グラフイメージ内の任意の場所にサイズを設定し、配置します。

凡例項目は、 LegendItem オブジェクトによって表され、既定またはカスタム項目です。 カスタム項目はデータに関連付けされず、 CustomItems プロパティを使用して追加、削除、変更できます。

既定の項目は既定で凡例に自動的に追加され、ドーナツ グラフと円グラフのプロットされたデータ ポイントの名前です。

他のすべての種類のグラフでは、既定の項目はプロットされたデータ系列の名前です。 各系列には、使用する凡例の名前を定義する Legend プロパティがあります。 IsVisibleInLegend プロパティがfalseに設定されている場合、系列の凡例項目は作成されません。 これらの既定の項目のテキストは、 LegendText プロパティを使用して変更できます。 このプロパティを使用すると、実行時に適切な値に置き換えられる定義済みのキーワードを指定できます。

円グラフがあり、 Label プロパティを設定すると、凡例テキストもラベルに設定した値に設定されます。 テキストを別の値に設定する場合は、 LegendText プロパティを設定できます。 ほとんどの場合、 LegendText プロパティを "#AXISLABEL" または "#VALX" に設定します。

凡例系列のシンボルは、四角形、ドット、または線です。 シンボルの種類はグラフによって自動的に設定され、プロットされたグラフの種類によって異なります。

既定では、凡例テキストのサイズは自動的に設定されます。 IsTextAutoFit プロパティを無効にすると、凡例テキストの自動サイズ変更を無効にできます。 このプロパティを false に設定すると、凡例テキストのサイズは凡例 Fontの Size プロパティによって決まります。 IsTextAutoFit プロパティが有効になっている場合、AutoFitMinFontSize プロパティは、凡例項目のサイズを変更するときに使用できる最小フォント サイズを決定します。

TextWrapThreshold プロパティは、テキストを別の行に折り返す前に 1 行に表示できる文字数の制限を定義します。 凡例の文字列を折り返さない場合は、 TextWrapThreshold プロパティの値を 0 に設定します。 既定では、凡例テキスト全体が凡例に収まらない場合、テキストは切り捨てられます。 凡例の TextWrapThreshold を設定して、切り捨てるのではなく、折り返すテキストを取得できます。

凡例の内容が指定されたスペースに収まらない場合、凡例エントリは切り捨てられます。 凡例のスペースよりも多くのエントリがあることを示す省略記号が表示されます。 凡例項目が切り捨てられないようにするには、 Position プロパティを使用して凡例の位置とサイズを設定します。 凡例の位置またはサイズを設定すると、グラフ内の要素を自動的に配置できなくなります。 多くの場合、目的の外観を実現するには、他のグラフ要素を手動で配置する必要があります。

もう 1 つのオプションは、既定の凡例設定を使用するのではなく、独自のセル列を定義することです。

Legend オブジェクトには CellColumn コレクションがあります。各 CellColumn オブジェクトは Legend の列を表します。 セル列には、列のサイズを調整するために使用できる MaximumWidth プロパティと MinimumWidth プロパティがあります。

凡例に多数のエントリが含まれている場合は、 InterlacedRows を使用して読みやすくすることができます。 このプロパティを True に設定すると、 InterlacedRowsColor プロパティを使用して設定できる背景色が表示されます。

既定では、凡例はグラフの右上隅に配置されます。 この位置は、凡例の Docking プロパティと Alignment プロパティを使用して変更できます。 凡例は、 DockedToChartArea プロパティを使用してグラフエリアに関連付けることもできます。 このプロパティは、凡例をドッキングするグラフ領域の名前を指定します。 さらに、 IsDockedInsideChartArea プロパティを使用して、グラフエリア内に凡例を表示できます。

IsDockedInsideChartAreaが False に設定されている場合、MaximumAutoSize プロパティは、凡例が自動的に配置されるときに、使用可能なグラフ内の凡例の最大サイズをパーセント単位で定義します。 このプロパティは、ドッキング プロパティの設定後に凡例の幅または高さを調整する場合に設定する必要があります。

凡例は、 CustomizeLegend イベントを使用して変更できます。