程序包 com.grapecity.documents.excel.drawing

接口 IChart

public interface IChart
表示工作表中的图表对象。

  • 方法详细资料

    • getName

      String getName()
      返回对象的名称。

    • getParent

      IShape getParent()
      返回图表的父级 IShape。

    • getChartType

      ChartType getChartType()
      返回图表类型。

    • setChartType

      void setChartType(ChartType value)
      设置图表类型。

    • getSeriesCollection

      ISeriesCollection getSeriesCollection()
      返回一个表示图表中所有系列集合的对象。

    • getAxes

      IAxes getAxes()
      返回一个代表图表上坐标轴集合的对象。

    • getChartArea

      IChartArea getChartArea()
      返回代表图表完整图表区域的IChartArea对象。

    • getChartTitle

      IChartTitle getChartTitle()
      返回代表指定图表标题的 IChartTitle 对象。

    • getPlotArea

      IPlotArea getPlotArea()
      返回代表图表绘图区域的IPlotArea对象。

    • getLegend

      ILegend getLegend()
      返回代表图表图例的ILegend对象。

    • getDataTable

      IDataTable getDataTable()
      返回表示图表数据表的IDataTable对象。

    • getFloor

      IFloor getFloor()
      返回代表3-D图表楼层的IFloor对象。

    • getWalls

      IWall getWalls()
      返回表示3-D图表墙壁的IWall对象。

    • getSideWall

      IWall getSideWall()
      返回允许用户单独格式化三维图表侧壁的 IWall 对象。

    • getBackWall

      IWall getBackWall()
      返回允许用户单独格式化三维图表后墙的 IWall 对象。

    • getAutoScaling

      boolean getAutoScaling()
      获取缩放设置（如果设置为True，将缩放3-D图表的大小，使其与等效的2-D图表更接近。此时必须将RightAngleAxes属性设置为True）。

    • setAutoScaling

      void setAutoScaling(boolean value)
      设置缩放（若为True，则将3-D图表按比例缩小以接近相应的2-D图表大小。此时必须将RightAngleAxes属性设置为True）。

    • getBarShape

      BarShape getBarShape()
      返回与3-D条形图或柱形图一起使用的形状。

    • setBarShape

      void setBarShape(BarShape value)
      设置与3-D条形图或柱状图一起使用的形状。

    • getPlotVisibleOnly

      boolean getPlotVisibleOnly()
      获取是否只绘制可见单元格。如果仅绘制可见单元格，则为True。如果同时绘制可见和隐藏单元格，则为False。

    • setPlotVisibleOnly

      void setPlotVisibleOnly(boolean value)
      设置是否仅绘制可见单元格。如果为true，则只绘制可见单元格。如果为false，则同时绘制可见和隐藏的单元格。

    • getDisplayNaAsBlank

      boolean getDisplayNaAsBlank()
      获取是否将#N/A显示为空单元格。如果为true，则#N/A会显示为空单元格。

    • setDisplayNaAsBlank

      void setDisplayNaAsBlank(boolean value)
      设置是否将 #N/A 显示为空单元格。如果为 true，则 #N/A 会显示为空单元格。

    • getDepthPercent

      int getDepthPercent()
      返回三维图表的深度，该深度为图表宽度的百分比（介于20%至2000%之间）。

    • setDepthPercent

      void setDepthPercent(int value)
      设置三维图表的深度，作为图表宽度的百分比（介于20%至2000%之间）。

    • getDisplayBlanksAs

      DisplayBlanksAs getDisplayBlanksAs()
      返回图表上空白单元格的绘制方式。可以是以下之一：DisplayBlanksAs 常量：NotPlotted（不绘制）、Interpolated（插值）或 Zero（零）。

    • setDisplayBlanksAs

      void setDisplayBlanksAs(DisplayBlanksAs value)
      设置图表上空白单元格的绘制方式。可以是以下之一：DisplayBlanksAs 常量：NotPlotted（不绘制）、Interpolated（插值）或 Zero（零）。

    • getElevation

      double getElevation()
      返回三维图表视图的仰角（以度为单位）。

    • setElevation

      void setElevation(double value)
      设置三维图表视图的高度（以度为单位）。

    • getGapDepth

      int getGapDepth()
      返回三维图表中数据系列之间的距离占标记宽度的百分比。此属性值必须在0到500之间。

    • setGapDepth

      void setGapDepth(int value)
      设置三维图表中数据系列之间的距离，该距离以标记宽度的百分比表示。此属性的值必须在0到500之间。

    • getHasLegend

      boolean getHasLegend()
      获取图表是否具有图例。

    • setHasLegend

      void setHasLegend(boolean value)
      设置图表是否具有图例。

    • getHasDataTable

      boolean getHasDataTable()
      获取一个值，表示图表是否显示数据表。

    • setHasDataTable

      void setHasDataTable(boolean value)
      设置一个值，表示图表是否显示数据表。

    • getHasTitle

      boolean getHasTitle()
      获取坐标轴或图表是否具有可见标题。

    • setHasTitle

      void setHasTitle(boolean value)
      设置轴或图表是否具有可见标题。

    • getHeightPercent

      int getHeightPercent()
      返回三维图表的高度，以图表宽度的百分比表示（介于5%到500%之间）。

    • setHeightPercent

      void setHeightPercent(int value)
      设置三维图表的高度，以图表宽度的百分比表示（介于5%到500%之间）。

    • getPerspective

      int getPerspective()
      返回三维图表视图的透视角度。该值必须在0到100之间。如果RightAngleAxes 属性为 True，则此属性将被忽略。

    • setPerspective

      void setPerspective(int value)
      设置3-D图表视图的透视角度。该值必须在0到100之间。如果RightAngleAxes属性为True，则此属性将被忽略。

    • getRightAngleAxes

      boolean getRightAngleAxes()
      获取图表坐标轴是否垂直，与图表的旋转或仰角无关。仅适用于三维线形图、柱状图和条形图。

    • setRightAngleAxes

      void setRightAngleAxes(boolean value)
      设置图表坐标轴是否垂直相交，独立于图表的旋转或仰角。仅适用于三维线形图、柱状图和条形图。

    • getRotation

      double getRotation()
      返回三维图表视图的旋转角度（即绘图区域围绕z轴旋转的角度，以度为单位）。此属性的值必须介于0到360之间，但对于三维条形图，该值必须介于0到44之间。默认值为20。仅适用于三维图表。

    • setRotation

      void setRotation(double value)
      设置三维图表视图的旋转角度（即绘图区域围绕z轴旋转的角度，以度为单位）。此属性的值必须介于0到360之间，但对于三维条形图，该值必须介于0到44之间。默认值为20。仅适用于三维图表。

    • getShowDataLabelsOverMaximum

      boolean getShowDataLabelsOverMaximum()
      获取当值大于值轴上的最大值时是否显示数据标签。

    • setShowDataLabelsOverMaximum

      void setShowDataLabelsOverMaximum(boolean value)
      设置当数值大于值轴上的最大值时是否显示数据标签。

    • getShapes

      List<IShape> getShapes()
      返回此图表中的所有绘图形状。

    • getPivotTable

      IPivotTable getPivotTable()
      返回表示包含指定范围左上角的thePivotTable报告的IPivotTable对象，或者与PivotChart报告关联的PivotTable报告。

    • getPivotOptions

      IPivotOptions getPivotOptions()
      返回表示是否显示枢轴图表按钮选项的IPivotOptions对象。

    • getArea3DGroup

      IChartGroup getArea3DGroup()
      返回表示三维图表上的面积图表组的IChartGroup对象。

    • getBar3DGroup

      IChartGroup getBar3DGroup()
      返回代表三维图表上的条形图组的IChartGroup对象。

    • getColumn3DGroup

      IChartGroup getColumn3DGroup()
      返回代表三维图表中的柱状图组的IChartGroup对象。

    • getLine3DGroup

      IChartGroup getLine3DGroup()
      返回代表三维图表上线形图组的IChartGroup对象。

    • getPie3DGroup

      IChartGroup getPie3DGroup()
      返回代表三维图表上的饼图组的IChartGroup对象。

    • getSurfaceGroup

      IChartGroup getSurfaceGroup()
      返回代表三维图表的表面图表组的IChartGroup对象。

    • getAreaGroups

      IChartGroups getAreaGroups()
      返回一个代表二维图表上区域图组集合的对象 IChartGroups。

    • getBarGroups

      IChartGroups getBarGroups()
      返回一个表示二维图表上的柱状图组集合的对象 IChartGroups。

    • getColumnGroups

      IChartGroups getColumnGroups()
      返回一个代表二维图表上的列图表组集合的对象 IChartGroups。

    • getDoughnutGroups

      IChartGroups getDoughnutGroups()
      返回一个表示2D图表上的甜甜圈图组集合的对象 IChartGroups。

    • getLineGroups

      IChartGroups getLineGroups()
      返回一个代表二维图表上的折线图组集合的对象 IChartGroups。

    • getPieGroups

      IChartGroups getPieGroups()
      返回一个代表2D图表上的饼图组集合的对象 IChartGroups。

    • getRadarGroups

      IChartGroups getRadarGroups()
      返回一个代表二维图表上的雷达图组集合的对象IChartGroups。

    • getXYGroups

      IChartGroups getXYGroups()
      返回一个表示2D图表上散点图组集合的对象IChartGroups。

    • getChartGroups

      IChartGroups getChartGroups()
      返回一个代表图表中所有图表组集合的对象 IChartGroups。返回的集合包括每种类型的组。

    • addShape

      IShape addShape(AutoShapeType type, double left, double top, double width, double height)
      返回代表图表中新建自动形状的IShape对象。
      参数:
      type - 指定要创建的自动形状的类型。
      left - 自动形状边框边界距离图表区域左边缘的距离，以点为单位。
      top - 自动形状边框边界距离图表区域上边缘的距离，以点为单位。
      width - 自动形状边框的宽度，以点为单位。
      height - 自动形状边框的高度，以点为单位。
      返回:
      IShape对象。

    • addChart

      IShape addChart(ChartType chartType, double left, double top, double width, double height)
      在图表的指定位置创建一个图表。
      参数:
      chartType - 图表类型
      left - 图表左边缘到图表区域左边缘的距离，以点为单位。
      top - 图表顶部边缘到图表区域顶部边缘的距离，以点为单位。
      width - 对象的宽度，以点为单位
      height - 对象的高度，以点为单位
      返回:
      IShape 对象。

    • addConnector

      IShape addConnector(ConnectorType type, double beginX, double beginY, double endX, double endY)
      创建一个连接器。返回代表新连接器的IShape对象。
      参数:
      type - 要添加的连接器类型。
      beginX - 连接器起始点相对于图表区域左上角的水平位置，以点为单位。
      beginY - 连接器起始点相对于图表区域左上角的垂直位置，以点为单位。
      endX - 连接器终点相对于图表区域左上角的水平位置，以点为单位。
      endY - 连接器终点相对于图表区域左上角的垂直位置，以点为单位。
      返回:
      IShape对象。

    • addPicture

      IShape addPicture(String filename, double left, double top, double width, double height) throws IOException
      从现有文件创建一张图片。返回代表新图片的IShape对象。
      参数:
      filename - 要从中创建对象的文件。
      left - 图片左边缘到图表区域左边缘的距离，以点为单位。
      top - 图片上边缘到图表区域上边缘的距离，以点为单位。
      width - 图片的宽度，以点为单位。
      height - 图片的高度，以点为单位。
      返回:
      IShape对象。
      抛出:
      IOException

    • addPicture

      IShape addPicture(InputStream stream, ImageType type, double left, double top, double width, double height) throws IOException
      从现有流创建一张图片。返回代表新图片的IShape对象。
      参数:
      stream - 要从中创建对象的流。
      type - 指定要创建的图片类型。
      left - 图片左边缘到图表区域左边缘的距离，以点为单位。
      top - 图片顶部边缘到图表区域顶部边缘的距离，以点为单位。
      width - 图片的宽度，以点为单位。
      height - 图片的高度，以点为单位。
      返回:
      IShape对象。
      抛出:
      IOException

    • addShapeInPixel

      IShape addShapeInPixel(AutoShapeType type, double left, double top, double width, double height)
      返回代表图表中新建自动形状的IShape对象。
      参数:
      type - 指定要创建的自动形状的类型。
      left - AutoShape边界框左边缘到图表区域左边缘的距离，以像素为单位。
      top - AutoShape边界框上边缘到图表区域上边缘的距离，以像素为单位。
      width - AutoShape边界框的宽度，以像素为单位。
      height - AutoShape边界框的高度，以像素为单位。
      返回:
      IShape对象。

    • addChartInPixel

      IShape addChartInPixel(ChartType chartType, double left, double top, double width, double height)
      在图表的指定位置创建一个图表。
      参数:
      chartType - 图表类型
      left - 图表左边缘到图表区域左边缘的距离，以像素为单位。
      top - 图表顶部边缘到图表区域顶部边缘的距离，以像素为单位。
      width - 对象的宽度，以像素为单位
      height - 对象的高度，以像素为单位
      返回:
      IShape 对象。

    • addConnectorInPixel

      IShape addConnectorInPixel(ConnectorType type, double beginX, double beginY, double endX, double endY)
      创建一个连接器。返回代表新连接器的IShape对象。
      参数:
      type - 要添加的连接器类型。
      beginX - 连接器起点的水平位置相对于图表区域左上角的像素值。
      beginY - 连接器起点的垂直位置相对于图表区域左上角的像素值。
      endX - 连接器终点的水平位置相对于图表区域左上角的像素值。
      endY - 连接器终点的垂直位置相对于图表区域左上角的像素值。
      返回:
      IShape对象。

    • addPictureInPixel

      IShape addPictureInPixel(String filename, double left, double top, double width, double height) throws IOException
      从现有文件创建一张图片。返回代表新图片的IShape对象。
      参数:
      filename - 要从中创建对象的文件。
      left - 图片左边缘到图表区域左边缘的距离，以像素为单位。
      top - 图片顶部边缘到图表区域顶部边缘的距离，以像素为单位。
      width - 图片的宽度，以像素为单位。
      height - 图片的高度，以像素为单位。
      返回:
      IShape对象。
      抛出:
      IOException

    • addPictureInPixel

      IShape addPictureInPixel(InputStream stream, ImageType type, double left, double top, double width, double height) throws IOException
      从现有流创建一张图片。返回代表新图片的IShape对象。
      参数:
      stream - 要从中创建对象的流。
      type - 指定要创建的图片类型。
      left - 图片左边缘到图表区域左边缘的距离，以像素为单位。
      top - 图片顶部边缘到图表区域顶部边缘的距离，以像素为单位。
      width - 图片的宽度，以像素为单位。
      height - 图片的高度，以像素为单位。
      返回:
      IShape对象。
      抛出:
      IOException

    • setSourceData

      void setSourceData(IRange source, RowCol plotBy)
      设置图表的源数据范围。
      参数:
      source - 包含源数据的范围。
      plotBy - 指定数据绘制的方式。可以是以下 RowCol 常量之一：列或行。

    • setSourceData

      void setSourceData(IRange source)
      设置图表的数据源范围。
      参数:
      source - 包含源数据的范围。

    • delete

      void delete()
      删除该对象。