charger

Class CanvasPanel

Object

Component

Container

JComponent

JPanel

charger.CanvasPanel

All Implemented Interfaces:

ActionListener, ImageObserver, MenuContainer, Serializable, EventListener, Accessible, Scrollable

public class CanvasPanel
extends JPanel
implements Scrollable, ActionListener

The drawing area for the edit frame. communicates with its enclosing EditFrame by the ef variable.

Author:

Harry S. Delugach ( delugach@uah.edu ) Copyright (c) 1998-2020 by Harry S. Delugach.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
EditFrame	ef The enclosing editing frame.
private FocusAdapter	focusAdapter
private BufferedImage	image
JComboBox	labelChooser Popup menu used when a text label is constrained to a list of known labels for that kind
private WindowAdapter	nedWindowAdapter
JDialog	nodeEditingDialog
private boolean	nodeEditingDialogUndecorated
(package private) KeyAdapter	nodeEditingKeyAdapter Implements copy/cut/paste for text
private Dimension	preferredSize
private int	scalingAlgorithm
private GraphObject	userEditedGraphObject indicates which GNode whose text the user is currently editing; null if no editing.

Fields inherited from class JComponent

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

Fields inherited from class Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
CanvasPanel(EditFrame outerFrame)

Method Summary

Modifier and Type	Method and Description
void	actionPerformed(ActionEvent e) Only handles changes to text.
void	adjustCanvasSize() Figures out how much canvas and buffered image is needed, and if the current ones aren't sufficient, makes them big enough.
boolean	choicePossible(GraphObject go) Determines whether a pull-down menu is possible for this object.
void	closeTextEditors() Hide the editing field, pop-up menu, re-set the editing menu and cursor.
JComboBox	createLabelChooser(FontMetrics fontMetrics, String label, Color fore, Color back) Factory method to create a label chooser that will set up appearance, based on the parameters and userEditedGraphObject
private void	createNodeEditingDialog()
private JTextField	createTextEditField(FontMetrics fontMetrics, String label, Color fore, Color back) set up the text labeling field .
protected void	finalize() Dispose of the canvas panel; should not be called directly.
private Dimension	getEditingTextSize(FontMetrics fontMetrics, String label) Determines the width and height needed for the textediting activites.
Dimension	getPreferredScrollableViewportSize()
Dimension	getPreferredSize()
int	getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
boolean	getScrollableTracksViewportHeight()
boolean	getScrollableTracksViewportWidth()
int	getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
void	keyReleased(KeyEvent e)
void	keyTyped(KeyEvent e)
void	paintComponent(Graphics g) Renders everything on the canvas.
void	reset() In case the user stops in the middle of something.
void	setup() Sets up the textLabelEditField and labelChooser components.
void	teardown()
void	userFinishedEditingText(String userEditedLabel) Once the user leaves the edit field, take over and process the new contents.
void	userStartedEditingText(GraphObject go, Point2D.Double p) Sets up the text field for a user to edit.

Methods inherited from class JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class Container

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

Methods inherited from class 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, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, 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, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class Object

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

Field Detail

ef

public EditFrame ef

The enclosing editing frame.

scalingAlgorithm

private int scalingAlgorithm

nodeEditingDialogUndecorated

private boolean nodeEditingDialogUndecorated

userEditedGraphObject

private GraphObject userEditedGraphObject

indicates which GNode whose text the user is currently editing; null if no editing.

labelChooser

public JComboBox labelChooser

Popup menu used when a text label is constrained to a list of known labels for that kind

nodeEditingDialog

public JDialog nodeEditingDialog

preferredSize

private Dimension preferredSize

image

private BufferedImage image

focusAdapter

private FocusAdapter focusAdapter

nedWindowAdapter

private WindowAdapter nedWindowAdapter

nodeEditingKeyAdapter

KeyAdapter nodeEditingKeyAdapter

Implements copy/cut/paste for text

Constructor Detail

CanvasPanel

CanvasPanel(EditFrame outerFrame)

Method Detail

setup

public void setup()

