【TeeChart .NET教程】（二）圖表顯示屬性

---

【下載TeeChart.Net最新版本】

圖表顯示功能是影響圖表整體外觀的功能。它們包括定義圖表背景顏色的屬性和方法，標題及其位置，邊距，邊框和斜面，背景圖像，框架和軸可見，筆顏色和寬度，3D，墻壁等。
幾乎所有這些屬性都是可以在設計或運行時通過TeeChart Editor獲得，您可以在運行時以編程方式修改這些屬性。整體圖表外觀特征分為以下類別：

• General：常規
• Axis：軸
• Titles：標題
• Legend：圖例
• Panel：面板
• Paging：分頁
• Walls：墻
• 3D

如果用戶打開TeeChart編輯器并瀏覽圖表頁面，則可以找到這些分組。其他屬性會影響圖表的“外觀”。這些包括系列顏色和標記特征，單獨的軸和網格顯示屬性和標簽。這些將在稍后專門介紹這些功能的專家角色的教程中處理。

圖表顯示屬性入門

向表單添加一個新圖表，將看到它以3D顯示，帶有灰色面板背景，2個墻（底部和左側），框架（定義圖表可繪制區域的框架）和默認值圖表標題標題“TeeChart”。

右鍵單擊圖表并從菜單中選擇“Edit ...”以訪問TeeChart編輯器。第一頁是系列頁面，它是空的。選擇第三個“圖表”選項卡“常規”以訪問“常規圖表”屬性頁面。

常規圖表屬性

常規選項包括以下3個部分：

• Zoom ：縮放
• Scroll ：滾動
• Cursor ：光標

Axis：軸屬性

在最復雜的復雜程度上，軸的控制是一個非常專業的領域，并在后面的教程中進行更深入的處理。在這里，我們將介紹Axis和Frame顯示的基礎知識。

第二個Chart頁面包含用于定義軸和框架特征的屬性。

圖表中有6個主軸。左，上，右，下，深度底部和深度頂部。圖表框顯示為圖表可繪制區域的環繞，并且沒有數據對應的功能。默認情況下，Depth初始化為不可見。從系列添加到圖表并與這些軸關聯的那一刻（默認為左和底），所有其他軸都可見?？梢允褂脤υ捒蛏系?和 - 鍵添加/刪除自定義軸。要使自定義軸可見（與任何其他軸一樣），系列必須與軸關聯。有關自定義軸的更多信息，請參見Axis教程。
啟用軸和框架顯示的關鍵屬性是：

Visible

此復選框啟用或禁用所有軸的顯示。如果后墻框架可見，則隱藏軸時圖表環繞仍然可見。結果將是更大的圖表的外觀，因為沒有為軸標簽保留區域。每個軸（“標尺”選項卡）的“可見”屬性將覆蓋每個軸的可見特征。如果在列表中選擇深度軸，則會注意到Depth Axis Scales.Visible默認為“'not visible”。

