com.aspose.cells
Class Cells

java.lang.Object
    com.aspose.cells.Cells

All Implemented Interfaces:

java.lang.Iterable

public class Cells 
extends java.lang.Object

Workbook excel = new Workbook();
Cells cells = excel.getWorksheets().get(0).getCells();

//Set default row height
cells.setStandardHeight(20);
//Set row height
cells.setRowHeight(2, 20.5);

//Set default colum width
cells.setStandardWidth(15);
//Set column width
cells.setColumnWidth(3, 12.57);

//Merge cells
cells.merge(5, 4, 2, 2);

public int getCount()

Gets the number of cells.

public RowCollection getRows()

Gets the collection of Row objects that represents the individual rows in this worksheet.

public java.util.ArrayList getMergedCells()

Gets the collection of merged cells.

In this collection, each item is a CellArea structure which represents an area of merged cells.

public double getStandardWidthInch() / public void setStandardWidthInch(double value)

Gets or sets the default column width in the worksheet,in unit of inches.

public int getStandardWidthPixels() / public void setStandardWidthPixels(int value)

Gets or sets the default column width in the worksheet,in unit of pixels.

public double getStandardWidth() / public void setStandardWidth(double value)

Gets or sets the default column width in the worksheet,in unit of characters.

public double getStandardHeight() / public void setStandardHeight(double value)

Gets or sets the default row height in this worksheet,in unit of points.

public int getStandardHeightPixels() / public void setStandardHeightPixels(int value)

Gets or sets the default row height in this worksheet,in unit of pixels.

public boolean getPreserveString() / public void setPreserveString(boolean value)

Gets or sets a value indicating whether all worksheet values are preserved as strings. Default is false.

public int getMinRow()

Minimum row index of cell which contains data or style.

public int getMinDataRow()

Minimum row index of cell which contains data.

public int getMinDataColumn()

Minimum column index of cell which contains data.

public int getMinColumn()

Minimum column index of cell which contains data or style.

public int getMaxDataRow()

Maximum row index of cell which contains data.

Return -1 if there is no cell which contains data.

public int getMaxRow()

Maximum row index of cell which contains data or style.

Return -1 if there is no cell whiche contains data or style in the worksheet.

public int getMaxDataColumn()

Maximum column index of cell which contains data.

Return -1 if there is not cell which contains data. Don't call this property repeatedly. This property will iterate all cells in a worksheet.

public int getMaxColumn()

Maximum column index of cell which contains data or style.

Return -1 if ther is not cell.

public boolean isDefaultRowHeightMatched() / public void setDefaultRowHeightMatched(boolean value)

Indicates that row height and default font height matches

public ColumnCollection getColumns()

Gets the collection of Column objects that represents the individual columns in this worksheet.

public RangeCollection getRanges()

Gets the collection of Range objects created at run time.

public Cell getEnd()

Gets the last cell in this worksheet.

public Cell getLastCell()

Gets the last cell in this worksheet.

public Range getMaxDisplayRange()

Gets the max range which includes data, merged cells and shapes.

public Cell getStart()

Gets the first cell in this worksheet.

NOTE: This member is now obsolete. Instead, please use Cells.FirstCell property. This property will be removed 12 months later since June 2010. Aspose apologizes for any inconvenience you may have experienced.

public Cell getFirstCell()

Gets the first cell in this worksheet.

public Cell get(int index)

Gets Cell item within the worksheet

The element at the specified index. This is the indexer for the Cells class. Gets the cell element at the specified index.

Parameters:

index - The zero based index of the element.

public Cell get(int row, int column)

Gets the Cell element at the specified cell row index and column index.

Parameters:

row - Row index.

column - Column index.

Returns:

The Cell object.

Example:

Cells cells = excel.getWorksheets().get(0).getCells();
Cell cell = cells.get(0, 0);    //Gets the cell at "A1"

public Cell get(java.lang.String cellName)

Gets the Cell element at the specified cell name.

Parameters:

cellName - Cell name,including its column letter and row number, for example A5.

Returns:

A Cell object

Example:

Cells cells = excel.getWorksheets().get(0).getCells();
Cell cell = cells.get("A1");    //Gets the cell at "A1"

public Cell find(java.lang.Object what, Cell previousCell, FindOptions findOptions)

Finds the cell containing with the input object.

Returns null(Nothing) if no cell is found.

Parameters:

what - The object to search for. The type should be int,double,DateTime,string,bool.

previousCell - Previous cell with the same object. This parameter can be set to null if seaching from the start.

findOptions - Find options

Returns:

Cell object.

public Cell endCellInRow(int rowIndex)

Gets the last cell in this row.

Parameters:

rowIndex - Row index.

Returns:

Cell object.

public Cell endCellInColumn(short columnIndex)

Gets the last cell in this column.

Parameters:

columnIndex - Column index.

Returns:

Cell object.

public Cell endCellInColumn(int startRow, int endRow, short startColumn, short endColumn)

Gets the last cell with maximum column index in this range.

Parameters:

startRow - Start row index.

endRow - End row index.

startColumn - Start column index.

endColumn - End column index.

Returns:

Cell object.

public Cell endCellInRow(int startRow, int endRow, int startColumn, int endColumn)

