圖例設計

---

點擊立即下載最新版TeeChart for .NET

加入官方社群740060302，歡迎相互交流

圖例參數可通過TeeChart編輯器、圖表選項卡、圖例頁面訪問:

有關圖例參數的更多信息，請參閱圖例類幫助

Style Tab

Legend Style

當圖表中只有一個系列時，圖例默認樣式“Automatic”將在圖例中顯示系列點值。當圖表包含多個系列時，“Automatic”將在圖例中顯示系列名稱。在編輯器中，使用下拉組合框獲取默認值以外的值。如果您更改圖例樣式以顯示值，并且圖表中有多個系列，則TeeChart Pro將顯示第一個系列的值。您可以使用自定義選項修改顯示。參見自定義圖例

將每個系列的最后一個值放入“Legend”框中:

[C#]
tChart1.Legend.LegendStyle = LegendStyles.LastValues;

[VB.Net]
TChart1.Legend.LegendStyle = Steema.TeeChart.LegendStyles.LastValues

Text Style

有關可能的Legend文本樣式列表，請參閱TextStyle屬性。

Vertical Spacing

允許您修改圖例項之間的間距。

Dividing Lines

“Dividing Lines”按鈕提供了“Pen Editor”窗口的訪問權限，在該窗口中，您可以使圖例條目之間的線條可見，并更改其顏色，樣式和寬度。

Visible

這個Visible 復選框啟用/禁用整個圖例的顯示。

Inverted

倒排圖例將使圖例條目的順序顛倒。

Check Boxes

將圖例樣式更改為“Series Names”，并在每個系列旁邊顯示一個復選框，允許它不可見或可見。

Font Series Color

將“圖例”文本的字體顏色更改為系列顏色。

Position Tab

Position

使用Alignment屬性可以選擇4個位置:Top, Bottom, Left和Right。右是默認位置。圖例的默認位置將始終位于圖表之外。有關定位圖例的更多信息，請參閱關于自定義圖例一節。

Resize Chart

未啟用“調整圖表大小”屬性時，將在“圖表框架”區域內繪制圖例。雖然這可能滿足某些圖例定位要求，但通過使用圖例邊距屬性可以更好地控制圖例定位與圖表框架的關系。

Margin

更改頁邊距屬性值將使圖表框架相對圖例移動，反之亦然。因此，設置邊距值為負值將使圖表移動到圖例上方(增加圖表矩形區域的大小)。但是，這些屬性不是用來在圖表上重新定位圖例的，最好使用自定義圖例中概述的技術。

Position Offset %

0%被定義為觸及圖表畫布右側邊框的水平圖例和觸及頂部邊框的垂直圖例。圖例相對于這些位置被偏移。

Custom

此復選框將禁用“Resize Chart ”屬性，并使您能夠以像素為單位在圖表畫布上的任何位置定位圖例。

Symbols Tab

Width

設置Width屬性來定義顏色矩形(符號)的寬度。

Width Units

使用WidthUnits屬性來定義如何解釋寬度。

Position

使用位置屬性設置顏色矩形的位置。

Continuous

使用連續屬性讓不同的圖例顏色矩形相互流動。當設置為True時，不同項目的顏色矩形彼此固定繪制(沒有垂直間距)。當設置為False時，顏色矩形被繪制為單獨的矩形。

Format Tab

Color

color屬性設置Legend畫布的顏色。

Frame

設置圖例框架屬性: Visible, Style, Color，Width [Pen properties].

Pattern

設置圖例畫布的模式: Solid, Hatch, Gradient, Image [Hatch Brush properties].

Round Frame

圖例框架的圓角。

Transparent

使圖例畫布透明，僅顯示圖例文本和符號。

Transparency

當Transparent設置為true時，設置圖例的%透明度。

Text Tab

 這個頁面提供了改變圖例文本字體外觀的屬性，字體的填充屬性[Hatch Brush屬性]和陰影。

Gradient Tab

使用此頁面在圖例畫布上繪制漸變，并更改其方向和顏色。

Shadow Tab

設置圖例陰影的顏色、大小、模式和透明度。

Bevel Tab

設置圖例的內斜面和外斜面的顏色、大小和樣式。

Customising Legends

圖例事件提供了完全控制定義圖例外觀和內容的選項。

OnGetLegendRect event

“圖例”外矩形允許更改“圖例”框的總體大小和位置。與OnGetLegendPos一起使用，重新定位圖表圖例和內容。

例如：

[C#]
private void tChart1_GetLegendRect(object sender, Steema.TeeChart.TChart.GetLegendRectEventArgs e)
{
e.Rectangle=new Rectangle(e.Rectangle.Left-100,e.Rectangle.Top,e.Rectangle.Width,e.Rectangle.Height);
}

[VB.Net]
Private Sub TChart1_GetLegendRect(ByVal sender As Object, ByVal e As Steema.TeeChart.TChart.GetLegendRectEventArgs) Handles TChart1.GetLegendRect
e.Rectangle = New Rectangle(e.Rectangle.Left - 100, e.Rectangle.Top, e.Rectangle.Width, e.Rectangle.Height)
End Sub

OnGetLegendPos event

修改圖例的內容。下面的示例可以與上面的代碼一起使用，將Legend內容移動到新的Legend矩形中。

[C#]
private void tChart1_GetLegendPos(object sender, Steema.TeeChart.TChart.GetLegendPosEventArgs e)
{
e.X = e.X-100;
e.XColor = e.XColor-100;
}

[VB.Net]
Private Sub TChart1_GetLegendPos(ByVal sender As Object, ByVal e As Steema.TeeChart.TChart.GetLegendPosEventArgs) Handles TChart1.GetLegendPos
e.X = e.X - 100
e.XColor = e.XColor - 100
End Sub

OnGetLegendText event

修改圖例內容的文本。

[C#]
private void tChart1_GetLegendText(object sender, Steema.TeeChart.TChart.GetLegendTextEventArgs e)
{
if(e.Index == 3)
{e.Text = e.Text + " Index no.:" + e.Index.ToString();}
}

[VB.Net]
Private Sub TChart1_GetLegendText(ByVal sender As Object, ByVal e As Steema.TeeChart.TChart.GetLegendTextEventArgs) Handles TChart1.GetLegendText
If e.Index = 3 Then
e.Text = e.Text + " Index no.:" + e.Index.ToString
End If
End Sub

當將圖例放置在“圖表”矩形區域中時，請記住圖例繪制在“系列”和“軸”之前，并且在任何交點處都會顯示在它們的下方。