edu.neu.ccs.gui
Class PaintableComponent

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--edu.neu.ccs.gui.JPTComponent
                          |
                          +--edu.neu.ccs.gui.PaintableComponent

All Implemented Interfaces:

Icon, ImageObserver, MenuContainer, Serializable, SupportsPropertyChange

public class PaintableComponent

extends JPTComponent

implements Icon

Class PaintableComponent encapsulates a Paintable and uses that paintable to define the PaintComponent method and to determine the size of the component.

This class also implements the Icon interface.

Since:

2.3.2

See Also:

Serialized Form

Field Summary

static String

SET_PAINTABLE Bound property name for set paintable.

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

PaintableComponent(Paintable paintable)
This constructor provides the paintable needed to define the component.

PaintableComponent(Paintable paintable, Color color)
This constructor provides the paintable needed to define the component, and the optional background color.

PaintableComponent(Paintable paintable, Color color, boolean opaque)
This constructor provides the paintable needed to define the component, the optional background color, and the opacity setting.

PaintableComponent(Paintable paintable, Color color, boolean opaque, Border border)
This constructor provides the paintable needed to define the component, the optional background color, the opacity setting, and the component border.

Method Summary

Rectangle2D	getDefaultBounds2D() Returns the default bounds for the component using the information in the encapsulated paintable and the insets if any.
Point	getDefaultLocation() Returns the default location for the component using the information in the encapsulated paintable and the insets if any.
int	getIconHeight() Returns the icon height which is the height of the bounds region of the encapsulated paintable.
int	getIconWidth() Returns the icon width which is the width of the bounds region of the encapsulated paintable.
Dimension	getMaximumSize() Returns the same dimension as getPreferredSize.
Dimension	getMinimumSize() Returns the same dimension as getPreferredSize.
Paintable	getPaintable() Returns the encapsulated paintable.
Dimension	getPreferredSize() Returns the preferred size of the component based on the bounds of the encapsulated paintable and the component insets if any.
Dimension	getSize() Returns the same dimension as getPreferredSize.
protected void	paintComponent(Graphics g) Overrides the inherited paintComponent method to paint the background if the component is set to be opaque and then to use the paintable to paint the component details.
void	paintIcon(Component c, Graphics g, int x, int y) Draw this object as an icon at the specified location using the paintable to paint the icon details.
void	refresh() Sets the component location and size using the information in the given paintable and then refreshes the component by repacking the parent window.
void	setPaintable(Paintable paintable) Sets the encapsulated paintable to the given paintable and refreshes the screen provided the component is installed in a GUI.

Methods inherited from class edu.neu.ccs.gui.JPTComponent

addForwardingListener, addPropertyChangeListeners, addPropertyChangeListeners, firePropertyChange, firePropertyChange, getForwardingListener, getKeyActionAdapter, getMouseActionAdapter, hasListeners, refreshComponent, removeAndAddForwardingListener, removeForwardingListener

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, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getNextFocusableComponent, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface edu.neu.ccs.gui.SupportsPropertyChange

addPropertyChangeListener, addPropertyChangeListener, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getPropertyChangeListeners, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Field Detail

SET_PAINTABLE

public static final String SET_PAINTABLE

Bound property name for set paintable.

See Also:

Constant Field Values

Constructor Detail

PaintableComponent

public PaintableComponent(Paintable paintable)

This constructor provides the paintable needed to define the component.

Throws NullPointerException if the given paintable is null.

Parameters:

paintable - the paintable to encapsulate

See Also:

PaintableComponent(Paintable, Color), PaintableComponent(Paintable, Color, boolean), PaintableComponent(Paintable, Color, boolean, Border)

PaintableComponent

public PaintableComponent(Paintable paintable,
                          Color color)

This constructor provides the paintable needed to define the component, and the optional background color.

Throws NullPointerException if the given paintable is null.

Ignores the given color if it is null.

The background will not be painted unless the opaque property is also set to true.

Parameters:

paintable - the paintable to encapsulate

color - the optional background color

See Also:

PaintableComponent(Paintable), PaintableComponent(Paintable, Color, boolean), PaintableComponent(Paintable, Color, boolean, Border)

PaintableComponent

public PaintableComponent(Paintable paintable,
                          Color color,
                          boolean opaque)

This constructor provides the paintable needed to define the component, the optional background color, and the opacity setting.

Throws NullPointerException if the given paintable is null.

Ignores the given color if it is null.

If the given value of opaque is true, then the background color is painted on the component area before painting the paintable.

Parameters:

paintable - the paintable to encapsulate

color - the optional background color

opaque - whether or not to paint the component background

See Also:

PaintableComponent(Paintable), PaintableComponent(Paintable, Color), PaintableComponent(Paintable, Color, boolean, Border)

PaintableComponent

public PaintableComponent(Paintable paintable,
                          Color color,
                          boolean opaque,
                          Border border)

This constructor provides the paintable needed to define the component, the optional background color, the opacity setting, and the component border.

Throws NullPointerException if the given paintable is null.

Ignores the given color if it is null.

If the given value of opaque is true, then the background color is painted on the component area before painting the paintable.

Ignores the given border if it is null.

Parameters:

paintable - the paintable to encapsulate

color - the optional background color

opaque - whether or not to paint the component background

border - the border for the component

See Also:

PaintableComponent(Paintable), PaintableComponent(Paintable, Color), PaintableComponent(Paintable, Color, boolean)

Method Detail

setPaintable

public void setPaintable(Paintable paintable)

Sets the encapsulated paintable to the given paintable and refreshes the screen provided the component is installed in a GUI.

Does nothing if the given paintable is null or if it is the same object as the encapsulated paintable.

Fires property change: SET_PAINTABLE.

Parameters:

paintable - the paintable to encapsulate

getPaintable

public Paintable getPaintable()

Returns the encapsulated paintable.

Returns:

the encapsulated paintable

getDefaultBounds2D

public Rectangle2D getDefaultBounds2D()

Returns the default bounds for the component using the information in the encapsulated paintable and the insets if any.

A LayoutManager may change the actual bounds of the component in a GUI to satisfy layout decisions.

Returns:

the default bounds for the component

getDefaultLocation

public Point getDefaultLocation()

Returns the default location for the component using the information in the encapsulated paintable and the insets if any.

A LayoutManager may change the actual location of the component in a GUI to satisfy layout decisions.

Returns:

the default location for the component

getPreferredSize

public Dimension getPreferredSize()

Returns the preferred size of the component based on the bounds of the encapsulated paintable and the component insets if any.

Overrides:

getPreferredSize in class JComponent

Returns:

the preferred size

getMinimumSize

public Dimension getMinimumSize()

Returns the same dimension as getPreferredSize.

Overrides:

getMinimumSize in class JComponent

Returns:

the minimum size

getMaximumSize

public Dimension getMaximumSize()

Returns the same dimension as getPreferredSize.

Overrides:

getMaximumSize in class JComponent

Returns:

the maximum size

getSize

public Dimension getSize()

Returns the same dimension as getPreferredSize.

Overrides:

getSize in class Component

Returns:

the size

getIconWidth

public int getIconWidth()

Returns the icon width which is the width of the bounds region of the encapsulated paintable.

This width ignores the insets of the object viewed as a component.

Specified by:

getIconWidth in interface Icon

Returns:

the icon width

getIconHeight

public int getIconHeight()

Returns the icon height which is the height of the bounds region of the encapsulated paintable.

This height ignores the insets of the object viewed as a component.

Specified by:

getIconHeight in interface Icon

Returns:

the icon height

paintIcon

public void paintIcon(Component c,
                      Graphics g,
                      int x,
                      int y)

Draw this object as an icon at the specified location using the paintable to paint the icon details.

If the component parameter c is non-null, if it is set to opaque, and if its background color is non-null, then the background color will be painted before the icon is painted.

Does nothing if the graphics context parameter g is null.

Specified by:

paintIcon in interface Icon

Parameters:

c - the component on which the icon will be painted

g - the graphics context on which to paint

x - the x-location

y - the y-location

paintComponent

protected void paintComponent(Graphics g)

Overrides the inherited paintComponent method to paint the background if the component is set to be opaque and then to use the paintable to paint the component details.

Note: The javadocs for JComponent claim that the the component background is painted if the opaque setting is true. This is not always the case in practice. In this class, we take care to see that the opaque setting is always respected.

Overrides:

paintComponent in class JComponent

Parameters:

g - the graphics context of the component that will be copied prior to any paint operations

refresh

public void refresh()

Sets the component location and size using the information in the given paintable and then refreshes the component by repacking the parent window.