adams.data.conversion
Class SpreadSheetInsertCellLocation

java.lang.Object
  adams.core.ConsoleObject
      adams.core.option.AbstractOptionHandler
          adams.data.conversion.AbstractConversion
              adams.data.conversion.AbstractStringConversion
                  adams.data.conversion.SpreadSheetInsertCellLocation

All Implemented Interfaces:

CleanUpHandler, Debuggable, Destroyable, OptionHandler, QuickInfoSupporter, ShallowCopySupporter<AbstractConversion>, SizeOfHandler, Stoppable, Conversion, ConversionFromString, ConversionToString, Serializable

public class SpreadSheetInsertCellLocation
extends AbstractStringConversion

Replaces the specified placeholder with a cell location generated from the user-supplied row and column.

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
 

-placeholder <java.lang.String> (property: placeholder)
    The placeholder to replace in the string with the generated cell location.
    default: {C}
 

-row <int> (property: row)
    The 1-based row index to use for the cell location.
    default: 1
    minimum: 1
 

-column <int> (property: column)
    The 1-based column index to use for the cell location.
    default: 1
    minimum: 1
 

Version:

$Revision: 6830 $

Author:

fracpete (fracpete at waikato dot ac dot nz)

See Also:

Serialized Form

Field Summary

protected int	m_Column the column to use (1-based).
protected String	m_Placeholder the placeholder to replace.
protected int	m_Row the row to use (1-based).

Fields inherited from class adams.data.conversion.AbstractConversion

m_Input, m_Output, m_Owner, m_Stopped

Fields inherited from class adams.core.option.AbstractOptionHandler

m_DebugLevel, m_OptionManager

Constructor Summary

SpreadSheetInsertCellLocation()

Method Summary

String	columnTipText() Returns the tip text for this property.
void	defineOptions() Adds options to the internal list of options.
protected Object	doConvert() Performs the actual conversion.
int	getColumn() Returns the column index in use for the cell location.
String	getPlaceholder() Returns the placeholder string to replace with the cell location in the string passing through.
String	getQuickInfo() Returns a quick info about the object, which can be displayed in the GUI.
int	getRow() Returns the row index in use for the cell location.
String	globalInfo() Returns a string describing the object.
String	placeholderTipText() Returns the tip text for this property.
String	rowTipText() Returns the tip text for this property.
void	setColumn(int value) Sets the column index to use for the cell location.
void	setPlaceholder(String value) Sets the placeholder to replace with the cell location in the string passing through.
void	setRow(int value) Sets the row index to use for the cell location.

Methods inherited from class adams.data.conversion.AbstractStringConversion

accepts, generates

Methods inherited from class adams.data.conversion.AbstractConversion

checkData, cleanUp, convert, getInput, getOutput, getOwner, reset, setInput, setOwner, shallowCopy, shallowCopy, stopExecution

Methods inherited from class adams.core.option.AbstractOptionHandler

cleanUpOptions, debug, debug, debugLevelTipText, destroy, finishInit, getDebugLevel, getOptionManager, initialize, isDebugOn, newOptionManager, setDebugLevel, toCommandLine, toString

Methods inherited from class adams.core.ConsoleObject

getDebugging, getSystemErr, getSystemOut, sizeOf

Methods inherited from class java.lang.Object

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

Methods inherited from interface adams.data.conversion.Conversion

convert, getInput, getOutput, getOwner, setInput, setOwner

Methods inherited from interface adams.core.CleanUpHandler

cleanUp

Methods inherited from interface adams.core.Stoppable

stopExecution

Field Detail

m_Placeholder

protected String m_Placeholder

the placeholder to replace.

m_Row

protected int m_Row

the row to use (1-based).

m_Column

protected int m_Column

the column to use (1-based).

Constructor Detail

SpreadSheetInsertCellLocation

public SpreadSheetInsertCellLocation()

Method Detail

globalInfo

public String globalInfo()

Returns a string describing the object.

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

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 AbstractConversion

Returns:

null if no info available, otherwise short string

setPlaceholder

public void setPlaceholder(String value)

Sets the placeholder to replace with the cell location in the string passing through.

Parameters:

value - the placeholder

getPlaceholder

public String getPlaceholder()

Returns the placeholder string to replace with the cell location in the string passing through.

Returns:

the placeholder

placeholderTipText

public String placeholderTipText()

Returns the tip text for this property.

Returns:

tip text for this property suitable for displaying in the GUI or for listing the options.

setRow

public void setRow(int value)

Sets the row index to use for the cell location.

Parameters:

value - the index (1-based)

getRow

public int getRow()

Returns the row index in use for the cell location.

Returns:

the index (1-based)

rowTipText

public String rowTipText()

Returns the tip text for this property.

Returns:

tip text for this property suitable for displaying in the GUI or for listing the options.

setColumn

public void setColumn(int value)

Sets the column index to use for the cell location.

Parameters:

value - the index (1-based)

getColumn

public int getColumn()

Returns the column index in use for the cell location.

Returns:

the index (1-based)

columnTipText

public String columnTipText()

Returns the tip text for this property.

Returns:

tip text for this property suitable for displaying in the GUI or for listing the options.

doConvert

protected Object doConvert()
                    throws Exception

Performs the actual conversion.

Specified by:

doConvert in class AbstractConversion

Returns:

the converted data

Throws:

Exception - if something goes wrong with the conversion