asposecells.api

Encapsulates the object that represents a range of cells within a spreadsheet.
The Range class denotes a region of Excel spreadsheet. With this, you can format and set value of the range. And you can simply copy range of Excel too.

Property Getters/Setters Summary
methodgetAddress()
Gets address of the range.
methodgetColumnCount()
Gets the count of columns in the range.
methodgetColumnWidth()
method
           Sets or gets the column width of this range
methodgetCurrentRegion()
Returns a Range object that represents the current region. The current region is a range bounded by any combination of blank rows and blank columns.
methodgetEntireColumn()
Gets a Range object that represents the entire column (or columns) that contains the specified range.
methodgetEntireRow()
Gets a Range object that represents the entire row (or rows) that contains the specified range.
methodgetFirstColumn()
Gets the index of the first column of the range.
methodgetFirstRow()
Gets the index of the first row of the range.
methodgetHeight()
Gets the width of a range in points.
methodgetHyperlinks()
Gets all hyperlink in the range.
methodgetLeft()
Gets the distance, in points, from the left edge of column A to the left edge of the range.
methodgetName()
method
setName(value)
           Gets or sets the name of the range.
methodgetRefersTo()
Gets the range's refers to.
methodgetRowCount()
Gets the count of rows in the range.
methodgetRowHeight()
method
           Sets or gets the height of rows in this range
methodgetTop()
Gets the distance, in points, from the top edge of row 1 to the top edge of the range.
methodgetValue()
method
setValue(value)
           Gets and sets the value of the range.
methodgetWidth()
Gets the width of a range in points.
methodgetWorksheet()
Gets the Worksheetobject which contains this range.
methodget(rowOffset, columnOffset)
Gets Cell object in this range.
 
