jas.hist
Class StatisticsBlock

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--jas.plot.PlotComponent
                          |
                          +--jas.plot.MovableObject
                                |
                                +--jas.plot.TextBlock
                                      |
                                      +--jas.hist.StatisticsBlock

All Implemented Interfaces:

HasPopupItems, java.awt.image.ImageObserver, JASPlotMouseListener, java.awt.MenuContainer, java.io.Serializable

public class StatisticsBlock

extends TextBlock

The main class used to display and format statistics. When a user selects showStatistics from the plots popupmenu, a statistics text block is displayed showing each displayed plots' statistics (Vector stats) and name. The statistics block requires a number formatting method to be set (setFormat), the default method is implemented by jas.util.ScientificFormat.

See Also:

Serialized Form

Inner classes inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Inner classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Inner classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent

Field Summary

static int	LEFTALIGNSPLIT
static int	NOALIGNSPLIT
static int	RIGHTALIGNSPLIT
static int	SHOWTITLES_ALWAYS
static int	SHOWTITLES_AUTOMATIC
static int	SHOWTITLES_NEVER

Fields inherited from class jas.plot.TextBlock

fm

Fields inherited from class jas.plot.MovableObject

bgcolors, bgnames

Fields inherited from class jas.plot.PlotComponent

BEVEL_IN, BEVEL_OUT, ETCHED, LINE, NONE, OTHER, SHADOW

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

StatisticsBlock()

StatisticsBlock(java.text.Format g)

Method Summary

void	add(JASHistData data) Adds a Statistcs element to the Vector stats if not null
void	clear() Clears the Vector stats and titles.
java.text.Format	getFormat() Returns the current formatting object;
java.lang.String	getLine(int j) Returns a line to be displayed in the statistics block as a String.
int	getNLines() Calculates and returns the total number of lines to be displayed in the statistics block, including a draw line seperator, plot title (if available) and formatted statistics for each data set displayed in the plot area.
java.lang.String[]	getSelectedEntries() Returns the statistics to be formatted and displayed in the block as a String of stat names.
int	getShowTitles() Returns the (int) showtitles which has three values:SHOWTITLES_ALWAYS, SHOWTITLES_NEVER, SHOWTITLES_AUTOMATIC.
int	getSplitStringAlign() When implemented, getSplitStringAlignment() should return an integer between 1 and 3 corresponding to the chosen alignment for the second half of strings split by '\t'.
void	modifyPopupMenu(javax.swing.JPopupMenu menu, java.awt.Component source) Modify the given menu object.
void	putFormat(java.lang.Class c, java.text.Format f)
void	remove(JASHistData data) Removes a Statistcs element from the Vector stats and the corresponding data set title from the titles Vector.
void	setFormat(java.text.Format g) Sets the number formating object.
void	setSelectedEntries(java.lang.String[] s) Sets the statistics to be formatted and displayed in the block as a String of stat names.
void	setShowTitles(int settitles) Sets the (int) showtitles to one of three values:SHOWTITLES_ALWAYS, SHOWTITLES_NEVER, SHOWTITLES_AUTOMATIC.
void	setSplitStringAlign(int a) When implemented, setSplitStringAlignment() should set an integer between 1 and 3 corresponding to the chosen alignment for the second half of strings split by '\t'.

Methods inherited from class jas.plot.TextBlock

allocateSize, getPreferredSize, paintComponent, setFont

Methods inherited from class jas.plot.MovableObject

getBorderType, getInsideBorder, getPrefix, hasDefaultPosition, mouseEventNotify, print, setBorder, setMovableObjectBounds, setMovableObjectBounds

Methods inherited from class jas.plot.PlotComponent

isPaintingBackground, setBackground, setBorderType

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getUIClassID, getVerifyInputWhenFocusTarget, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, hide, isDoubleBuffered, isFocusCycleRoot, isFocusTraversable, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, paramString, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processFocusEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setDebugGraphicsOptions, setDoubleBuffered, setEnabled, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, imageUpdate, inside, isDisplayable, isEnabled, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus

Methods inherited from class java.lang.Object

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

Field Detail

SHOWTITLES_ALWAYS

public static final int SHOWTITLES_ALWAYS

SHOWTITLES_NEVER

public static final int SHOWTITLES_NEVER

SHOWTITLES_AUTOMATIC

public static final int SHOWTITLES_AUTOMATIC

LEFTALIGNSPLIT

public static final int LEFTALIGNSPLIT

RIGHTALIGNSPLIT

public static final int RIGHTALIGNSPLIT

NOALIGNSPLIT

public static final int NOALIGNSPLIT

Constructor Detail

StatisticsBlock

public StatisticsBlock()

StatisticsBlock

public StatisticsBlock(java.text.Format g)

Method Detail

getNLines

public int getNLines()

Calculates and returns the total number of lines to be displayed in the statistics block, including a draw line seperator, plot title (if available) and formatted statistics for each data set displayed in the plot area.

Overrides:

getNLines in class TextBlock

getLine

public java.lang.String getLine(int j)

Returns a line to be displayed in the statistics block as a String. If the line corresponding to index j is a statisic, the stat (double) is formated by the set formatting method and returned with the stat name to be displayed. Also returned are Strings that generate a line Seperator ("\n") in the statistics block and the data set title.

Overrides:

getLine in class TextBlock

setSelectedEntries

public void setSelectedEntries(java.lang.String[] s)

Sets the statistics to be formatted and displayed in the block as a String of stat names. If called, only the stats corresponding to these names are formatted and displayed. This method is invoked when "Statistics Properties.." popup is invoked (base.jas.hist.StatsWindow).

getSelectedEntries

public java.lang.String[] getSelectedEntries()

Returns the statistics to be formatted and displayed in the block as a String of stat names. If selectedentries != null, only the stats corresponding to these names are formatted and displayed.

add

public void add(JASHistData data)

Adds a Statistcs element to the Vector stats if not null

remove

public void remove(JASHistData data)

Removes a Statistcs element from the Vector stats and the corresponding data set title from the titles Vector.

clear

public void clear()

Clears the Vector stats and titles. No statistics are available

setFormat

public void setFormat(java.text.Format g)

Sets the number formating object. If a statistics window is user generated the format is set to base.jas.util.ScientificFormat and this method is invoked by each click of the apply and ok buttons

getFormat

public java.text.Format getFormat()

Returns the current formatting object;

putFormat

public void putFormat(java.lang.Class c,
                      java.text.Format f)

getSplitStringAlign

public int getSplitStringAlign()

When implemented, getSplitStringAlignment() should return an integer between 1 and 3 corresponding to the chosen alignment for the second half of strings split by '\t'. For leftalignment: return 1. For rightaignment: return 2. For noalignment: return 3.

Overrides:

getSplitStringAlign in class TextBlock

setSplitStringAlign

public void setSplitStringAlign(int a)

When implemented, setSplitStringAlignment() should set an integer between 1 and 3 corresponding to the chosen alignment for the second half of strings split by '\t'. For leftalignment: return 1. For rightalignment: return 2. For noalignment: return 3.

setShowTitles

public void setShowTitles(int settitles)

Sets the (int) showtitles to one of three values:SHOWTITLES_ALWAYS, SHOWTITLES_NEVER, SHOWTITLES_AUTOMATIC. The value controls when a plot title is displayed in the stat block. If showtitles = SHOWTITLES_AUTOMATIC then titles will be displayed if there is more than one plot displayed.

getShowTitles

public int getShowTitles()

Returns the (int) showtitles which has three values:SHOWTITLES_ALWAYS, SHOWTITLES_NEVER, SHOWTITLES_AUTOMATIC. The value controls when a plot title is displayed in the stat block. If showtitles = SHOWTITLES_AUTOMATIC then titles will be displayed if there is more than one plot displayed.

modifyPopupMenu

public void modifyPopupMenu(javax.swing.JPopupMenu menu,
                            java.awt.Component source)

Description copied from interface: HasPopupItems

Modify the given menu object.

Overrides:

modifyPopupMenu in class TextBlock