【TeeChart Pro ActiveX教程】（五）：圖例設計

---

下載TeeChart Pro ActiveX最新版本

（一）圖例控制

可以通過圖表編輯器，圖表選項卡，圖例頁面訪問圖例參數。

1.1 Style

Legend Style

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

TChart1.Legend.LegendStyle = lsLastValues
'Puts the last value of each Series in the Legend box

Text Style

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

Vertical Spacing

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

Dividing Lines

“Dividing Lines/分割線”按鈕可以訪問“Border Editor/邊框編輯器”窗口，您可以在其中使“Legend/圖例”條目之間的線條可見并更改其顏色，樣式和寬度。

Visible

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

Inverted

Inverting Legend反轉Legend條目的順序。

Check Boxes

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

Font Series Color

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

1.2 Position

Position

使用“Alignment”屬性（頂部，底部，左側和右側）可以使用4個位置。右邊是默認位置。圖例的默認定位始終位于圖表之外。

Resize Chart

大小調整大小圖表屬性，如果未啟用，將在圖表框架區域內繪制圖例。雖然這對于某些Legend定位要求可能是令人滿意的，但是通過使用Legend Margin屬性可以更好地控制與Chart框架相關的Legend定位。

Margin

更改邊距屬性值將移動圖表框架相對于圖例，反之亦然。因此，將Margin值設為負值會將圖表移動到圖例上（增加圖表矩形區域的大小）。

Position Offset %

0％定義為觸摸右圖表畫布邊框的水平圖例和觸摸頂部圖標的垂直圖例。傳說相對于這些位置有所抵消。

Custom

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

1.3 Symbols

Visible

使用Visible屬性顯示或隱藏顏色矩形（符號）。

Width

設置寬度屬性以定義圖例符號的寬度。

Width Units

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

Position

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

Continuous

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

Squared

使用平方屬性使圖例顏色矩形平方。

Default border和Border...

使用這些屬性可以使用您自己的自定義符號覆蓋圖例符號的默認邊框。

1.4 Title

Options

您可以在此處添加要用于圖例標題的文本，并在標題框中對齊文本。使用“visible”復選框隱藏/取消隱藏標題。

Format

使用屬性更改“title”區域背景的顏色，圖案和透明度

Border

混合斜角和框架屬性以及操縱寬度幾乎可以提供任何3D效果組合。通過檢查圓形框架并選擇半徑尺寸將為標題區域提供各種圓角。

Text

使用與標題文本相關的許多屬性來個性化字體和相關效果。

Gradient

使用“visible”屬性顯示或隱藏“title”區域背景顏色漸變。通過組合不同的漸變樣式，顏色，方向和子梯度，可以實現幾乎無限數量的漸變。

Shadow

使用陰影屬性為“title”區域創建陰影效果。

Emboss

與陰影屬性類似，您可以使用浮雕屬性為“title”區域創建浮雕效果。

Picture

您可以將圖像添加到“title”區域背景，然后使用不同的“Filters/過濾器”，“Style”和“Position”屬性以多種方式對其進行修改。

1.5 Format

Color

屬性設置Legend畫布的顏色。

Pattern

設置圖例畫布的圖案。

Transparent

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

Transparency

設置圖例畫布的透明度級別。

1.6 Border

Bevel

使用“Bevel”屬性定義圖例的斜角。

Frame

集圖例框架屬性：可見，樣式，顏色和寬度。

Size

設置圖例斜角的大小。

Round Frame

圖例框架的角落。

1.7 Text

此頁面提供對屬性的訪問，這些屬性可更改圖例文本的字體，輪廓，字符間距和陰影的外觀。

1.8 Gradient

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

1.9 Shadow

設置Legend的陰影的顏色和大小。

1.10 Emboss

您可以通過組合顏色，大小，透明度和模糊屬性，為圖例畫布添加個性化浮雕效果。

1.11 Picture

將圖像添加到圖例畫布，然后可以使用不同的“Filters”，“Style”和“Position”屬性以多種方式進行修改。

---

（二）自定義圖例

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

2.1 OnGetLegendRect事件

圖例外部矩形允許更改“Legend”框的整體大小和位置。與OnGetLegendPos結合使用以重新定位圖表圖例和內容，例如：

Private Sub TChart1_OnGetLegendRect(Left As Long, Top As Long, Right As Long, Bottom As Long)
Left = Left - 100
Right = Right - 100
End Sub

2.2 OnGetLegendPos事件

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

Private Sub TChart1_OnGetLegendPos(ByVal Index As Long, X As Long, Y As Long, XColor As Long)
X = X - 100
End Sub

2.3 OnGetLegendText事件

修改圖例內容的文本。

Private Sub TChart1_OnGetLegendText(ByVal LegendStyle As Long, ByVal ValueIndex As Long, LegendText As String)
LegendText = LegendText + Str$(Index)
End Sub

將圖例放置在圖表矩形區域內時，請記住圖例在系列和軸之前繪制，并且將出現在任何交叉點的任何一個下方。

購買TeeChart Pro AciveX正版授權，請點擊“”喲！