Package adams.data.spreadsheet.cellfinder

Class CellRange

java.lang.Object

adams.core.logging.LoggingObject

adams.core.logging.CustomLoggingLevelObject

adams.core.option.AbstractOptionHandler

adams.data.spreadsheet.cellfinder.AbstractCellFinder

adams.data.spreadsheet.cellfinder.AbstractRowCellFinder

adams.data.spreadsheet.cellfinder.CellRange

All Implemented Interfaces:

Destroyable, GlobalInfoSupporter, LoggingLevelHandler, LoggingSupporter, OptionHandler, QuickInfoSupporter, SizeOfHandler, CellFinder, RowCellFinder, Serializable

public class CellRange
extends AbstractRowCellFinder

Locator that locates cells using a rectangular range.

Valid options are:

-D <int> (property: debugLevel)
    The greater the number the more additional info the scheme may output to 
    the console (0 = off).
    default: 0
    minimum: 0
 

-rows <adams.core.Range> (property: rows)
    The rows to locate.
    default: first-last
 

-columns <adams.core.Range> (property: columns)
    The columns to locate.
    default: first-last
 

Author:

fracpete (fracpete at waikato dot ac dot nz)

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected SpreadSheetColumnRange	m_Columns	the columns.
protected Range	m_Rows	the rows.

Fields inherited from class adams.core.option.AbstractOptionHandler

m_OptionManager

Fields inherited from class adams.core.logging.LoggingObject

m_Logger, m_LoggingIsEnabled, m_LoggingLevel

Constructor Summary

Constructors

Constructor	Description
CellRange()

Method Summary

Modifier and Type	Method	Description
String	columnsTipText()	Returns the tip text for this property.
void	defineOptions()	Adds options to the internal list of options.
protected Iterator<CellLocation>	doFindCells(Row row)	Performs the actual locating.
protected Iterator<CellLocation>	doFindCells(SpreadSheet sheet)	Performs the actual locating.
SpreadSheetColumnRange	getColumns()	Returns the columns to locate.
String	getQuickInfo()	Returns a quick info about the object, which can be displayed in the GUI.
Range	getRows()	Returns the rows to locate.
String	globalInfo()	Returns a string describing the object.
String	rowsTipText()	Returns the tip text for this property.
void	setColumns(SpreadSheetColumnRange value)	Sets the columns to locate.
void	setRows(Range value)	Sets the rows to locate.

Methods inherited from class adams.data.spreadsheet.cellfinder.AbstractRowCellFinder

check, findCells

Methods inherited from class adams.data.spreadsheet.cellfinder.AbstractCellFinder

check, findCells, forCommandLine, forName, getCellFinders, shallowCopy, shallowCopy

Methods inherited from class adams.core.option.AbstractOptionHandler

cleanUpOptions, destroy, finishInit, getDefaultLoggingLevel, getOptionManager, initialize, loggingLevelTipText, newOptionManager, reset, setLoggingLevel, toCommandLine, toString

Methods inherited from class adams.core.logging.LoggingObject

configureLogger, getLogger, getLoggingLevel, initializeLogging, isLoggingEnabled, sizeOf

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface adams.data.spreadsheet.cellfinder.CellFinder

findCells

Methods inherited from interface adams.core.logging.LoggingLevelHandler

getLoggingLevel

Field Detail

m_Rows

protected Range m_Rows

the rows.

m_Columns

protected SpreadSheetColumnRange m_Columns

the columns.

Constructor Detail

CellRange

public CellRange()

Method Detail

globalInfo

public String globalInfo()

Returns a string describing the object.

Specified by:

globalInfo in interface GlobalInfoSupporter

Specified by:

globalInfo in class AbstractOptionHandler

Returns:

a description suitable for displaying in the gui

defineOptions

public void defineOptions()

Adds options to the internal list of options.

Specified by:

defineOptions in interface OptionHandler

Overrides:

defineOptions in class AbstractOptionHandler

setRows

public void setRows(Range value)

Sets the rows to locate.

Parameters:

value - the rows

getRows

public Range getRows()

Returns the rows to locate.

Returns:

the rows

rowsTipText

public String rowsTipText()

Returns the tip text for this property.

Returns:

tip text for this property suitable for displaying in the gui

setColumns

public void setColumns(SpreadSheetColumnRange value)

Sets the columns to locate.

Parameters:

value - the columns

getColumns

public SpreadSheetColumnRange getColumns()

Returns the columns to locate.

Returns:

the columns

columnsTipText

public String columnsTipText()

Returns the tip text for this property.

Returns:

tip text for this property suitable for displaying in the gui

getQuickInfo

public String getQuickInfo()

Returns a quick info about the object, which can be displayed in the GUI.

Specified by:

getQuickInfo in interface QuickInfoSupporter

Overrides:

getQuickInfo in class AbstractCellFinder

Returns:

null if no info available, otherwise short string

doFindCells

protected Iterator<CellLocation> doFindCells(SpreadSheet sheet)

Performs the actual locating.

Specified by:

doFindCells in class AbstractCellFinder

Parameters:

sheet - the sheet to locate the cells in

Returns:

the iterator over the locations

doFindCells

protected Iterator<CellLocation> doFindCells(Row row)

Performs the actual locating.

Specified by:

doFindCells in class AbstractRowCellFinder

Parameters:

row - the row to locate the cells in

Returns:

the iterator over the locations