Gets the last cell with maximum row index in this range.

Parameters:

startRow - Start row index.

endRow - End row index.

startColumn - Start column index.

endColumn - End column index.

Returns:

Cell object.

public void moveRange(CellArea sourceArea, int destRow, int destColumn)

Moves the range to dest postion.

Parameters:

sourceArea - The range which should be moved.

destRow - The dest row.

destColumn - The dest column.

public void insertRange(CellArea area, int shiftNumber, int shiftType, boolean updateReference)

Inserts a range of cells and shift cells according to the shift option.

Parameters:

area - Shift area.

shiftNumber - Number of rows or columns to be inserted.

shiftType - A ShiftType value. Shift cells option.

updateReference - Indicates if update references in other worksheets.

public void insertRange(CellArea area, int shiftType)

Inserts a range of cells and shift cells according to the shift option.

Parameters:

area - Shift area.

shiftType - A ShiftType value. Shift cells option.

public void insertRange(CellArea area, int shiftNumber, int shiftType)

Inserts a range of cells and shift cells according to the shift option.

Parameters:

area - Shift area.

shiftNumber - Number of rows or columns to be inserted.

shiftType - A ShiftType value. Shift cells option.

public void deleteRange(int startRow, int startColumn, int endRow, int endColumn, int shiftType)

Deletes a range of cells and shift cells according to the shift option.

Parameters:

startRow - Start row index.

startColumn - Start column index.

endRow - End row index.

endColumn - End column index.

shiftType - A ShiftType value. Shift cells option.

public java.lang.Object[][] exportArray(int firstRow, int firstColumn, int totalRows, int totalColumns)

Exports data in the Cells collection to a two-dimension array object.

Parameters:

firstRow - The row number of the first cell to export out.

firstColumn - The column number of the first cell to export out.

totalRows - Number of rows to be exported

totalColumns - Number of columns to be exported

Returns:

Exported cell value array object.

public int[][] exportTypeArray(int firstRow, int firstColumn, int totalRows, int totalColumns)

Exports cell value type in the Cells collection to a two-dimension array object.

Parameters:

firstRow - The row number of the first cell to export out.

firstColumn - The column number of the first cell to export out.

totalRows - Number of rows to be exported.

totalColumns - Number of columns to be exported.

Returns:

Exported CellValuetype array object.

public int importCustomObjects(java.util.Collection list, java.lang.String[] propertyNames, boolean isPropertyNameShown, int firstRow, int firstColumn, int rowNumber, boolean insertRows, java.lang.String dateFormatString, boolean convertStringToNumber)

Imports custom objects.

The custom objects should be the same type.

Parameters:

list - The custom object

propertyNames - The property names.If it is null,we will import all properties of the object.

isPropertyNameShown - Indicates whether the property name will be imported to the first row.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

rowNumber - Number of rows to be imported.

insertRows - Indicates whether extra rows are added to fit data.

dateFormatString - Date format string for cells.

convertStringToNumber - Indicates if this method will try to convert string to number.

Returns:

Total number of rows imported.

public int importCustomObjects(java.util.Collection list, int firstRow, int firstColumn, ImportTableOptions options)

Imports custom objects.

The custom objects should be the same type.

Parameters:

list - The custom object

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

options - The import options.

Returns:

Total number of rows imported.

public void subtotal(CellArea ca, int groupBy, int function, int[] totalList)

Creates subtotals for the range.

Parameters:

ca - The range

groupBy - The field to group by, as a zero-based integer offset

function - A ConsolidationFunction value. The subtotal function.

totalList - An array of zero-based field offsets, indicating the fields to which the subtotals are added.

public void subtotal(CellArea ca, int groupBy, int function, int[] totalList, boolean replace, boolean pageBreaks, boolean summaryBelowData)

Creates subtotals for the range.

Parameters:

ca - The range

groupBy - The field to group by, as a zero-based integer offset

function - A ConsolidationFunction value. The subtotal function.

totalList - An array of zero-based field offsets, indicating the fields to which the subtotals are added.

replace - Indicates whether replace the current subtotals

pageBreaks - Indicates whether add page break between groups

summaryBelowData - Indicates whether add summarry below data.

public void removeFormulas()

Removes all formula and replaces with the value of the formula.

public void removeDuplicates(int startRow, int startColumn, int endRow, int endColumn)

Remove duplicate values in the range.

Parameters:

startRow - The start row.

startColumn - The start column

endRow - The end row index.

endColumn - The end column index.

public void convertStringToNumericValue()

Converts string data in cells to numeric value if possible.

public com.aspose.cells.Cell[] getDependents(boolean isAll, int row, int column)

Get all cells which refer to the specific cell.

Parameters:

isAll - Indicates whether check other worksheets

row - The row index.

column - The column index.

Returns:

public Style getCellStyle(int row, int column)

Get the style of given cell.

Parameters:

row - row index

column - column

Returns:

the style of given cell.

public int importResultSet(java.sql.ResultSet rs, int rowIndex, int columnIndex, int rowNum, int columnNum, boolean isFieldNameShown)
                   throws java.lang.Exception

Imports data in a ResultSet object to the worksheet.

Parameters:

rs - the ResultSet object to import from.