Sets up the textLabelEditField and labelChooser components.

teardown

public void teardown()

createNodeEditingDialog

private void createNodeEditingDialog()

createTextEditField

private JTextField createTextEditField(FontMetrics fontMetrics,
                                       String label,
                                       Color fore,
                                       Color back)

set up the text labeling field .

createLabelChooser

public JComboBox createLabelChooser(FontMetrics fontMetrics,
                                    String label,
                                    Color fore,
                                    Color back)

Factory method to create a label chooser that will set up appearance, based on the parameters and userEditedGraphObject

Parameters:

fontMetrics -

label -

fore -

back -

Returns:

the created label chooser combo box

See Also:

userEditedGraphObject

getEditingTextSize

private Dimension getEditingTextSize(FontMetrics fontMetrics,
                                     String label)

Determines the width and height needed for the textediting activites. Adds 25% padding to the height. doubles the width of the minimum space needed for the label. Adjust itself if the width is too short or too long.

Parameters:

fontMetrics -

label -

Returns:

A size that will amply fit the label in both dimensions using the font metrics' font.

finalize

protected void finalize()
                 throws Throwable

Dispose of the canvas panel; should not be called directly.

Overrides:

finalize in class Object

Throws:

Throwable

actionPerformed

public void actionPerformed(ActionEvent e)

Only handles changes to text. Other graphic changes are handled by the EditFrame's mouse handlers.

Specified by:

actionPerformed in interface ActionListener

adjustCanvasSize

public void adjustCanvasSize()

Figures out how much canvas and buffered image is needed, and if the current ones aren't sufficient, makes them big enough. Leaves 25% extra room on the canvas for expansion.

paintComponent

public void paintComponent(Graphics g)

Renders everything on the canvas.

Overrides:

paintComponent in class JComponent

reset

public void reset()

In case the user stops in the middle of something. Closes the editing text box.

choicePossible

public boolean choicePossible(GraphObject go)

Determines whether a pull-down menu is possible for this object.

Parameters:

go - Any graph object

Returns:

Whether it makes sense to do a pull-down menu for this object's label.

userStartedEditingText

public void userStartedEditingText(GraphObject go,
                                   Point2D.Double p)

Sets up the text field for a user to edit. Control is then passed to the user. Displays default prompt in the message box.

Parameters:

go - The object whose label the user is editing.

p - Where the edit field dialog is to appear on the canvas.

See Also:

userFinishedEditingText(java.lang.String)

userFinishedEditingText

public void userFinishedEditingText(String userEditedLabel)

Once the user leaves the edit field, take over and process the new contents.

Parameters:

userEditedLabel - new label name; could have been obtained from a choice list. null if user cancelled or otherwise didn't make a new label name.

See Also:

userStartedEditingText(charger.obj.GraphObject, java.awt.geom.Point2D.Double), actionPerformed(java.awt.event.ActionEvent)

closeTextEditors

public void closeTextEditors()

Hide the editing field, pop-up menu, re-set the editing menu and cursor. //Set all objects as unchanged (to disable erroneous display and/or

getPreferredSize

public Dimension getPreferredSize()

Overrides:

getPreferredSize in class JComponent

getPreferredScrollableViewportSize

public Dimension getPreferredScrollableViewportSize()

Specified by:

getPreferredScrollableViewportSize in interface Scrollable

getScrollableBlockIncrement

public int getScrollableBlockIncrement(Rectangle visibleRect,
                                       int orientation,
                                       int direction)

Specified by:

getScrollableBlockIncrement in interface Scrollable

getScrollableTracksViewportHeight

public boolean getScrollableTracksViewportHeight()

Specified by:

getScrollableTracksViewportHeight in interface Scrollable

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()

Specified by:

getScrollableTracksViewportWidth in interface Scrollable

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle visibleRect,
                                      int orientation,
                                      int direction)

Specified by:

getScrollableUnitIncrement in interface Scrollable

keyReleased

public void keyReleased(KeyEvent e)

keyTyped

public void keyTyped(KeyEvent e)