概述 | 软件包 | 类 | 树 | 索引 | 帮助

上一个类 下一个类 | 框架 无框架
摘要： 嵌套 | 字段 | 构造函数 | 方法 | 详细信息： 字段 | 构造函数 | 方法

## application.workbooks.workbook.charts
类 Chart

    java.lang.Object
      application.workbooks.workbook.charts.Chart

    public class Chart

extends java.lang.Object

封装图表的宏，用来获取图表和图表的元素。

方法摘要
`void` | `addChartListener(ChartListener chartListener)` 向Chart注册监听器。
`void` | `addTitle(int titleType, java.lang.String text)` 添加标题。
`void` | `applyChartStyle(int style)` 应用图表样式。
`void` | `applyChartTemplate(java.lang.String templateFileName)` 应用图表模板。
`void` | `floatChartInToCell(int row, int column)` 把当前激活的浮动图表插入到当前工作表指定的单元格中。
`void` | `floatChartInToCell(java.lang.String worksheetName, int row, int column)` 把当前激活的浮动图表插入到指定工作表指定的单元格中。
`java.lang.String` | `getBottomLocation()` 获得图表右下角的位置，如"G7"
`int` | `getChartSubType()` 取得图表次类型。
`FillAttribute` | `getFillAttribute()` 取得图表区域的填充属性。
`FontAttribute` | `getFontAttribute()` 获取字体属性。
`application.workbooks.workbook.charts.chart.LineAttribute` | `getLineAttribute()` 获取边框属性。
`int` | `getMainType()` 获得图表的主类型。
`Shapes` | `getShapes()` 获得自选图形管理器对象。
`java.lang.String` | `getSourceData()` 获得图表数据源。
`java.lang.String` | `getTopLocation()` 获得图表左上角的位置，如"B3"
`boolean` | `hasCorner()` 获取圆角属性。
`boolean` | `hasShadow()` 获取阴影属性。
`boolean` | `isLegendVisible()` 图例对象是否显示。
`boolean` | `isSelected()` 图表的选取状态。
`boolean` | `isSeriesByRow()` 获得图表系列是按行还是按列生成。
`boolean` | `isTableAreaVisible()` 数据表对象是否显示。
`void` | `removeChartListener(ChartListener chartListener)` 从Chart中移除监听器。
`void` | `saveAsTemplate(java.lang.String filename)` 另存为图表模板。
`void` | `setChartBarType(int typeIndex)` 图表工具条上选取图表类型。
`void` | `setChartLocationAsSheet(java.lang.String sheetName)` 将图表生成指定的工作表。
`void` | `setChartLocationInCell(java.lang.String sheetName, int row, int column)` 将图表插入到指定的单元格中。
`void` | `setChartLocationInSheet(java.lang.String sheetName)` 将图表放到指定的工作表上面。
`void` | `setChartType(int type, int subType)` 设置图表的类型。
`void` | `setFillAttribute(FillAttribute fillAttr)` 设置填充属性。
`void` | `setFontAttribute(FontAttribute fontAttribute)` 设置字体属性。
`void` | `setHasCorner(boolean hasCorner)` 设置图表是否有圆角效果。
`void` | `setHasShadow(boolean hasShadow)` 设置是否有阴影。
`void` | `setLineAttribute(application.workbooks.workbook.charts.chart.LineAttribute lineAttr)` 设置边框属性。
`void` | `setSelected(boolean isSelected)` 设置图表的选取状态。
`void` | `setSeriesByRow(boolean isRow)` 设置图表系列是按行或按列生成。
`void` | `setSourceData(java.lang.String rangeSource, boolean flag)` 设置图表数据源。
`void` | `setTableAreaVisible(boolean isShow)` 图表工具条是否显示数据表。
`void` | `showLegend(boolean isShow)` 是否显示图例。

