【TeeChart .NET教程】（五）圖例設計

【下載TeeChart.Net最新版本】字體

Legend control——圖例控制

圖例參數可經過TeeChart編輯器，圖表選項卡，圖例頁面：url

圖例參數訪問。見傳說類的幫助以獲取更多信息

樣式選項卡 spa

Legend Style——圖例樣式.net

圖例默認樣式「自動」將在圖表中只有一個系列時將系列點值放入圖例中。當圖表包含多個系列時，「Automatic（自動）」會將系列名稱放入圖例中。在編輯器中使用Dropdown Combobox獲取默認值之外的值。若是用戶更改圖例樣式以顯示值，而且圖表中有多個系列，TeeChart Pro將顯示第一個系列的值，用戶也可使用自定義選項修改顯示。
在「Legend（圖例）」框中顯示每一個系列的最後一個值：code

[C#.Net]orm

tChart1.Legend.LegendStyle = LegendStyles.LastValues;

[VB.Net]blog

TChart1.Legend.LegendStyle = Steema.TeeChart.LegendStyles.LastValues

Vertical Spacing——垂直間距：教程

容許用戶修改圖例條目之間的間距。

Dividing Lines——分界線：

「Dividing Lines（分隔線）」按鈕能夠訪問「Pen Editor」窗口，能夠在其中使「Legend（圖例）」條目之間的線條可見，並更改其顏色，樣式和寬度。

Visible——可見：

此可見覆選框啓用/禁用整個圖例的顯示。

Inverted——倒序：

反轉圖例會反轉圖例條目的順序。

Check Box——複選框：

將圖例樣式更改成「Series Names（系列名稱）」，並在每一個系列旁邊顯示一個複選框，使其不可見或可見。

Font Series Color——字體系列顏色：

將圖例文本的字體顏色更改成系列顏色。

Position Tab

Position——位置:

使用Alignment屬性有4個位置，Top，Bottom，Left和Right，右邊是默認位置，圖例的默認定位始終位於圖表以外。

Resize Chart——調整圖表大小：

「Resize Chart（調整大小圖表）」屬性未啓用時，將在「圖表」框架區域內繪製圖例。雖然這對於某些Legend定位要求多是使人滿意的，可是經過使用Legend Margin屬性能夠更好地控制與Chart框架相關的Legend定位。

Margin：

更改Margin屬性值將移動Chart框架相對於Legend，反之亦然。所以，將Margin值設爲負值會將圖表移動到圖例上（增長圖表矩形區域的大小）。

Position Offset %——位置偏移%：

0％定義爲觸摸右圖表畫布邊框的水平圖例和觸摸頂部圖標的垂直圖例。

Custom

此複選框將禁用「Resize Chart（調整大小圖表）」屬性，並使您可以在「圖表畫布」的任何位置以圖像爲單位定位圖例。

Symbols Tab

width
設置Width屬性以定義顏色矩形（符號）的寬度。

Width Units
使用WidthUnits屬性定義必須如何解釋寬度。

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

Continuous
使用連續屬性讓不一樣的圖例顏色矩形相互流動。設置爲True時，不一樣項目的顏色矩形將彼此固定繪製（無垂直間距）。設置爲False時，顏色矩形繪製爲單獨的矩形。

Format Tab

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

Frame
設置圖例框架屬性：可見，樣式，顏色和寬度[Pen properties筆屬性]。

Pattern
設置圖例畫布的圖案：實體，填充，漸變，圖像[Hatch Brush properties填充畫筆屬性]。

Round Frame
繞過圖例框架的角落。

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

Transparency
當Transparent設置爲true時，設置Legend的％透明度。

Text Tab——「文本」選項卡
此頁面提供對屬性的訪問，這些屬性可更改圖例文本字體的外觀，字體的填充屬性[填充畫筆屬性]和陰影。

Gradient Tab——「漸變」選項卡
使用此頁面在圖例畫布上繪製漸變並更改其方向和顏色。

Shadow Tab——陰影選項卡
設置圖例陰影的顏色，大小，圖案和透明度。

Bevel Tab——斜角選項卡
設置Legend的內外斜面的顏色，大小和樣式。

Customising Legends

Legend事件提供徹底控制定義Legend外觀和內容的選項。

OnGetLegendRect事件
圖例外部矩形容許更改「圖例」框的總體大小和位置。與OnGetLegendPos結合使用以從新定位圖表圖例和內容。
例如

[C#.Net]

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事件
修改圖例的內容。如下示例可與上面的代碼一塊兒使用，將Legend內容移動到新的Legend矩形。

[C#.Net]

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事件
修改圖例內容的文本

[C#.Net]

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

將圖例放置在圖表矩形區域內時，圖例在系列和軸以前繪製，而且將出如今任何交叉點的任何一個下方。