[C#.Net]

tChart1.Axes.Visible = true;

[VB.Net]

TChart1.Axes.Visible = True 

軸：左，右，上，下和深可見

選擇要在列表框中顯示或隱藏的軸，并在“比例”選項卡上切換“visible”復選框以控制該特定軸的顯示。

[C#.Net]

tChart1.Axes.Left.Visible = true; 

[VB.Net]

TChart1.Axes.Left.Visible = True

Title：標題

TeeChart Editor的Titles頁面控制圖表標題，頁眉和頁腳的特征。

Text

使用下拉組合框選擇標題（標題），子標題，英尺或子圖標。在文本框中輸入所需的文本。您可以輸入多行標題。
運行時：

Header類的Text屬性是標準的.Net String類，可以這樣修改，例如：

[C#.Net]

tChart1.Header.Text = "My Header Text"; 

[VB.Net]

TChart1.Header.Text = "My Header Text" 

樣式對齊

對齊是指與圖表區域相對的頁眉（或頁腳）對齊而不是整個圖表面板。圖表區域是圖表加軸標簽和圖例的可繪圖區域。

Runtime：

[C#.Net]

tChart1.Header.Alignment = StringAlignment.Far; 

[VB.Net]

TChart1.Header.Alignment = StringAlignment.Far 

Position：位置

使用位置覆蓋標題或頁腳默認位置并設置自定義位置（與圖表頂部，左側的像素關系）。

Runtime：

[C#.Net]

tChart1.Header.CustomPosition = true; 
tChart1.Header.Top = tChart1.Header.Top + 10; 

[VB.Net]

TChart1.Header.CustomPosition = True 
TChart1.Header.Top = TChart1.Header.Top + 10

Format：格式

包含“標題”框的設置，例如框的顏色，框周圍框的筆屬性，框的畫筆屬性[圖案]等。例如，圖案，模式是指背景圖案[實心，陰影，漸變或標題或頁腳框的圖像]。

默認值為“Transparent：透明”，表示在取消選中“透明”復選框之前，“標題”框不可見。

Runtime：

[C#.Net]

tChart1.Header.Transparent = false; 
tChart1.Header.Brush.Style = System.Drawing.Drawing2D.HatchStyle.Cross; 

[VB.Net]

TChart1.Header.Transparent = False 
TChart1.Header.Brush.Style = System.Drawing.Drawing2D.HatchStyle.Cross 

Text：文本

包含標題文本外觀格式特征。例如，字體：字體按鈕將授予對“字體對話框”窗口的訪問權限，該窗口允許選擇Windows字體和樣式（斜體，粗體等）和顏色的定義。

Runtime：

[C#.Net]

tChart1.Header.Font.Name =“Verdana”; 
tChart1.Header.Font.Bold = true; 

[VB.Net]

TChart1.Header.Font.Name =“Verdana” 
TChart1.Header.Font.Bold = True

Shadow：陰影

屬性，用于顯示頁眉或頁腳框陰影。您可以定義顏色和ChartBrush [solid，hatch，gradient或image]。

Runtime：

[C#.Net]

tChart1.Header.Shadow.Visible = true; 
tChart1.Header.Shadow.Color = Color.Chartreuse; 

[VB.Net]

TChart1.Header.Shadow.Visible = True 
TChart1.Header.Shadow.Color = Color.Chartreuse 

Bevels：斜杠

定義頁眉或頁腳框的斜角屬性。

Legend：圖例

圖例內容是專業主題，將在后面的教程中處理。在TeeChart Editor的Legend頁面中，用戶可以定義Legend的外觀方面。重要的初始步驟是控制圖例對齊和可見屬性，顏色，字體，框架，陰影等。

Style：樣式

切換開/關圖例顯示和設置圖例顯示內容特征（包括復選框等）。

Runtime：

使用復選框控制圖例顯示的示例：

[C#.Net]

private void checkBox1_CheckedChanged(object sender, System.EventArgs e) 
        { 
            if(checkBox1.Checked) 
            {tChart1.Legend.Visible = true;} 
            else 
            {tChart1.Legend.Visible = false;} 
        }

[VB.Net]

Private Sub CheckBox1_CheckedChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles CheckBox1.CheckedChanged 
        If CheckBox1.Checked Then 
            TChart1.Legend.Visible = True 
        Else 
            TChart1.Legend.Visible = False 
        End If 
End Sub 

％Divided Lines：用于在Legend條目之間的Legend框中繪制線條。ChartPen屬性適用。

Runtime：

[C#.Net]

tChart1.Legend.DividingLines.Visible = true; 
tChart1.Legend.DividingLines.Color = Color.Blue; 

[VB.Net]

TChart1.Legend.DividingLines.Visible = True 
TChart1.Legend.DividingLines.Color = Color.Blue

Position：位置

設置默認顯示位置或啟用圖例的自定義位置。TChart將改變圖例的形狀以適合該位置。如果圖例設置為圖表的側面（左側或右側），默認情況下，圖例的內容將從上到下列為列表。如果圖例位于圖表下方或上方，則圖例內容并排放置?？梢允褂?ldquo;調整大小圖表”選項和/或使用“自定義”定位來覆蓋默認行為。有關Legend的自定義定位的更多信息，請參閱Legend教程。
例如，ResizeChart

Resize Chart定義圖表在繪制時是否為Legend留出空間。這允許圖例放置在圖表區域內。

Runtime：

[C#.Net]

tChart1.Legend.DividingLines.Visible = true; 
tChart1.Legend.DividingLines.Color = Color.Blue; 

[VB.Net]

TChart1.Legend.DividingLines.Visible = True 
TChart1.Legend.DividingLines.Color = Color.Blue 

％頂部位置：定義圖表面板頂部的圖例框位移。

Runtime：

[C#.Net]

tChart1.Legend.CustomPosition = true; 
tChart1.Legend.Top = 5; 

[VB.Net]

TChart1.Legend.CustomPosition = True 
TChart1.Legend.Top = 5 

Symbols

圖例符號的大小和格式。

％顏色寬度：定義圖例中顏色框的寬度。

Runtime：

[C#.Net]

tChart1.Legend.Symbol.WidthUnits = LegendSymbolSize.Pixels; 
tChart1.Legend.Symbol.Width = 30;

[VB.Net]

TChart1.Legend.Symbol.WidthUnits = Steema.TeeChart.LegendSymbolSize.Pixels 
TChart1.Legend.Symbol.Width = 30

Format：格式

包含“圖例”框的設置，例如“顏色”，“框架”（ChartPen屬性），“圖案”（ChartBrush屬性）以及“圓形框架”和“透明”的復選框。

Text：文本

文本內容及其陰影的文本特征。

Runtime：

[C#.Net]

private void button1_Click(object sender, System.EventArgs e) 
        { 
            Legend legend1; 
            legend1 = tChart1.Legend; 
            legend1.Color = Color.Blue; 
            legend1.Font.Name = "Times New Roman"; 
            legend1.Font.Color = Color.Yellow; 
        } 

[VB.Net]

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click 
        With TChart1.Legend 
            .Color = Color.Blue 
            .Font.Name = "Times New Roman" 
            .Font.Color = Color.Yellow 
        End With 
End Sub 

Gradient：漸變

在“圖例”框中啟用/禁用“背景漸變”，然后選擇其方向和顏色。

Shadow：陰影

屬性用于顯示“圖例”框陰影。您可以定義顏色，圖案（ChartBrush）大小和透明度。

Runtime：

[C#.Net]

tChart1.Legend.Shadow.Color = Color.Cyan; 
tChart1.Legend.Shadow.Width = 4;

[VB.Net]

TChart1.Legend.Shadow.Color = Color.Cyan 
TChart1.Legend.Shadow.Width = 4

Bevels：斜面

屬性為內，外斜面顏色和大小。

Panel：面板

TeeChart Panel頁面允許用戶設置參數，從而大大增強圖表的外觀。面板漸變效果最適合支持真彩色的顯示器，可以通過Panel界面訪問面板屬性和方法：

關鍵區域是：

Borders：邊框

用戶可以單獨定義邊框，也可以與“倒角”屬性一起定義邊框?；旌闲苯呛瓦吙蛞约安倏v寬度幾乎可以提供任何3D效果組合。例如斜角內/斜角外/邊框寬度
這些屬性將在“圖表”邊框的面板上生成各種3D效果。在設計時修改它們以查看它們如何影響圖表邊框斜面。

Background：背景

例如：面板顏色，面板顏色將使用所選顏色繪制整個圖表背景。如果選擇查看背景漸變或圖像，則會隱藏面板顏色。如果設置背面顏色，它將僅替換圖表框架中的面板顏色。

例如：BackImage用戶可以選擇任何位圖文件作為BackImage。使用Hatch Brush Editor（來自Pattern按鈕）有五種不同的Wrap模式可供BackImage選擇。

Runtime：

使用ChartBrush.LoadImage在運行時將背景圖像添加到圖表。

[C#.Net]

tChart1.Panel.Brush.WrapMode = System.Drawing.Drawing2D.WrapMode.TileFlipXY; 
tChart1.Panel.Brush.LoadImage(@"C:\...\MyImage.jpg"); 

[VB.Net]

TChart1.Panel.Brush.WrapMode = System.Drawing.Drawing2D.WrapMode.TileFlipXY 
TChart1.Panel.Brush.LoadImage("C:\...\MyImage.jpg") 

Margins：邊距

邊距定義為圖表邊框與圖表框架之間的距離，并表示為圖表面板總體尺寸的百分比。在“圖表編輯器邊距”框中移動旋轉框將在設計時顯示更改每個邊距的效果。運行時屬性是：

TChart1.Panel.MarginTop   
TChart1.Panel.MarginLeft 
TChart1.Panel.MarginRight 
TChart1.Panel.MarginBottom

可以使用HScrollbar來更改這些屬性：

[C#.Net]

private void Form1_Load(object sender, System.EventArgs e) 
        { 
            bar1.FillSampleValues(10); 
            hScrollBar1.Value = Convert.ToInt32(tChart1.Panel.MarginLeft); 
            hScrollBar1.Maximum = 80; 
        } 
 
private void hScrollBar1_Scroll(object sender, System.Windows.Forms.ScrollEventArgs e) 
        { 
            tChart1.Panel.MarginLeft = Convert.ToDouble(e.NewValue); 
        } 

[VB.Net]

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load 
        Bar1.FillSampleValues(10) 
        HScrollBar1.Value = TChart1.Panel.MarginLeft 
        HScrollBar1.Maximum = 80 
End Sub 
 
Private Sub HScrollBar1_Scroll(ByVal sender As Object, ByVal e As System.Windows.Forms.ScrollEventArgs) Handles HScrollBar1.Scroll 
        TChart1.Panel.MarginLeft = e.NewValue 
End Sub 

Gradient漸變

要定義漸變，必須選擇StartColor和EndColor（加上，可選擇MidColor）并啟用“Visible the Gradient：可見漸變”。Gradient將覆蓋整個Chart面板。漸變方向定義Start，Mid和EndColor之間的顏色變化方向。

Runtime：

[C#.Net]

tChart1.Panel.Gradient.Visible = true; 
tChart1.Panel.Gradient.StartColor = Color.Red; 
tChart1.Panel.Gradient.MiddleColor = Color.White; 
tChart1.Panel.Gradient.EndColor = Color.Blue; 
tChart1.Panel.Gradient.Direction = System.Drawing.Drawing2D.LinearGradientMode.ForwardDiagonal; 

[VB.Net]

With TChart1.Panel 
         .Gradient.Visible = True 
         .Gradient.StartColor = Color.Red 
         .Gradient.MiddleColor = Color.White 
         .Gradient.EndColor = Color.Blue 
         .Gradient.Direction = System.Drawing.Drawing2D.LinearGradientMode.ForwardDiagonal 
End With 

Shadow：陰影

定義“圖表”面板陰影的大小，顏色，圖案（ChartBrush）和透明度屬性。

Paging：分頁

TeeChart分頁允許將圖表劃分為每頁的設定點數和圖表。

Walls

圖表編輯器的“圖表”部分中的此頁面將屬性應用于圖表墻。有4個墻：左，右，下和后，可以用2D或3D表示，可以通過TChart1.Walls屬性訪問Walls屬性。

Color：顏色

“顏色”按鈕轉到“顏色編輯器”，使用戶可以選擇所選墻的顏色。

Border：邊框

邊框按鈕轉到Walls類的ChartPen定義。

visible屬性啟用/禁用Border的顯示。對于BackWall，其中軸是可見的，墻邊框將隱藏在這些軸后面，因此如果隱藏部分或全部軸，用戶將只看到啟用/禁用邊框的結果（例如，使軸頂部和右側不可見改變Wall Border顏色的結果，即TChart1.Walls.Back.Pen.Color = Color.Blue）。
有關Border Pen的其他特征，請參見ChartPen。用戶可以在設計時更改這些屬性。

Pattern

Pattern按鈕：Walls類的ChartBrush定義。這與許多其他TeeChart對象相同。

Gradient

漸變按鈕：“漸變編輯器”，您可以選擇所選墻的漸變。

3D

3D在TeeChart Pro中非常靈活，可以選擇將圖表顯示為：

• 2D平面圖，從正面??看
• 由矢量線表示的3D正交3D表示深度
• 使用3D畫布的3D原生Windows 3D，180度圖表旋轉

3 Dimensions

選擇此屬性（切換）將在設計時將圖表從3D更改為2D圖表，該設置將在運行時生效。

3D％

控制3D效果的深度。更改此屬性的值將在設計時顯示更改3D百分比的效果。這些屬性的應用示例使用CheckBox和Horizo??ntal ScrollBar：

[C#.Net]

private void checkBox1_CheckedChanged(object sender, System.EventArgs e) 
        { 
            if(checkBox1.Checked) 
            { 
                tChart1.Aspect.View3D = true; 
                hScrollBar1.Enabled = true; 
            } 
            else 
            { 
                tChart1.Aspect.View3D = false; 
                hScrollBar1.Enabled = false; 
            } 
        } 
 
private void hScrollBar1_Scroll(object sender, System.Windows.Forms.ScrollEventArgs e) 
        { 
            tChart1.Aspect.Chart3DPercent = e.NewValue; 
        } 

[VB.Net]

Private Sub CheckBox1_CheckedChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles CheckBox1.CheckedChanged 
        If CheckBox1.Checked Then 
            TChart1.Aspect.View3D = True 
            HScrollBar1.Enabled = True 
        Else 
            TChart1.Aspect.View3D = False 
            HScrollBar1.Enabled = False 
        End If 
End Sub 

Private Sub HScrollBar1_Scroll(ByVal sender As Object, ByVal e As System.Windows.Forms.ScrollEventArgs) Handles HScrollBar1.Scroll 
        TChart1.Aspect.Chart3DPercent = e.NewValue 
End Sub 

選項在禁用時啟用Windows Native 3D模式，允許用戶旋轉，提升和偏移圖表。“縮放”選項允許前移或移開整個圖表。數據系列圖表內部的縮放在運行時仍然可用。

Perspective屬性允許設置距離透視圖。Perpsective為用于演示目的的圖表提供了視覺增強功能。