rowIndex - start row index in the worksheet.

columnIndex - start column index in the worksheet.

rowNum - number of rows to import. -1 to import all records in given resultset.

columnNum - number of columns to import. -1 to import all columns in given resultset.

isFieldNameShown - Indicates whether the field name of the resultset will be imported to the first row.

Returns:

how many rows actually imported.

public int importResultSet(java.sql.ResultSet rs, java.lang.String startCell, int rowNum, int columnNum, boolean isFieldNameShown)
                   throws java.lang.Exception

Imports data in a ResultSet object to the worksheet.

Parameters:

rs - the ResultSet object to import from.

startCell - name of start cell to insert the resultset, such as "A1".

rowNum - number of rows to import. -1 to import all records in given resultset.

columnNum - number of columns to import. -1 to import all columns in given resultset.

isFieldNameShown - Indicates whether the field name of the resultset will be imported to the first row.

Returns:

how many rows actually imported.

public int importResultSet(java.sql.ResultSet rs, int rowIndex, int columnIndex, boolean isFieldNameShown)
                   throws java.lang.Exception

Imports data in a ResultSet object to the worksheet.

Parameters:

rs - the ResultSet object to import from.

rowIndex - start row index in the worksheet.

columnIndex - start column index in the worksheet.

isFieldNameShown - Indicates whether the field name of the resultset will be imported to the first row.

Returns:

how many rows actually imported.

public int importResultSet(java.sql.ResultSet rs, java.lang.String startCell, boolean isFieldNameShown)
                   throws java.lang.Exception

Imports data in a ResultSet object to the worksheet.

Parameters:

rs - the ResultSet object to import from.

startCell - name of start cell to insert the resultset, such as "A1".

isFieldNameShown - Indicates whether the field name of the resultset will be imported to the first row.

Returns:

how many rows actually imported.

public int importResultSet(java.sql.ResultSet rs, int rowIndex, int columnIndex, int rowNum, int columnNum, boolean isFieldNameShown, java.lang.String customDateFormatString, boolean convertStringToNumber)
                   throws java.lang.Exception

Imports data in a ResultSet object to the worksheet.

Parameters:

rs - the ResultSet object to import from.

rowIndex - start row index in the worksheet.

columnIndex - start column index in the worksheet.

rowNum - number of rows to import. -1 to import all records in given resultset.

columnNum - number of columns to import. -1 to import all columns in given resultset.

isFieldNameShown - Indicates whether the field name of the resultset will be imported to the first row.

customDateFormatString - Date format string for cells which contain date value.

convertStringToNumber - Indicates if this method will try to convert string to number.

Returns:

how many rows actually imported.

public int importResultSet(java.sql.ResultSet rs, int rowIndex, int columnIndex, boolean isFieldNameShown, java.lang.String customDateFormatString, boolean convertStringToNumber)
                   throws java.lang.Exception

Imports data in a ResultSet object to the worksheet.

Parameters:

rs - the ResultSet object to import from.

rowIndex - start row index in the worksheet.

columnIndex - start column index in the worksheet.

isFieldNameShown - Indicates whether the field name of the resultset will be imported to the first row.

customDateFormatString - Date format string for cells which contain date value.

convertStringToNumber - Indicates if this method will try to convert string to number.

Returns:

how many rows actually imported.

public void setRowHeight(int row, double height)

Sets the height of the specified row.

To hide a row, sets row height to zero.

Parameters:

row - Row index.

height - Height of row.In unit of point It should be between 0 and 409.5.

public double getRowHeight(int row)

Gets the height of a specified row.

Parameters:

row - Row index

Returns:

Height of row

public void hideColumn(int column)

Hides a column.

Parameters:

column - Column index.

public void unhideColumn(int column, double width)

Unhides a column

Parameters:

column - Column index.

width - Column width.

public void hideColumns(int column, int totalColumns)

Hide mutiple columns.

Parameters:

column - Column index.

totalColumns - Column number.

public void unhideColumns(int column, int totlaColumns, double width)

Unhide mutiple columns.

Only applies the column width to the hidden columns.

Parameters:

column - Column index.

totlaColumns - Column number

width - Column width.

public int getRowHeightPixel(int row)

Gets the height of a specified row in unit of pixel.

Parameters:

row - Row index

Returns:

Height of row

public double getRowHeightInch(int row)

Gets the height of a specified row in unit of inches.

Parameters:

row - Row index

Returns:

Height of row

public void setColumnWidthPixel(int column, int pixel)

Sets column width in unit of pixels.

Parameters:

column - Column index.

pixel - Number of pixels.

public void setColumnWidthInch(int column, double inches)

Sets column width in unit of inches.

Parameters:

column - Column index.

inches - Number of inches.

public void setColumnWidth(int column, double width)

Sets the width of the specified column.

To hide a column, sets column width to zero.

Parameters:

column - Column index.

width - Width of column.Column width must be between 0 and 255.

public int getViewColumnWidthPixel(int column)

Get the width in different view type.

Parameters:

column - The column index.

Returns:

the column width in unit of pixels

public int getColumnWidthPixel(int column)

Gets the width of the specified column, in units of pixel.

Parameters:

column - Column index

Returns:

Width of column in normal view.

