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

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

## application.workbooks.workbook.charts
类 Chart

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

    public class Chart

extends java.lang.Object

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

方法摘要
`void` | `addTitle(int titleType, java.lang.String text)` 添加标题
`void` | `floatChartInToCell(java.lang.String workSheetName, int row, int column)` 把当前激活的浮动图表插入到指定工作表指定的单元格中.
`int` | `getChartSubType()` 取得图表子类型
`FillAttribute` | `getFillAttribute()` 取得图表区域的填充属性。
`FontAttribute` | `getFontAttribute()` 获取字体属性。
`application.workbooks.workbook.charts.chart.LineAttribute` | `getLineAttribute()` 获取边框属性。
`int` | `getMainType()` 获得图表的主类型。
`java.lang.String` | `getSourceData()` 获得图表数据源。
`boolean` | `hasCorner()` 获取圆角属性。
`boolean` | `hasShadow()` 获取阴影属性。
`boolean` | `isLegendVisible()` 图例对象是否显示.
`boolean` | `isSelected()` 图表的选取状态。
`boolean` | `isSeriesByRow()` 获得图表系列是按行还是按列生成。
`void` | `setChartBarType(int typeIndex)` 图表工具条上选取图表类型。
`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`

方法详细信息

### addTitle

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

  添加标题

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

               ChartConstants.CHART_TITLE
               ChartConstants.X_TITLE
               ChartConstants.Y_TITLE
               ChartConstants.SECOND_Y_TITLE

    `text` - 名称

    例子：

         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_TITLT, "chart");

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

### floatChartInToCell

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

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

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

    例子：

         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.floatChartToCell("工作表2",15,7);

### 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());

### 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);

### 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().getActiveSheet().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()

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

  返回：
    0-无， 1－按行，2－按列

    例子：

         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());

### 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);

  另请参见：
    `ChartConstants`

### setChartType

    public void setChartType(int type,
                             int subType)

  设置图表的类型。

  参数：
    `index` - 图表类型索引
    `subIndex` - 子图表类型索引

    例子：

         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);
         chart.refresh();

  另请参见：
    `ChartConstants`

### 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(true);
         }
         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",1);
         String ranges = chart.getSourceData();
         System.out.println("SourceData:"+ranges);

### setTableAreaVisible

    public void setTableAreaVisible(boolean isShow)

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

  参数：
    `isShow: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.isTableAreaVisible())
         {
           chart.setTableAreaVisible(true);
         }
         System.out.println("showTable:"+chart.isTableAreaVisible());

### showLegend

    public void showLegend(boolean isShow)

  是否显示图例.

  参数：
    `isShow: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();
         chart.showLegend(true);

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

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