【TeeChart for Java教程】（二）图表显示方法（上）

【下载TeeChart for Java最新版本】

图表显示功能是影响图表整体外观的功能，它们包括定义图表背景颜色的属性和方法，标题及其位置，边距，边框和斜面，背景图像，框架和轴可见，笔颜色和宽度，3D，walls等，所有这些方法都可以在运行时通过代码获得，整体图表外观特征分为以下类别：

• General
• Axis
• Titles
• Legend
• Panel
• Paging
• Walls
• 3D

其中一些元素会影响图表的“外观”，这些包括系列颜色和标记特征，单独的轴和 格显示方法和标签。

（一）General

常规选项包括打印预览和图表导出以及以下3个部分：Margins边距（％）、Zoom缩放、Scroll滚动。

1.1 Margins

边距定义为图表边框与图表框架之间的距离，并表示为图表面板总体尺寸的百分比，相关的运行时方法是：

chart.getPanel().setMarginBottom();chart.getPanel().setMarginLeft();chart.getPanel().setMarginRight();chart.getPanel().setMarginTop();

（二）Axis

轴的控制是其最高复杂程度的一个相关领域，在后来的Axis Control专用教程中有更深入的处理。在这里，我们将介绍Axis和Frame显示的基础知识，图表中有5个主轴。左，上，右，下和深。图表框显示为图表可绘制区域的环绕，并且没有数据对应的功能。默认情况下，Depth初始化为不可见。从系列添加到图表并与这些轴关联的那一刻（默认为左和底），所有其他轴都可见。可以通过代码添加/删除自定义轴。要使自定义轴可见（与任何其他轴一样），系列必须与轴关联，启用轴和框架显示的关键方法是：

2.1 Visible

此复选框启用或禁用所有轴的显示，如果后墙框架可见，则隐藏轴时图表环绕仍然可见。结果将是更大的图表的外观，因为没有为轴标签保留区域。每个轴的Visible方法（Scales选项卡）会覆盖每个Axis的可见特征。如果在列表中选择深度轴，则会注意到Depth Axis Scales :: Visible默认为“不可见”，运行

chart.getAxes().setVisible(true);

2.2 Axis: Left, Right, Top, Bottom and Depth Visible

选择要在列表框中显示或隐藏的轴，并在“Scales”选项卡上切换“Visible”复选框以控制该特定轴的显示，运行

chart.getAxes().getLeft().setVisible(false);

（三）Titles

标题方法控制图表标题的特征：页眉和页脚，运行：Chart Header Text是一个String数组，在标题中添加几行：

chart.getHeader().setLines(new String[] {"Welcome to","TeeChart","for Android"});

修改文本行：

chart.getHeader().getLines()[0]="my Chart Title";

或者，设置一行标题的一行：

chart.getChart().getHeader().setText("Title revised");

3.1 样式对齐

对齐是指与图表区域相对的页眉（或页脚）对齐而不是整个图表面板，图表区域是图表加上轴标签和图例的可绘图区域，运行：

chart.getChart().getHeader().setAlignment(StringAlignment.CENTER);

3.2 Position

使用位置覆盖页眉或页脚默认位置并设置自定义位置（与图表顶部，左侧的像素关系），运行：

chart.getChart().getHeader().setCustomPosition(true);chart.getChart().getHeader().setTop(30);

3.3 Format

包含标题框的设置，例如框架，背景颜色等。例如，用透明度填充颜色，设置要在文本后面显示的颜色并改变填充的透明度；例如：默认为“清除”。选定的图案将位于文本后面，运行：

chart.getHeader().setText("Line Series");chart.getHeader().getFont().setSize(14);chart.getHeader().setTransparent(false);chart.getHeader().getBrush().setColor(Color.YELLOW);chart.getHeader().setTransparency(50);

3.4 Text

包含标题文本外观格式特征，例如字体：

chart.getFooter().getFont().setName("Times New Roman");chart.getFooter().getFont().setBold(true);

Outline指的是页眉或页脚的框架，默认情况下，它设置为Visible off，Outline选项源自TChartPen。

3.5 Gradient

在“Title”框中启用/禁用“Background Gradient背景渐变”，并设置开始和结束颜色。

chart.getHeader().getGradient().setVisible(true);chart.getHeader().getGradient().setStartColor(Color.YELLOW);chart.getHeader().getGradient().setEndColor(Color.WHITE_SMOKE);

（四）Legend

4.1 Style

切换开/关图例显示和设置图例显示内容特征（包括复选框等），运行：使用复选框控制图例显示的示例。

chart.getLegend().setVisible(jCheckBox2.isSelected());

用于在图例条目之间的图例框中绘制线条，TChartPen方法适用，运行：

chart.getLegend().getDividingLines().setVisible(true);chart.getLegend().getDividingLines().setColor(Color.Blue);

4.2 Position

设置默认显示位置或启用图例的自定义位置，TChart将改变图例的形状以适合该位置，如果图例设置为图表的侧面（左侧或右侧），默认情况下，图例的内容将从上到下列为列表。如果图例位于图表下方或上方，则图例内容并排放置，可以使用“Resize Chart调整大小图表”选项和/或使用“Custom自定义”定位来覆盖默认行为。

例如ResizeChart：Resize Chart定义图表在绘制时是否为Legend留出空间，这允许图例放置在图表区域内，运行：

chart.getLegend().setResizeChart(true);

定义图表面板顶部的图例框位移，运行：

chart.getLegend().setTopLeftPos(20);

4.3 Symbols

图例符 的大小和格式，定义图例中颜色框的宽度，运行：

chart.getLegend().setColorWidth(40);

4.4 Format

包含标题框的设置，例如框架，背景颜色等，例如阴影方法，用于显示图例框阴影，您可以定义颜色和大小，运行：

chart.getLegend().getShadow().setColor(Color.Yellow);

4.5 Text

图例文本内容的文本特征，运行

chart.getLegend().setColor(Color.blue);chart.getLegend().getFont().setName("Times New Roman");chart.getLegend().getFont().setColor(Color.yellow);

4.6 Gradient

在“Legend”框中启用/禁用“Background Gradient背景渐变”。

标签：JavaScript 图表图表控件teechart