public double getColumnWidthInch(int column)

Gets the width of the specified column, in units of inches.

Parameters:

column - Column index

Returns:

Width of column

public double getColumnWidth(int column)

Gets the width of the specified column

Parameters:

column - Column index

Returns:

Width of column

public int maxDataRowInColumn(int column)

Gets the maximum row index of cell which contains data in the specified column.

NOTE: This member is now obsolete. Instead, please use Cells.GetLastDataRow(int) method. This property will be removed 12 months later since June 2010. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

column - Column index.

Returns:

Maximum row index.

public int getLastDataRow(int column)

Gets the last row index of cell which contains data in the specified column.

Parameters:

column - Column index.

Returns:

last row index.

public void applyColumnStyle(int column, Style style, StyleFlag flag)

Applies formattings for a whole column.

Parameters:

column - The column index.

style - The style object which will be applied.

flag - Flags which indicates applied formatting properties.

public void applyRowStyle(int row, Style style, StyleFlag flag)

Applies formattings for a whole row.

Parameters:

row - The row index.

style - The style object which will be applied.

flag - Flags which indicates applied formatting properties.

public void applyStyle(Style style, StyleFlag flag)

Applies formattings for a whole worksheet.

Parameters:

style - The style object which will be applied.

flag - Flags which indicates applied formatting properties.

public void copyColumn(Cells sourceCells, int sourceColumnIndex, int destinationColumnIndex)

Copies data and formattings of a whole column.

Parameters:

sourceCells - Source Cells object contains data and formattings to copy.

sourceColumnIndex - Source column index.

destinationColumnIndex - Destination column index.

public void copyColumns(Cells sourceCells, int sourceColumnIndex, int destinationColumnIndex, int columnNumber)

Copies data and formattings of a whole column.

Parameters:

sourceCells - Source Cells object contains data and formattings to copy.

sourceColumnIndex - Source column index.

destinationColumnIndex - Destination column index.

columnNumber - The copied column number.

public void copyRow(Cells sourceCells, int sourceRowIndex, int destinationRowIndex)

Copies data and formattings of a whole row.

Parameters:

sourceCells - Source Cells object contains data and formattings to copy.

sourceRowIndex - Source row index.

destinationRowIndex - Destination row index.

public void copyRows(Cells sourceCells, int sourceRowIndex, int destinationRowIndex, int rowNumber)

Copies data and formattings of some whole rows.

Parameters:

sourceCells - Source Cells object contains data and formattings to copy.

sourceRowIndex - Source row index.

destinationRowIndex - Destination row index.

rowNumber - The copied row number.

public int getGroupedRowOutlineLevel(int rowIndex)

Gets the outline level(zero-based) of the row.

If the row is not grouped, returns zero.

Parameters:

rowIndex - The row index.

Returns:

The outline level(zero-based) of the row.

public int getGroupedColumnOutlineLevel(int columnIndex)

Gets the outline level(zero-based) of the column.

If the column is not grouped, returns zero.

Parameters:

columnIndex - The column index

Returns:

The outline level of the column

public int getMaxGroupedColumnOutlineLevel()

Gets the max grouped column outline level(zero-based).

Returns:

The max grouped column outline level(zero-based)

public int getMaxGroupedRowOutlineLevel()

Gets the max grouped row outline level(zero-based).

Returns:

The max grouped row outline level(zero-based)

public void showGroupDetail(boolean isVertical, int index)

Uncollapses the grouped rows/columns.

Parameters:

isVertical - True, uncollapse the grouped rows.

index - The row/column index

public void hideGroupDetail(boolean isVertical, int index)

Collapses the grouped rows/columns.

Parameters:

isVertical - True, collapse the grouped rows.

index - The row/column index

public void ungroupColumns(int firstIndex, int lastIndex)

Ungroups columns.

Parameters:

firstIndex - The first column index to be ungrouped.

lastIndex - The last column index to be ungrouped.

public void groupColumns(int firstIndex, int lastIndex)

Groups columns.

Parameters:

firstIndex - The first column index to be grouped.

lastIndex - The last column index to be grouped.

public void groupColumns(int firstIndex, int lastIndex, boolean isHidden)

Groups columns.

Parameters:

firstIndex - The first column index to be grouped.

lastIndex - The last column index to be grouped.

isHidden - Specifies if the grouped columns are hidden.

public void ungroupRows(int firstIndex, int lastIndex, boolean isAll)

Ungroups rows.

Parameters:

firstIndex - The first row index to be ungrouped.

lastIndex - The last row index to be ungrouped.

isAll - True, removes all grouped info.Otherwise, remove the outter group info.

public void ungroupRows(int firstIndex, int lastIndex)

Ungroups rows.

Only removes outter group info.

Parameters:

firstIndex - The first row index to be ungrouped.

lastIndex - The last row index to be ungrouped.

public void groupRows(int firstIndex, int lastIndex, boolean isHidden)

Groups rows.

Parameters:

firstIndex - The first row index to be grouped.

lastIndex - The last row index to be grouped.

isHidden - Specifies if the grouped columns are hidden.

public void groupRows(int firstIndex, int lastIndex)

Groups rows.

Parameters:

firstIndex - The first row index to be grouped.

