次の方法で共有


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
継承

注釈

クラスは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)

適用対象