LegendItem 類別

定義

命名空間:

System.Windows.Forms.DataVisualization.Charting

組件:

System.Windows.Forms.DataVisualization.dll

表示儲存於 LegendItemsCollection 類別的圖例項目。

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

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

type LegendItem = class
    inherit ChartNamedElement

Public Class LegendItem
Inherits ChartNamedElement

繼承

Object

ChartElement

ChartNamedElement

LegendItem

備註

類別 LegendItem 代表圖例專案，可以是預設或自訂專案：

• 預設圖例專案會自動插入資料數列或資料點的圖例中。 圓形圖和環圈圖的預設專案代表繪製的資料點，而所有其他圖表類型的專案則代表繪製的數列。 根據預設，這些圖例專案會針對符號色彩使用資料點或數列色彩，以及圖例專案文字的數列或資料點名稱。 您可以使用 控制項的事件 Chart ， CustomizeLegend 在執行時間自訂或刪除預設圖例專案。

• 自訂圖例專案具有使用者定義的文字、符號色彩等等。 不同于預設專案，它們不會與繪製的資料連線。 您可以使用 物件的 屬性 Legend ， CustomItems 在設計階段或執行時間加入自訂圖例專案。

圖例符號可以是矩形、線條或標記，視物件的屬性設定 LegendItem 而定 ImageStyle 。

自訂圖例專案的文字是由 屬性決定 Name 。

建構函式

LegendItem()	初始化 LegendItem 類別的新執行個體。
LegendItem(String, Color, String)	使用指定的名稱、色彩和影像路徑，初始化 LegendItem 類別的新執行個體。

屬性

BackGradientStyle	取得或設定圖例項目背景漸層的方向。 此外，也會判斷是否使用漸層。
BackHatchStyle	取得或設定圖例項目的影線樣式。
BackImageTransparentColor	取得或設定繪製背景影像時，會被透明色彩取代的色彩。
BackSecondaryColor	取得或設定圖例項目的輔色。
BorderColor	取得或設定圖例項目的框線色彩。
BorderDashStyle	取得或設定圖例項目的框線樣式。
BorderWidth	取得或設定圖例項目的框線寬度。
Cells	取得圖例項目中資料格的集合。
Color	取得或設定圖例項目的色彩。
Enabled	取得或設定旗標，指出是否已啟用圖例項目。
Image	取得或設定要顯示為圖例項目符號的影像。
ImageStyle	取得或設定圖例項目影像的顯示樣式。
Legend	取得或設定與這個圖例項目相關聯的 Legend 物件。
MarkerBorderColor	取得或設定標記 (如果使用的話) 的框線色彩。
MarkerBorderWidth	取得或設定標記 (如果使用) 的框線寬度。 以像素為單位。
MarkerColor	取得或設定標記 (如果使用) 的色彩。
MarkerImage	取得或設定圖例項目的標記影像。
MarkerImageTransparentColor	取得或設定繪製標記影像時，會以透明色彩取代的色彩。
MarkerSize	取得或設定圖例項目 (如果使用) 的大小。
MarkerStyle	取得或設定圖例項目的標記樣式。 也可以用於啟用或停用標記的顯示。
Name	取得或設定圖例項目的名稱。
SeparatorColor	取得或設定圖例項目分隔符號的色彩。
SeparatorType	取得或設定圖例項目的分隔符號樣式。
SeriesName	取得或設定與預設圖例項目關聯之 Series 的名稱。
SeriesPointIndex	取得或設定與預設圖例項目關聯之 DataPoint 物件的索引。
ShadowColor	取得或設定圖例項目的陰影色彩。
ShadowOffset	取得或設定圖例項目的陰影位移 (以像素為單位)。
Tag	取得或設定與這個圖表項目關聯的物件。 (繼承來源 ChartElement)
ToolTip	取得或設定圖例項目的工具提示。

方法

Dispose()	釋放 ChartElement 使用的資源。 (繼承來源 ChartElement)
Dispose(Boolean)	釋放 LegendItem 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。
Equals(Object)	判斷指定的 Object 是否等於目前的 ChartElement。 (繼承來源 ChartElement)
GetHashCode()	傳回特定型別的雜湊函式。 (繼承來源 ChartElement)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回表示目前 Object 的字串。 (繼承來源 ChartElement)