lastIndex - The last row index to be grouped.

public void deleteColumn(int columnIndex, boolean updateReference)

Deletes a column.

Parameters:

columnIndex - Column index.

updateReference - Indicates if update references in other worksheets.

public void deleteColumn(int columnIndex)

Deletes a column.

Parameters:

columnIndex - Column index.

public void deleteColumns(int columnIndex, int totalColumns, boolean updateReference)

Deletes several columns.

Parameters:

columnIndex - Column index.

totalColumns - Number of columns to be deleted.

updateReference - Indicates if update references in other worksheets.

public boolean isDeletingRangeEnabled(int startRow, int startColumn, int totalRows, int totalColumns)

Check whether the range could be deleted.

Parameters:

startRow - The start row index of the range.

startColumn - The start column idnex of the range.

totalRows - The number of the rows in the range.

totalColumns - The number of the columns in the range.

Returns:

public boolean deleteRows(int rowIndex, int totalRows)

Deletes several rows.

If the deleted range contains the top part(not whole) of the table(ListObject), the ranged could not be deleted and nothing will be done.It works as MS Excel.

Parameters:

rowIndex - The first row index to be deleted.

totalRows - Number of rows to be deleted.

public void deleteRow(int rowIndex)

Deletes a row.

Parameters:

rowIndex - Row index.

public boolean deleteRows(int rowIndex, int totalRows, boolean updateReference)

Deletes multiple rows in the worksheet.

Parameters:

rowIndex - Row index.

totalRows - Number of rows to be deleted.

updateReference - Indicates if update references in other worksheets.

Returns:

public void deleteBlankColumns()

Delete all blank columns which do not contain any data.

public boolean isBlankColumn(int columnIndex)

Checks whether given column is blank(does not contain any data).

Parameters:

columnIndex - the column index

Returns:

true if given column does not contain any data

public void deleteBlankRows()

Delete all blank rows which do not contain any data.

public void insertColumns(int columnIndex, int totalColumns)

Inserts some columns into the worksheet.

Parameters:

columnIndex - Column index.

totalColumns - The number of columns.

public void insertColumns(int columnIndex, int totalColumns, boolean updateReference)

Inserts some columns into the worksheet.

Parameters:

columnIndex - Column index.

totalColumns - The number of columns.

updateReference - Indicates if references in other worksheets will be updated.

public void insertColumn(int columnIndex, boolean updateReference)

Inserts a new column into the worksheet.

Parameters:

columnIndex - Column index.

updateReference - Indicates if references in other worksheets will be updated.

public void insertColumn(int columnIndex)

Inserts a new column into the worksheet.

Parameters:

columnIndex - Column index.

public void insertRows(int rowIndex, int totalRows, boolean updateReference)

Inserts multiple rows into the worksheet.

Parameters:

rowIndex - Row index.

totalRows - Number of rows to be inserted.

updateReference - Indicates if references in other worksheets will be updated.

public void insertRows(int rowIndex, int totalRows)

Inserts multiple rows into the worksheet.

Parameters:

rowIndex - Row index.

totalRows - Number of rows to be inserted.

public void insertRow(int rowIndex)

Inserts a new row into the worksheet.

Parameters:

rowIndex - Row index.

public void clearRange(CellArea range)

Clears contents and formatting of a range.

Parameters:

range - Range to be cleared.

public void clearRange(int startRow, int startColumn, int endRow, int endColumn)

Clears contents and formatting of a range.

Parameters:

startRow - Start row index.

startColumn - Start column index.

endRow - End row index.

endColumn - End column index.

public void clearContents(CellArea range)

Clears contents of a range.

Parameters:

range - Range to be cleared.

public void clearContents(int startRow, int startColumn, int endRow, int endColumn)

Clears contents of a range.

Parameters:

startRow - Start row index.

startColumn - Start column index.

endRow - End row index.

endColumn - End column index.

public void clearFormats(CellArea range)

Clears formatting of a range.

Parameters:

range - Range to be cleared.

public void clearFormats(int startRow, int startColumn, int endRow, int endColumn)

Clears formatting of a range.

Parameters:

startRow - Start row index.

startColumn - Start column index.

endRow - End row index.

endColumn - End column index.

public Cell findFormula(java.lang.String formula, Cell previousCell)

Finds the cell with the input string.

This method is supported in Standard and above versions of Aspose.Cells.

Parameters:

formula - The formula to search for.

previousCell - Previous cell with the same formula. This parameter can be set to null if seaching from the start.

Returns:

Cell object.

public Cell findFormulaContains(java.lang.String formula, Cell previousCell)

Finds the cell with formla which contains the input string.

This method is supported in Standard and above versions of Aspose.Cells.

Parameters:

formula - The formula to search for.

previousCell - Previous cell with the same formula. This parameter can be set to null if seaching from the start.

Returns:

Cell object.

public Cell findString(java.lang.String inputString, Cell previousCell)

Finds the cell with the input string.

Returns null(Nothing) if no cell is found. NOTE: This member is now obsolete. Instead, please use Cells.Find(object,Cell,FindOptions) method. This member will be removed 12 months later since May 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

inputString - The string to search for.

previousCell - Previous cell with the same string. This parameter can be set to null if seaching from the start.

Returns:

Cell object.

public Cell findString(java.lang.String inputString, Cell previousCell, CellArea area)

Finds the cell with the input string in the specified area.

Returns null(Nothing) if no cell is found. NOTE: This member is now obsolete. Instead, please use Cells.Find(object,Cell,FindOptions) method. This member will be removed 12 months later since May 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

inputString - The string to search for.

previousCell - Previous cell with the same string. This parameter can be set to null if seaching from the start.

area - Searched area.

Returns:

Cell object.

public Cell findString(java.lang.String inputString, Cell previousCell, CellArea area, boolean upDown)

Finds the cell with the input string in the specified area.

Returns null(Nothing) if no cell is found. NOTE: This member is now obsolete. Instead, please use Cells.Find(object,Cell,FindOptions) method. This member will be removed 12 months later since May 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

inputString - The string to search for.

previousCell - Previous cell with the same string. This parameter can be set to null if seaching from the start.

area - Searched area.

upDown - Search order. True: Up. False: Down.

Returns:

Cell object.

public Cell findString(java.lang.String inputString, Cell previousCell, boolean upDown)

Finds the cell with the input string.

Returns null(Nothing) if no cell is found. NOTE: This member is now obsolete. Instead, please use Cells.Find(object,Cell,FindOptions) method. This member will be removed 12 months later since May 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

inputString - The string to search for.

previousCell - Previous cell with the same string. This parameter can be set to null if seaching from the start.

upDown - Search order. True: Up. False: Down.

Returns:

Cell object.

public Cell findString(java.lang.String inputString, Cell previousCell, FindOptions findOptions)

Finds the cell with the input string.

Returns null(Nothing) if no cell is found. NOTE: This member is now obsolete. Instead, please use Cells.Find(object,Cell,FindOptions) method. This member will be removed 12 months later since May 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

inputString - The string to search for.

previousCell - Previous cell with the same string. This parameter can be set to null if seaching from the start.

findOptions - Sets the find options.

Returns:

Cell object.

public Cell findStringStartsWith(java.lang.String inputString, Cell previousCell)

Finds the cell starting with the input string.

Returns null(Nothing) if no cell is found. NOTE: This member is now obsolete. Instead, please use Cells.Find(object,Cell,FindOptions) method. This member will be removed 12 months later since May 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

inputString - The string to search for.

previousCell - Previous cell with the same string. This parameter can be set to null if seaching from the start.

Returns:

Cell object.

public Cell findStringEndsWith(java.lang.String inputString, Cell previousCell)

Finds the cell ending with the input string.

Returns null(Nothing) if no cell is found. NOTE: This member is now obsolete. Instead, please use Cells.Find(object,Cell,FindOptions) method. This member will be removed 12 months later since May 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

inputString - The string to search for.

previousCell - Previous cell with the same string. This parameter can be set to null if seaching from the start.

Returns:

Cell object.

public Cell findStringContains(java.lang.String inputString, Cell previousCell)

Finds the cell containing with the input string.

Returns null(Nothing) if no cell is found. NOTE: This member is now obsolete. Instead, please use Cells.Find(object,Cell,FindOptions) method. This member will be removed 12 months later since May 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

inputString - The string to search for.

previousCell - Previous cell with the same string. This parameter can be set to null if seaching from the start.

Returns:

Cell object.

public Cell findStringContains(java.lang.String inputString, Cell previousCell, boolean isCaseSensitive, CellArea area)

Finds the cell containing with the input string.

Returns null(Nothing) if no cell is found. NOTE: This member is now obsolete. Instead, please use Cells.Find(object,Cell,FindOptions) method. This member will be removed 12 months later since May 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

inputString - The string to search for.

previousCell - Previous cell with the same string. This parameter can be set to null if seaching from the start.

isCaseSensitive - Indicates if the searched string is case sensitive.

area - Searched area.

Returns:

Cell object.

public Cell findStringContains(java.lang.String inputString, Cell previousCell, boolean isCaseSensitive)

Finds the cell containing with the input string.

Returns null(Nothing) if no cell is found. NOTE: This member is now obsolete. Instead, please use Cells.Find(object,Cell,FindOptions) method. This member will be removed 12 months later since May 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

inputString - The string to search for.

previousCell - Previous cell with the same string. This parameter can be set to null if seaching from the start.

isCaseSensitive - Indicates if the searched string is case sensitive.

Returns:

Cell object.

public Cell findNumber(int inputNumber, Cell previousCell)

Finds the cell with the input integer.

Returns null(Nothing) if no cell is found. NOTE: This member is now obsolete. Instead, please use Cells.Find(object,Cell,FindOptions) method. This member will be removed 12 months later since May 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

inputNumber - The integer to search for.

previousCell - Previous cell with the same integer. This parameter can be set to null if seaching from the start.

Returns:

Cell object.

public Cell findNumber(double inputNumber, Cell previousCell)

Finds the cell with the input double.

Returns null(Nothing) if no cell is found. NOTE: This member is now obsolete. Instead, please use Cells.Find(object,Cell,FindOptions) method. This member will be removed 12 months later since May 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

inputNumber - The double to search for.

previousCell - Previous cell with the same double. This parameter can be set to null if seaching from the start.

Returns:

Cell object.

public java.util.Iterator iterator()

Gets the cells enumerator

Returns:

The cells enumertor

public java.util.Iterator getRowEnumerator()

Gets the rows enumerator

Returns:

The rows enuerator.

public Cell getCell(int row, int column)

Gets the Cell element at the specified cell row index and column index.

NOTE: This member is now obsolete. Instead, please use Cells.Get(int,int) method. This method will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

row - Row index

column - Column index

Returns:

Return Cell object.

public Row getRow(int row)

Gets the Row element or at the specified cell row index.

NOTE: This member is now obsolete. Instead, please use RowCollection[int] method. This method will be removed 12 months later since JANUARY 2010. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

row - Row index

Returns:

return the row object.

public Column getColumn(int columnIndex)

Gets the Column element or at the specified cell row index.

NOTE: This member is now obsolete. Instead, please use ColumnCollection[int] method. This method will be removed 12 months later since JANUARY 2010. Aspose apologizes for any inconvenience you may have experienced.

Parameters:

columnIndex - The column index.

Returns:

public Cell checkCell(int row, int column)

Gets the Cell element or null at the specified cell row index and column index.

Parameters:

row - Row index

column - Column index

Returns:

Return Cell object if a Cell object exists. Return null if the cell does not exist.

public Row checkRow(int row)

Gets the Row element or at the specified cell row index.

Parameters:

row - Row index

Returns:

If the row object does exist return Row object,otherwise return null.

public Column checkColumn(int columnIndex)

Gets the Column element or null at the specified column index.

Parameters:

columnIndex - The column index.

Returns:

The Column object.

public boolean isRowHidden(int rowIndex)

Checks whether a row at given index is hidden.

Parameters:

rowIndex - row index

Returns:

true if the row is hidden

public boolean isColumnHidden(int columnIndex)

Checks whether a column at given index is hidden.

Parameters:

columnIndex - column index

Returns:

true if the column is hidden.

public void addRange(Range rangeObject)

Adds a range object reference to cells

Parameters:

rangeObject - The range object will be contained in the cells

public Range createRange(java.lang.String upperLeftCell, java.lang.String lowerRightCell)

Creates a Range object from a range of cells.

Parameters:

upperLeftCell - Upper left cell name.

lowerRightCell - Lower right cell name.

Returns:

A Range object

public Range createRange(int firstRow, int firstColumn, int totalRows, int totalColumns)

Creates a Range object from a range of cells.

Parameters:

firstRow - First row of this range

firstColumn - First column of this range

totalRows - Number of rows

totalColumns - Number of columns

Returns:

A Range object

public Range createRange(java.lang.String address)

Creates a Range object from an address of the range.

Parameters:

address - The address of the range.

Returns:

A Range object

public Range createRange(int firstIndex, int number, boolean isVertical)

Creates a Range object from rows of cells or columns of cells.

Parameters:

firstIndex - First row index or first column index, zero based.

number - Total number of rows or columns, one based.

isVertical - True - Range created from columns of cells. False - Range created from rows of cells.

Returns:

A Range object.

public void clear()

Clear all cell objects.

public int importData(ICellsDataTable table, int firstRow, int firstColumn, ImportTableOptions options)

Import data from custom data table.

Parameters:

table - The custom data table.

firstRow - First row index.

firstColumn - First column index.

options - The import options

Returns:

public void importTwoDimensionArray(java.lang.Object[][] objArray, int firstRow, int firstColumn)

Imports a two-dimension array of data into a worksheet.

Parameters:

objArray - Two-dimension data array.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

public void importTwoDimensionArray(java.lang.Object[][] objArray, int firstRow, int firstColumn, boolean convertStringToNumber)

Imports a two-dimension array of data into a worksheet.

Parameters:

objArray - Two-dimension data array.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

convertStringToNumber - Indicates if this method will try to convert string to number.

public void importTwoDimensionArray(java.lang.Object[][] objArray, java.lang.Object[][] styles, int firstRow, int firstColumn, boolean convertStringToNumber)

Imports a two-dimension array of data into a worksheet.

Parameters:

objArray - Two-dimension data array.

styles - Two-dimension data style.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

convertStringToNumber - Indicates if this method will try to convert string to number.

public void importObjectArray(java.lang.Object[] objArray, int firstRow, int firstColumn, boolean isVertical)

Imports an array of data into a worksheet.

Parameters:

objArray - Data array.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

isVertical - Specifies to import data vertically or horizontally.

public void importArrayList(java.util.ArrayList arrayList, int firstRow, int firstColumn, boolean isVertical)

Imports an arraylist of data into a worksheet.

Parameters:

arrayList - Data arraylist.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

isVertical - Specifies to import data vertically or horizontally.

public void importObjectArray(java.lang.Object[] objArray, int firstRow, int firstColumn, boolean isVertical, int skip)

Imports an array of data into a worksheet.

Parameters:

objArray - Data array.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

isVertical - Specifies to import data vertically or horizontally.

skip - Skipped number of rows or columns.

public void importArray(java.lang.String[][] stringArray, int firstRow, int firstColumn)

Imports a two-dimension array of string into a worksheet.

Parameters:

stringArray - Two-dimension string array.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

public void importFormulaArray(java.lang.String[] stringArray, int firstRow, int firstColumn, boolean isVertical)

Imports an array of formula into a worksheet.

Parameters:

stringArray - Formula array.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

isVertical - Specifies to import data vertically or horizontally.

public void importArray(java.lang.String[] stringArray, int firstRow, int firstColumn, boolean isVertical)

Imports an array of string into a worksheet.

Parameters:

stringArray - String array.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

isVertical - Specifies to import data vertically or horizontally.

public void importArray(int[][] intArray, int firstRow, int firstColumn)

Imports a two-dimension array of integer into a worksheet.

Parameters:

intArray - Two-dimension integer array.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

public void importArray(int[] intArray, int firstRow, int firstColumn, boolean isVertical)

Imports an array of integer into a worksheet.

Parameters:

intArray - Integer array.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

isVertical - Specifies to import data vertically or horizontally.

public void importArray(double[][] doubleArray, int firstRow, int firstColumn)

Imports a two-dimension array of double into a worksheet.

Parameters:

doubleArray - Two-dimension double array.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

public void importArray(double[] doubleArray, int firstRow, int firstColumn, boolean isVertical)

Imports an array of double into a worksheet.

Parameters:

doubleArray - Double array.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

isVertical - Specifies to import data vertically or horizontally.

public void importCSV(java.lang.String fileName, java.lang.String spliter, boolean convertNumericData, int firstRow, int firstColumn)
              throws java.lang.Exception

Import a CSV file to the cells.

Parameters:

fileName - The CSV file name.

spliter - The spliter

convertNumericData - Whether the string in text file is converted to numeric data.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

public void importCSV(java.io.InputStream stream, java.lang.String spliter, boolean convertNumericData, int firstRow, int firstColumn)
              throws java.lang.Exception

Import a CSV file to the cells.

Parameters:

stream - The CSV file stream.

spliter - The spliter

convertNumericData - Whether the string in text file is converted to numeric data.

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

public void importCSV(java.lang.String fileName, TxtLoadOptions options, int firstRow, int firstColumn)
              throws java.lang.Exception

Import a CSV file to the cells.

Parameters:

fileName - The CSV file name.

options - The load options for reading text file

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

public void importCSV(java.io.InputStream stream, TxtLoadOptions options, int firstRow, int firstColumn)
              throws java.lang.Exception

Import a CSV file to the cells.

Parameters:

stream - The CSV file stream.

options - The load options for reading text file

firstRow - The row number of the first cell to import in.

firstColumn - The column number of the first cell to import in.

public void merge(int firstRow, int firstColumn, int totalRows, int totalColumns)

Merges a specified range of cells into a single cell.

Reference the merged cell via the address of the upper-left cell in the range.

Parameters:

firstRow - First row of this range(zero based)

firstColumn - First column of this range(zero based)

totalRows - Number of rows(one based)

totalColumns - Number of columns(one based)

public void merge(int firstRow, int firstColumn, int totalRows, int totalColumns, boolean mergeConflict)

Merges a specified range of cells into a single cell.

Reference the merged cell via the address of the upper-left cell in the range. If mergeConflict is true and the merged range conflicts with other merged cells, other merged cells will be automatically removed.

Parameters:

firstRow - First row of this range(zero based)

firstColumn - First column of this range(zero based)

totalRows - Number of rows(one based)

totalColumns - Number of columns(one based)

mergeConflict - Merge conflict merged ranges.

public void merge(int firstRow, int firstColumn, int totalRows, int totalColumns, boolean checkConflict, boolean mergeConflict)

Merges a specified range of cells into a single cell.

Reference the merged cell via the address of the upper-left cell in the range. If mergeConflict is true and the merged range conflicts with other merged cells, other merged cells will be automatically removed.

Parameters:

firstRow - First row of this range(zero based)

firstColumn - First column of this range(zero based)

totalRows - Number of rows(one based)

totalColumns - Number of columns(one based)

checkConflict - Indicates whether check the merged cells intersects other merged cells

mergeConflict - Merge conflict merged ranges.

public void unMerge(int firstRow, int firstColumn, int totalRows, int totalColumns)

Unmerges a specified range of merged cells.

Parameters:

firstRow - First row of this range(zero based)

firstColumn - First column of this range(zero based)

totalRows - Number of rows(one based)

totalColumns - Number of columns(one based)

public void hideRow(int row)

Hides a row.

Parameters:

row - Row index.

public void unhideRow(int row, double height)

Unhides a row.

Parameters:

row - Row index.

height - Row height.

public void hideRows(int row, int totalRows)

Hides multiple rows.

Parameters:

row - The row index.

totalRows - The row number.

public void unhideRows(int row, int totalRows, double height)

Unhides the hidden rows.

Only applies row height to the hidden rows.

Parameters:

row - The row index.

totalRows - The row number.

height - Row height.

public void setRowHeightPixel(int row, int pixels)

Sets row height in unit of pixels.

Parameters:

row - Row index.

pixels - Number of pixels.

public void setRowHeightInch(int row, double inches)

Sets row height in unit of inches.

Parameters:

row - Row index.

inches - Number of inches.It should be between 0 and 409.5/72.