Method Summary
methodaddHyperlink(address, textToDisplay, screenTip)
Adds a hyperlink to a specified cell or a range of cells.
methodapplyStyle(style, flag)
Applies formats for a whole range.
methodautoFill(target)
Automaticall fill the target range.
methodautoFill(target, autoFillType)
Automaticall fill the target range.
methodcopy(range)
Copies data (including formulas), formatting, drawing objects etc. from a source range.
methodcopy(range, options)
Copying the range with paste special options.
methodcopyData(range)
Copies cell data (including formulas) from a source range.
methodcopyStyle(range)
Copies style settings from a source range.
methodcopyValue(range)
Copies cell value from a source range.
methodgetCellOrNull(rowOffset, columnOffset)
Gets Cell object or null in this range.
methodgetOffset(rowOffset, columnOffset)
Gets Range range by offset.
methodintersect(range)
Returns a Range object that represents the rectangular intersection of two ranges.
methodisBlank()
Indicates whether the range contains values.
methodisIntersect(range)
Indicates whether the range is intersect.
methoditerator()
Gets the enumerator for cells in this Range.
methodmerge()
Combines a range of cells into a single cell.
methodmoveTo(destRow, destColumn)
Move the current range to the dest range.
methodputValue(stringValue, isConverted, setStyle)
Puts a value into the range, if appropriate the value will be converted to other data type and cell's number format will be reset.
methodsetInsideBorders(borderEdge, lineStyle, borderColor)
Set inside borders of the range.
methodsetOutlineBorder(borderEdge, borderStyle, borderColor)
Sets outline border around a range of cells.
methodsetOutlineBorder(borderEdge, borderStyle, borderColor)
Sets outline border around a range of cells.
methodsetOutlineBorders(borderStyle, borderColor)
Sets the outline borders around a range of cells with same border style and color.
methodsetOutlineBorders(borderStyle, borderColor)
Sets the outline borders around a range of cells with same border style and color.
methodsetOutlineBorders(borderStyles, borderColors)
Sets out line borders around a range of cells.
methodsetStyle(style)
Sets the style of the range.
methodsetStyle(style, explicitFlag)
Apply the cell style.
methodtoString()
Returns a string represents the current Range object.
methodunion(range)
Returns the union of two ranges.
methodunionRang(range)
Returns the union result of two ranges.
methodunMerge()
Unmerges merged cells of this range.
 

    • Property Getters/Setters Detail

      • getCurrentRegion : Range 

        Range getCurrentRegion()
        
        Returns a Range object that represents the current region. The current region is a range bounded by any combination of blank rows and blank columns.
      • getHyperlinks : Hyperlink[] 

        Hyperlink[] getHyperlinks()
        
        Gets all hyperlink in the range.
      • getRowCount : int 

        int getRowCount()
        
        Gets the count of rows in the range.
      • getColumnCount : int 

        int getColumnCount()
        
        Gets the count of columns in the range.
      • getName/setName : String 

        String getName() / setName(value)
        
        Gets or sets the name of the range. Named range is supported. For example,

        range.Name = "Sheet1!MyRange";

      • getRefersTo : String 

        String getRefersTo()
        
        Gets the range's refers to.
      • getAddress : String 

        String getAddress()
        
        Gets address of the range.
      • getLeft : float 

        float getLeft()
        
        Gets the distance, in points, from the left edge of column A to the left edge of the range.
      • getTop : float 

        float getTop()
        
        Gets the distance, in points, from the top edge of row 1 to the top edge of the range.
      • getWidth : float 

        float getWidth()
        
        Gets the width of a range in points.
      • getHeight : float 

        float getHeight()
        
        Gets the width of a range in points.
      • getFirstRow : int 

        int getFirstRow()
        
        Gets the index of the first row of the range.
      • getFirstColumn : int 

        int getFirstColumn()
        
        Gets the index of the first column of the range.
      • getValue/setValue : Object 

        Object getValue() / setValue(value)
        
        Gets and sets the value of the range. If the range contains multiple cells, the returned/applied object should be Object[][].
      • getColumnWidth/setColumnWidth : float 

        float getColumnWidth() / setColumnWidth(value)
        
        Sets or gets the column width of this range
      • getRowHeight/setRowHeight : float 

        float getRowHeight() / setRowHeight(value)
        
        Sets or gets the height of rows in this range
      • getEntireColumn : Range 

        Range getEntireColumn()
        
        Gets a Range object that represents the entire column (or columns) that contains the specified range.
      • getEntireRow : Range 

        Range getEntireRow()
        
        Gets a Range object that represents the entire row (or rows) that contains the specified range.
      • getWorksheet : Worksheet 

        Worksheet getWorksheet()
        
        Gets the Worksheetobject which contains this range.
      • get : Cell 

        Cell get(rowOffset, columnOffset)
        
        Gets Cell object in this range.
        Parameters:
        rowOffset - Row offset in this range, zero based.
        columnOffset - Column offset in this range, zero based.
        Returns:
        Cell object.
    • Method Detail

      • autoFill

         autoFill(target)
        Automaticall fill the target range.
        Parameters:
        target: Range - the target range.
      • autoFill

         autoFill(target, autoFillType)
        Automaticall fill the target range.
        Parameters:
        target: Range - The targed range.
        autoFillType: int - A AutoFillType value. The auto fill type.
      • addHyperlink

        Hyperlink addHyperlink(address, textToDisplay, screenTip)
        Adds a hyperlink to a specified cell or a range of cells.
        Parameters:
        address: String - Address of the hyperlink.
        textToDisplay: String - The text to be displayed for the specified hyperlink.
        screenTip: String - The screenTip text for the specified hyperlink.
        Returns:
        Hyperlink object.
      • iterator

        Iterator iterator()
        Gets the enumerator for cells in this Range. When traversing elements by the returned Enumerator, the cells collection should not be modified(such as operations that will cause new Cell/Row be instantiated or existing Cell/Row be deleted). Otherwise the enumerator may not be able to traverse all cells correctly(some elements may be traversed repeatedly or skipped).
        Returns:
        The cells enumerator
      • isIntersect

        boolean isIntersect(range)
        Indicates whether the range is intersect. If the two ranges area not in the same worksheet ,return false.
        Parameters:
        range: Range - The range.
        Returns:
        Whether the range is intersect.
      • intersect

        Range intersect(range)
        Returns a Range object that represents the rectangular intersection of two ranges. If the two ranges are not intersected, returns null.
        Parameters:
        range: Range - The intersecting range.
        Returns:
        Returns a Range object
      • unionRang

        Range[] unionRang(range)
        Returns the union result of two ranges.
        Parameters:
        range: Range - The range
        Returns:
        The union of two ranges.
      • union

        ArrayList union(range)
        Returns the union of two ranges. NOTE: This method is now obsolete. Instead, please use Range.UnionRang() method. This method will be removed 12 months later since November 2023. Aspose apologizes for any inconvenience you may have experienced.
        Parameters:
        range: Range - The range
        Returns:
        The union of two ranges.
      • isBlank

        boolean isBlank()
        Indicates whether the range contains values.
        Returns:
      • merge

         merge()
        Combines a range of cells into a single cell. Reference the merged cell via the address of the upper-left cell in the range.
      • unMerge

         unMerge()
        Unmerges merged cells of this range.
      • putValue

         putValue(stringValue, isConverted, setStyle)
        Puts a value into the range, if appropriate the value will be converted to other data type and cell's number format will be reset.
        Parameters:
        stringValue: String - Input value
        isConverted: boolean - True: converted to other data type if appropriate.
        setStyle: boolean - True: set the number format to cell's style when converting to other data type
      • setStyle

         setStyle(style, explicitFlag)
        Apply the cell style.
        Parameters:
        style: Style - The cell style.
        explicitFlag: boolean - True, only overwriting formatting which is explicitly set.
      • applyStyle

         applyStyle(style, flag)
        Applies formats for a whole range. Each cell in this range will contains a Style object. So this is a memory-consuming method. Please use it carefully.
        Parameters:
        style: Style - The style object which will be applied.
        flag: StyleFlag - Flags which indicates applied formatting properties.
      • setStyle

         setStyle(style)
        Sets the style of the range.
        Parameters:
        style: Style - The Style object.
      • setOutlineBorders

         setOutlineBorders(borderStyle, borderColor)
        Sets the outline borders around a range of cells with same border style and color.
        Parameters:
        borderStyle: int - A CellBorderType value. Border style.
        borderColor: CellsColor - Border color.
      • setOutlineBorders

         setOutlineBorders(borderStyle, borderColor)
        Sets the outline borders around a range of cells with same border style and color.
        Parameters:
        borderStyle: int - A CellBorderType value. Border style.
        borderColor: Color - Border color.
      • setOutlineBorders

         setOutlineBorders(borderStyles, borderColors)
        Sets out line borders around a range of cells. Both the length of borderStyles and borderStyles must be 4. The order of borderStyles and borderStyles must be top,bottom,left,right
        Parameters:
        borderStyles: Number Array - Border styles.
        borderColors: Color[] - Border colors.
      • setOutlineBorder

         setOutlineBorder(borderEdge, borderStyle, borderColor)
        Sets outline border around a range of cells.
        Parameters:
        borderEdge: int - A BorderType value. Border edge.
        borderStyle: int - A CellBorderType value. Border style.
        borderColor: CellsColor - Border color.
      • setOutlineBorder

         setOutlineBorder(borderEdge, borderStyle, borderColor)
        Sets outline border around a range of cells.
        Parameters:
        borderEdge: int - A BorderType value. Border edge.
        borderStyle: int - A CellBorderType value. Border style.
        borderColor: Color - Border color.
      • setInsideBorders

         setInsideBorders(borderEdge, lineStyle, borderColor)
        Set inside borders of the range.
        Parameters:
        borderEdge: int - A BorderType value. Inside borde type, only can be BorderType.VERTICAL and BorderType.HORIZONTAL.
        lineStyle: int - A CellBorderType value. The border style.
        borderColor: CellsColor - The color of the border.
      • moveTo

         moveTo(destRow, destColumn)
        Move the current range to the dest range.
        Parameters:
        destRow: int - The start row of the dest range.
        destColumn: int - The start column of the dest range.
      • copyData

         copyData(range)
        Copies cell data (including formulas) from a source range.
        Parameters:
        range: Range - Source Range object.
      • copyValue

         copyValue(range)
        Copies cell value from a source range.
        Parameters:
        range: Range - Source Range object.
      • copyStyle

         copyStyle(range)
        Copies style settings from a source range.
        Parameters:
        range: Range - Source Range object.
      • copy

         copy(range, options)
        Copying the range with paste special options.
        Parameters:
        range: Range - The source range.
        options: PasteOptions - The paste special options.
      • copy

         copy(range)
        Copies data (including formulas), formatting, drawing objects etc. from a source range.
        Parameters:
        range: Range - Source Range object.
      • getCellOrNull

        Cell getCellOrNull(rowOffset, columnOffset)
        Gets Cell object or null in this range.
        Parameters:
        rowOffset: int - Row offset in this range, zero based.
        columnOffset: int - Column offset in this range, zero based.
        Returns:
        Cell object.
      • getOffset

        Range getOffset(rowOffset, columnOffset)
        Gets Range range by offset.
        Parameters:
        rowOffset: int - Row offset in this range, zero based.
        columnOffset: int - Column offset in this range, zero based.
        Returns:
      • toString

        String toString()
        Returns a string represents the current Range object.
        Returns: