org.das2.graph

Class DasRow

java.lang.Object

org.das2.graph.DasDevicePosition

org.das2.graph.DasRow

All Implemented Interfaces:

java.io.Serializable, Editable

public class DasRow
extends DasDevicePosition

DasRow object represents the vertical position on the canvas.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static DasRow	NULL placeholder for unassigned value.

Fields inherited from class org.das2.graph.DasDevicePosition

canvas, listenerList, parent, PROP_DMAXIMUM, PROP_DMINIMUM, PROP_EMMAXIMUM, PROP_EMMINIMUM, PROP_MAXIMUM, PROP_MAXLAYOUT, PROP_MINIMUM, PROP_MINLAYOUT, PROP_PARENT_DEVICE_POSITION_DAS_NAME, PROP_PTMAXIMUM, PROP_PTMINIMUM

Constructor Summary

Constructors

Constructor and Description
DasRow(DasCanvas canvas, DasRow parent, double nMin, double nMax, double emMin, double emMax, int ptMin, int ptMax) create a DasRow
DasRow(DasCanvas parent, double top, double bottom) create a DasRow with the normal position and no offsets.

Method Summary

Modifier and Type	Method and Description
int	bottom() return the device location of the bottom (non-inclusive) of the row.
static DasRow	create(DasCanvas parent) Deprecated. use new DasRow(parent,0.1,0.9);
static DasRow	create(DasCanvas canvas, DasRow parent, java.lang.String minStr, java.lang.String maxStr) makes a new DasRow by parsing a string like "100%-5em+3pt" to get the offsets.
static DasRow	create(DasCanvas parent, int iplot, int nplot) Deprecated. a convenience method should be added.
DasRow	createAttachedRow(double ptop, double pbottom) create a row that is positioned relative to this row.
DasRow	createSubRow(double ptop, double pbottom) Deprecated. This created a row that was not attached to anything, so it was simply a convenience method that didn't save much effort.
int	getHeight() return the height in points (pixels) of the row.
java.lang.String	getParentRowName() return the name of the column this is attached to, or empty string.
void	setParentRow(DasRow r) reset the parent to be this new DasColumn, or null.
int	top() return the device location of the top of the row.

Methods inherited from class org.das2.graph.DasDevicePosition

addPropertyChangeListener, addPropertyChangeListener, addUpdateListener, contains, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireUpdate, formatFormatStr, formatLayoutStr, formatLayoutStr, formatLayoutStr, getCanvas, getDasName, getDeviceSize, getDMaximum, getDMiddle, getDMinimum, getEmMaximum, getEmMinimum, getEmSize, getMaximum, getMaxLayout, getMinimum, getMinLayout, getParent, getParentDasName, getParentDevicePosition, getPtMaximum, getPtMinimum, isValueIsAdjusting, mutatorLock, parseFormatStr, parseLayoutStr, parseLayoutStr, parseLayoutStr, removeListeners, removePropertyChangeListener, removePropertyChangeListener, removeUpdateListener, revalidate, setDasName, setDMaximum, setDMinimum, setDPosition, setEmMaximum, setEmMinimum, setMax, setMaximum, setMaxLayout, setMin, setMinimum, setMinLayout, setParent, setParentDevicePosition, setPtMaximum, setPtMinimum, toRectangle, toString

Methods inherited from class java.lang.Object

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

Field Detail

NULL

public static final DasRow NULL

placeholder for unassigned value.

Constructor Detail

DasRow

public DasRow(DasCanvas parent,
              double top,
              double bottom)

create a DasRow with the normal position and no offsets.

Parameters:

parent - the canvas where this lives.

top - the top of the row in normal coordinates.

bottom - the bottom of the row in normal (0-1.) coordinates

DasRow

public DasRow(DasCanvas canvas,
              DasRow parent,
              double nMin,
              double nMax,
              double emMin,
              double emMax,
              int ptMin,
              int ptMax)

create a DasRow

Parameters:

canvas - the canvas where this lives.

parent - the parent row or null to which this is relative.

nMin - normal position of the top with respect to the canvas or parent if non-null.

nMax - normal position of the bottom with respect to the canvas or parent if non-null.

emMin - em offset of the top from the minimum position, in canvas font heights.

emMax - em offset of the bottom from the maximum position, in canvas font heights.

ptMin - point offset of the top from the minimum position, note points are the same as pixels.

ptMax - point offset of the bottom from the maximum position, note points are the same as pixels.

Method Detail

create

public static DasRow create(DasCanvas canvas,
                            DasRow parent,
                            java.lang.String minStr,
                            java.lang.String maxStr)

makes a new DasRow by parsing a string like "100%-5em+3pt" to get the offsets. The three qualifiers are "%", "em", and "pt", but "px" is allowed as well as surely people will use that by mistake. If an offset or the normal position is not specified, then 0 is used.

Parameters:

canvas - the canvas for the layout, ignored when a parent DasRow is used.

parent - if non-null, this DasRow is specified with respect to parent.

minStr - a string like "0%+5em"

maxStr - a string like "100%-7em"

Returns:

a new DasRow.

Throws:

java.lang.IllegalArgumentException - if the strings cannot be parsed

createSubRow

public DasRow createSubRow(double ptop,
                           double pbottom)

Deprecated. This created a row that was not attached to anything, so it was simply a convenience method that didn't save much effort.

getHeight

public int getHeight()

return the height in points (pixels) of the row.

Returns:

the height in points (pixels) of the row.

create

public static DasRow create(DasCanvas parent)

Deprecated. use new DasRow(parent,0.1,0.9);

create

public static DasRow create(DasCanvas parent,
                            int iplot,
                            int nplot)

Deprecated. a convenience method should be added.

Parameters:

parent -

iplot -

nplot -

Returns:

createAttachedRow

public DasRow createAttachedRow(double ptop,
                                double pbottom)

create a row that is positioned relative to this row.

Parameters:

ptop - the normal position

pbottom - the normal position

Returns:

the new row.

top

public int top()

return the device location of the top of the row.

Returns:

the device location of the top of the row.

bottom

public int bottom()

return the device location of the bottom (non-inclusive) of the row.

Returns:

the device location of the bottom (non-inclusive) of the row.

setParentRow

public void setParentRow(DasRow r)

reset the parent to be this new DasColumn, or null.

Parameters:

r - the new parent row, or null.

getParentRowName

public java.lang.String getParentRowName()

return the name of the column this is attached to, or empty string.

Returns:

the name of the column this is attached to, or empty string.