从类 java.lang.Object 继承的方法
`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

方法详细信息

### addChartListener

    public void addChartListener(ChartListener chartListener)

  向Chart注册监听器。

  参数：
    `chartListener` - Chart监听器对象

    例子：

         //插入一张浮动图表，并向其注册事件监听器，当激活图表时弹出"activate"消息对话框。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         ChartListener chartListener = new ChartListener()
         {
                        public void chartChanged(ChartEvent e)
                        {
                                if (e.getType() == e.ACTIVATE)
                                {
                                        JOptionPane.showMessageDialog(null, "activate");
                                }
                        }
         };
         chart.addChartListener(chartListener);

### addTitle

    public void addTitle(int titleType,
                         java.lang.String text)

  添加标题。

  参数：
    `titleType` - 为整型数值
    `text` - 标题名称

               ChartConstants.CHART_TITLE      图表标题
               ChartConstants.X_TITLE          图表X轴标题
               ChartConstants.Y_TITLE          图表Y轴标题
               ChartConstants.XSCALE_TITLE     图表X轴刻度标题
               ChartConstants.YSCALE_TITLE     图表Y轴刻度标题
               ChartConstants.SECOND_Y_TITLE   图表Y次轴刻度标题

    例子：

         //给当前活动图表添加图表标题
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         chart.addTitle(ChartConstants.CHART_TITLE, "chart");

  抛出：
    `MacroRunException` - 当参数的数值越界
    `MacroRunException` - 当标题内容的长度已超出范围(128)
  另请参见：
    `ChartConstants`

### applyChartStyle

    public void applyChartStyle(int style)

  应用图表样式。

  参数：
    `style` - 样式类型索引

    例子：

         //对图表应用类型索引为５的图表样式。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         Chart chart = charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         chart.applyChartStyle(5);

  抛出：
    `MacroRunException` - 当参数越界

### applyChartTemplate

    public void applyChartTemplate(java.lang.String templateFileName)

  应用图表模板。

  参数：
    `templateFileName` - 自定义图表模板名称。取“图表向导--图表模板”中图表的名称，也可以是自定义图表模板的路径。 如指定的图表名称不存在，则抛出异常。

    例子：

         //对图表应用图表模板"D:\\ChartTemplates\\渐蓝饼图.ect"。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         Chart chart = charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         chart.applyChartTemplate("D:\\ChartTemplates\\渐蓝饼图.ect");

  抛出：
    `MacroRunException` - 当参数为空或自定义图表模板名称无效

### floatChartInToCell

    public void floatChartInToCell(int row,
                                   int column)

  把当前激活的浮动图表插入到当前工作表指定的单元格中。

  参数：
    `row` - 指定插入的行
    `column` - 指定插入的列

    例子：

         //把当前活动的浮动图表插入到当前工作表指定的单元格中。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         charts.floatingChartInToCell(15, 7);

### floatChartInToCell

    public void floatChartInToCell(java.lang.String worksheetName,
                                   int row,
                                   int column)

  把当前激活的浮动图表插入到指定工作表指定的单元格中。

  参数：
    `worksheetName` - 指定的工作表名称(若worksheetName为Null,表示当前工作表)
    `row` - 指定插入的行
    `column` - 指定插入的列

    例子：

         //把当前活动的浮动图表插入到工作表2的指定单元格中。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         Chart chart = charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         chart.floatChartInToCell("工作表2", 15, 7);

  抛出：
    `MacroRunException` - 当名称无效

### getBottomLocation

    public java.lang.String getBottomLocation()

  获得图表右下角的位置，如"G7"

  返回：
    图表右下角的位置

    例子：

         //获得图表右下角的位置。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Charts charts = book.getCharts();
         Chart chart = charts.getActiveChart();
         System.out.println("图表右下角的位置 :" + chart.getBottomLocation());

### getChartSubType

    public int getChartSubType()

  取得图表次类型。

  返回：
    取得图表次类型

    例子：

         //取得当前活动图表的次类型
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         System.out.println("SubType:" + chart.getChartSubType());

### getFillAttribute

    public FillAttribute getFillAttribute()

  取得图表区域的填充属性。

  返回：
    填充属性

    例子：

         //取得当前活动图表的填充属性。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         FillAttribute fill = chart.getFillAttribute();
         System.out.println("fill:" + fill);

### getFontAttribute

    public FontAttribute getFontAttribute()

  获取字体属性。

  返回：
    字体属性

    例子：

         //取得当前活动图表的字体属性
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         FontAttribute fontAttribute1 = chart.getFontAttribute();
         System.out.println("Bold:" + fontAttribute1.isBold());

### getLineAttribute

    public application.workbooks.workbook.charts.chart.LineAttribute getLineAttribute()

  获取边框属性。

  返回：
    边框属性

    例子：

         //取得当前活动图表的边框属性。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         LineAttribute lineAttr = chart.getLineAttribute();
         lineAttr.setBorderType(ChartConstants.BORDER_CUSTOM);
         lineAttr.setLineStyle(ChartConstants.LINESTYLE_SOLID);
         lineAttr.setColor(255, 0, 0);
         lineAttr.setWidth(ChartConstants.FIRST_WIDTH);
         chart.setLineAttribute(lineAttr);
         chart.refresh();

### getMainType

    public int getMainType()

  获得图表的主类型。

  返回：
    图表的主类型

    例子：

         //取得当前活动图表的主类型
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         System.out.println("ChartType:" + chart.getMainType());

### getShapes

    public Shapes getShapes()

  获得自选图形管理器对象。

  返回：
    自选图形管理器对象

    例子：

         //把当前活动的浮动图表插入到工作表2的指定单元格中。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Charts charts = book.getCharts();
         Chart chart = charts.getActiveChart();
         Shapes shapes = chart.getShapes();

### getSourceData

    public java.lang.String getSourceData()

  获得图表数据源。

  返回：
    图表数据源

    例子：

         //取得当前活动图表的数据源
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         String ranges = chart.getSourceData();
         System.out.println("SourceData:" + ranges);

### getTopLocation

    public java.lang.String getTopLocation()

  获得图表左上角的位置，如"B3"

  返回：
    图表左上角的位置

    例子：

         //获得图表左上角的位置。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Charts charts = book.getCharts();
         Chart chart = charts.getActiveChart();
         System.out.println("图表左上角的位置 :" + chart.getTopLocation());

### hasCorner

    public boolean hasCorner()

  获取圆角属性。

  返回：
    圆角属性，true表示有圆角，false表示无圆角

    例子：

         //取得当前活动图表的圆角属性。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         if(!chart.hasCorner())
         {
             chart.setHasCorner(true);
         }
         chart.refresh();
         System.out.println("hasCorner:" + chart.hasCorner());

### hasShadow

    public boolean hasShadow()

  获取阴影属性。

  返回：
    阴影属性，true表示有阴影，false表示无阴影

    例子：

         //取得当前活动图表的阴影属性
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         if(!chart.hasShadow())
         {
             chart.setHasShadow(true);
         }
         book.getWorksheets().getActiveWorksheet().refresh();
         System.out.println("hasShadow:" + chart.hasShadow());

### isLegendVisible

    public boolean isLegendVisible()

  图例对象是否显示。

  返回：
    图例对象是否显示

    例子：

         //取得当前活动图表的图例对象是否显示。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         System.out.println(chart.isLegendVisible());

### isSelected

    public boolean isSelected()

  图表的选取状态。

  返回：
    isSelected 布尔型值， 若isSelected为true，则表明该轴处于被选取状态；否则不被选取

    例子：

         //取得当前活动图表的选取状态。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         System.out.println("isSelect:" + chart.isSelected());

### isSeriesByRow

    public boolean isSeriesByRow()

  获得图表系列是按行还是按列生成。

  返回：
    TRUE 表示按行生成，FALSE 表示按列生成

    例子：

         //取得当前活动图表的系列是按行还是按列生成
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         System.out.println(chart.isSeriesByRow());

### isTableAreaVisible

    public boolean isTableAreaVisible()

  数据表对象是否显示。

  返回：
    数据表对象是否显示

    例子：

         //取得当前活动图表的数据表对象的可见性
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         if(!chart.isTableAreaVisible())
         {
             chart.setTableAreaVisible(true);
         }
         chart.refresh();
         System.out.println("showTable:" + chart.isTableAreaVisible());

### removeChartListener

    public void removeChartListener(ChartListener chartListener)

  从Chart中移除监听器。

  参数：
    `chartListener` - Chart监听器对象

    例子：

         //插入一张浮动图表，并向其注册事件监听器，当激活图表时弹出"activate"消息对话框，然后移除该事件监听器。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         ChartListener chartListener = new ChartListener()
         {
                        public void chartChanged(ChartEvent e)
                        {
                                if (e.getType() == e.ACTIVATE)
                                {
                                        JOptionPane.showMessageDialog(null, "activate");
                                }
                        }
         }
         chart.addChartListener(chartListener);

### saveAsTemplate

    public void saveAsTemplate(java.lang.String filename)

  另存为图表模板。

  参数：
    `filename` - 带路径文件名

    例子：

         //首先插入一张图表，然后用户设计后运行以下代码，以下代码将把设计好的图表作为模板"a.ect"保存在C盘根目录下
         Workbook workbook = Application.getWorkbooks().getActiveWorkbook();
         Chart chart = workbook.getCharts().getActiveChart();
         chart.saveAsTemplate("C:\\a.ect");

  抛出：
    `MacroRunException` - 当带路径文件名无效

### setChartBarType

    public void setChartBarType(int typeIndex)

  图表工具条上选取图表类型。

  参数：
    `typeIndex` - 图表类型,其取值如下:

                 ChartConstants.BARAREA_STACKED:面积图;
                 ChartConstants.BARAREA_STACKED100:百分比堆积面积图。
                 ChartConstants.BARBAR_ClUSTERED:条形图;
                 ChartConstants.BA3DRBAR_ClUSTERED:三维条形图；
                 ChartConstants.BARCOLUMN_ClUSTERED：柱形图；
                 ChartConstants.BAR3DCOLUMN：三维柱形图；
                 ChartConstants.BAR_RADAR:雷达图；
                 ChartConstants.BAR_BUBBLE:气泡图；
                 ChartConstants.BAR_LINEMARKERS：折线图；
                 ChartConstants.BAR_XYSCATTER：散点图；
                 ChartConstants.BAR_PIE：饼图；
                 ChartConstants.BAR_DOUGHNUT：圆环图

    例子：

         //设置当前活动图表为折线图。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         Chart chart = charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         chart.setChartBarType(ChartConstants.BAR_LINEMARKERS);

  抛出：
    `MacroRunException` - 当参数错误或越界
  另请参见：
    `ChartConstants`

### setChartLocationAsSheet

    public void setChartLocationAsSheet(java.lang.String sheetName)

  将图表生成指定的工作表。

  参数：
    `sheetName` - 指定的工作表名称

    例子：

         //将浮动图表生成图表，图表名称为"图表工作表"。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         Chart chart = charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         chart.setChartLocationAsSheet("图表工作表");

### setChartLocationInCell

    public void setChartLocationInCell(java.lang.String sheetName,
                                       int row,
                                       int column)

  将图表插入到指定的单元格中。

  参数：
    `sheetName` - 指定的工作表名称
    `row` - 指定插入的行(行号从1开始)
    `column` - 指定插入的列(列号从1开始)

    例子：

         //将浮动图表作为工作表单元格中的对象定位到工作表1的(1,1)单元格位置。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         Chart chart = charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         chart.setChartLocationInCell("工作表1", 1, 1);

### setChartLocationInSheet

    public void setChartLocationInSheet(java.lang.String sheetName)

  将图表放到指定的工作表上面。

  参数：
    `sheetName` - 指定的工作表名称

    例子：

         //将浮动图表作为工作表中的对象定位到工作表2。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         Chart chart = charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         chart.setChartLocationInSheet("工作表2");

### setChartType

    public void setChartType(int type,
                             int subType)

  设置图表的类型。

  参数：
    `type` - 图表主类型索引
    `subType` - 图表次类型索引

    例子：

         //设置当前活动图表的类型
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         chart.setChartType(ChartConstants.EMOCHART_BAR, ChartConstants.EMOBAR_STACKED);
         System.out.println("ChartType:" + chart.getMainType());
         System.out.println("SubType:" + chart.getChartSubType());

### setFillAttribute

    public void setFillAttribute(FillAttribute fillAttr)

  设置填充属性。

  参数：
    `fillAttr` - 填充属性

    例子：

         //设置当前活动图表的填充属性。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         FillAttribute fill = chart.getFillAttribute();
         fill.getTextureAttribute().setTextureIndex(2);
         chart.setFillAttribute(fill);

### setFontAttribute

    public void setFontAttribute(FontAttribute fontAttribute)

  设置字体属性。

  参数：
    `fontAttribute` - 字体属性

    例子：

         //设置当前活动图表的字体属性。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         FontAttribute fontAttribute = chart.getFontAttribute();
         fontAttribute.setBold(true);
         chart.setFontAttribute(fontAttribute);
         FontAttribute fontAttribute1 = chart.getFontAttribute();
         System.out.println("Bold:" + fontAttribute1.isBold());

### setHasCorner

    public void setHasCorner(boolean hasCorner)

  设置图表是否有圆角效果。

  参数：
    `hasCorner` - 布尔型值，如为true，给图表设置圆角效果；否则，不设置圆角效果

    例子：

         //设置当前活动图表有圆角效果。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         if(!chart.hasCorner())
         {
             chart.setHasCorner(true);
         }
         System.out.println("hasCorner:" + chart.hasCorner());

### setHasShadow

    public void setHasShadow(boolean hasShadow)

  设置是否有阴影。

  参数：
    `hasShadow` - 阴影标志

    例子：

         //设置当前活动图表有阴影。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         if(!chart.hasShadow())
         {
             chart.setHasShadow(true);
         }
         System.out.println("hasShadow:" + chart.hasShadow());

### setLineAttribute

    public void setLineAttribute(application.workbooks.workbook.charts.chart.LineAttribute lineAttr)

  设置边框属性。

  参数：
    `lineAttr` - 边框属性

    例子：

         //设置当前活动图表的边框属性。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         LineAttribute lineAttr = chart.getLineAttribute();
         lineAttr.setBorderType(ChartConstants.BORDER_CUSTOM);
         lineAttr.setLineStyle(ChartConstants.LINESTYLE_SOLID);
         lineAttr.setColor(255, 0, 0);
         lineAttr.setWidth(ChartConstants.FIRST_WIDTH);
         chart.setLineAttribute(lineAttr);

### setSelected

    public void setSelected(boolean isSelected)

  设置图表的选取状态。

  参数：
    `isSelected` - 布尔型值， 若isSelected为true，则表明该轴处于被选取状态；否则不被选取

    例子：

         //使当前活动图表不被选取。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         if(!chart.isSelected())
         {
             chart.setSelected(false);
         }
         System.out.println("isSelect:" + chart.isSelected());

### setSeriesByRow

    public void setSeriesByRow(boolean isRow)

  设置图表系列是按行或按列生成。

  参数：
    `isRow` - 行列标志 True表示按行,False表示按列

    例子：

         //设置当前活动图表的系列按行生成。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         chart.setSeriesByRow(true);

### setSourceData

    public void setSourceData(java.lang.String rangeSource,
                              boolean flag)

  设置图表数据源。

  参数：
    `rangeSource` - 图表数据源
    `flag` - 布尔型值，按行按列标志，当为true时，按行；当为false时，按列

    例子：

         //设置当前活动图表的数据源。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         chart.setSourceData("='工作表1'!A5:E12", false);
         String ranges = chart.getSourceData();
         System.out.println("SourceData:" + ranges);

  抛出：
    `MacroRunException` - 当给定的区域地址错误或越界

### setTableAreaVisible

    public void setTableAreaVisible(boolean isShow)

  图表工具条是否显示数据表。

  参数：
    `isShow` - 布尔型值，true，显示数据表；false，不显示数据表。

    例子：

         //设置当前活动图表的数据表对象的可见性。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         if(!chart.isTableAreaVisible())
         {
             chart.setTableAreaVisible(true);
         }
         System.out.println("showTable:" + chart.isTableAreaVisible());

### showLegend

    public void showLegend(boolean isShow)

  是否显示图例。

  参数：
    `isShow` - 布尔型值，true，显示图例；false，不显示图例。

    例子：

         //显示当前活动图表的图例对象。
         Workbook book = Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range = sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, sheet.getName());
         Chart chart = charts.getActiveChart();
         chart.showLegend(true);

概述 | 软件包 | 类 | 树 | 索引 | 帮助

上一个类 下一个类 | 框架 无框架
摘要： 嵌套 | 字段 | 构造函数 | 方法 | 详细信息： 字段 | 构造函数 | 方法

版权所有 2001-2008 无锡永中科技有限公司