Legend クラス

定義

名前空間:

System.Windows.Forms.DataVisualization.Charting

アセンブリ:

System.Windows.Forms.DataVisualization.dll

グラフ イメージの凡例を表します。

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 オブジェクトの collection プロパティをLegends使用して公開されます。

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

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

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

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

• 内容を自動的に収める。

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

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

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

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

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

他のすべてのグラフの種類では、既定の項目はプロットされたデータ系列の名前です。 各系列には、 Legend 使用する凡例の名前を定義するプロパティがあります。 プロパティが にfalse設定されている場合IsVisibleInLegend、系列の凡例項目は作成されません。 これらの既定の項目のテキストは、 プロパティを 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 表示されます。

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

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

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

コンストラクター

Legend()	Legend クラスの新しいインスタンスを初期化します。
Legend(String)	凡例の名前を指定して、Legend クラスの新しいインスタンスを初期化します。

プロパティ

Alignment	凡例の配置を取得または設定します。
AutoFitMinFontSize	凡例のテキストの自動調整アルゴリズムで使用できる最小のフォント サイズを取得または設定します。
BackColor	凡例の背景色を取得または設定します。
BackGradientStyle	凡例の背景グラデーションの向きを取得または設定します。 グラデーションが使用されているかどうかも判断します。
BackHatchStyle	凡例のハッチング スタイルを取得または設定します。
BackImage	凡例の背景イメージを取得または設定します。
BackImageAlignment	Unscaled 描画モードに使用される背景イメージの配置を取得または設定します。
BackImageTransparentColor	背景イメージが描画されるときに透明色で置き換えられる色を取得または設定します。
BackImageWrapMode	凡例の背景イメージの描画モードを取得または設定します。
BackSecondaryColor	凡例の背景の 2 番目の色を取得または設定します。
BorderColor	凡例の境界線の色を取得または設定します。
BorderDashStyle	凡例の境界線スタイルを取得または設定します。
BorderWidth	凡例の境界線の幅を取得または設定します。
CellColumns	凡例のセル列のコレクションを含む LegendCellColumnCollection オブジェクトを取得します。
CustomItems	カスタムの凡例項目に使用される LegendItemsCollection オブジェクトを取得します。
DockedToChartArea	凡例のドッキング先の ChartArea の名前を取得または設定します。
Docking	凡例をドッキングするかどうかを決定する値を取得または設定します。
Enabled	凡例が有効かどうかを示す値を取得または設定します。
Font	凡例のフォント プロパティの設定に使用する Font オブジェクトを取得または設定します。
ForeColor	凡例のテキストの色を取得または設定します。
HeaderSeparator	凡例の見出しに表示する区切り記号の種類を取得または設定します。
HeaderSeparatorColor	凡例の見出しの区切り記号の色を取得または設定します。
InsideChartArea	凡例の描画先であるグラフ エリアの名前を取得または設定します。
InterlacedRows	凡例の行をインターレース背景色で描画するかどうかを示すフラグを取得または設定します。
InterlacedRowsColor	凡例のインターレース行の背景色を取得または設定します。
IsDockedInsideChartArea	凡例をグラフ エリアの内側にドッキングするか、外側にドッキングするかを示すフラグを取得または設定します。
IsEquallySpacedItems	すべての凡例項目を等間隔で配置するかどうかを示すフラグを取得または設定します。
IsTextAutoFit	凡例のテキストのサイズが自動的に設定されるかどうかを示すフラグを取得または設定します。
ItemColumnSeparator	凡例のテーブル列に表示する区切り記号の種類を取得または設定します。
ItemColumnSeparatorColor	凡例のテーブル列の区切り記号の色を取得または設定します。
ItemColumnSpacing	凡例のテーブル列の間隔を取得または設定します。
LegendItemOrder	凡例項目を表示する順序を指定する値を取得または設定します。 このプロパティは、グラフの系列に自動的に追加された凡例項目にのみ影響します。カスタムの凡例項目には影響しません。
LegendStyle	凡例のスタイルを取得または設定します。
MaximumAutoSize	グラフ エリアの割合として示される、凡例の最大サイズを取得または設定します。 この値は自動レイアウト アルゴリズムで使用されます。
Name	凡例の名前を取得または設定します。
Position	凡例の位置の取得または設定に使用できる ElementPosition オブジェクトを取得または設定します。
ShadowColor	凡例の影色を取得または設定します。
ShadowOffset	凡例の影のオフセット (ピクセル単位) を取得または設定します。
TableStyle	凡例のテーブルのスタイルを取得または設定します。
Tag	このグラフ要素に関連付けられているオブジェクトを取得または設定します。 (継承元 ChartElement)
TextWrapThreshold	テキストを折り返す前に凡例に連続して表示できる文字数を取得または設定します。
Title	凡例のタイトルのテキストを取得または設定します。
TitleAlignment	凡例のタイトルの配置を取得または設定します。
TitleBackColor	凡例のタイトルの背景色を取得または設定します。
TitleFont	凡例のタイトルのフォントを取得または設定します。
TitleForeColor	凡例のタイトルのテキストの色を取得または設定します。
TitleSeparator	凡例のタイトルに表示する区切り記号の種類を取得または設定します。
TitleSeparatorColor	凡例のタイトルの区切り記号の色を取得または設定します。

メソッド

Dispose()	ChartElement で使用したリソースを解放します。 (継承元 ChartElement)
Dispose(Boolean)	Legend によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。
Equals(Object)	指定した Object が現在の ChartElement と等しいかどうかを示します。 (継承元 ChartElement)
GetHashCode()	特定の型のハッシュ関数を返します。 (継承元 ChartElement)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在の Object を表す文字列を返します。 (継承元 ChartElement)