org.jhotdraw.draw.event

Class AbstractAttributeEditorHandler<T>

java.lang.Object

org.jhotdraw.draw.event.AbstractAttributeEditorHandler<T>

All Implemented Interfaces:

Disposable

Direct Known Subclasses:

DrawingAttributeEditorHandler, FigureAttributeEditorHandler

public abstract class AbstractAttributeEditorHandler<T>
extends java.lang.Object
implements Disposable

AbstractAttributeEditorHandler mediates between an AttributeEditor and the currently selected Figure's in a DrawingEditor. Design Patterns

Observer
Selection changes of DrawingView are observed by user interface components:
Subject: DrawingView; Observer: FigureSelectionListener; Concrete-Observer: AbstractAttributeEditorHandler, SelectionComponentDisplayer, SelectionComponentRepainter.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	AbstractAttributeEditorHandler.EventHandler

Field Summary

Fields

Modifier and Type	Field and Description
protected DrawingView	activeView
protected AttributeEditor<T>	attributeEditor
protected AttributeKey<T>	attributeKey
protected java.util.LinkedList<java.lang.Object>	attributeRestoreData
protected java.util.Map<AttributeKey,java.lang.Object>	defaultAttributes
protected DrawingEditor	editor
protected int	updateDepth
protected DrawingView	view

Constructor Summary

Constructors

Constructor and Description
AbstractAttributeEditorHandler(AttributeKey<T> key, AttributeEditor<T> attributeEditor, DrawingEditor drawingEditor)
AbstractAttributeEditorHandler(AttributeKey<T> key, AttributeEditor<T> attributeEditor, DrawingEditor drawingEditor, boolean updateDrawingEditorDefaults)
AbstractAttributeEditorHandler(AttributeKey<T> key, java.util.Map<AttributeKey,java.lang.Object> defaultAttributes, AttributeEditor<T> attributeEditor, DrawingEditor drawingEditor, boolean updateDrawingEditorDefaults)

Method Summary

Modifier and Type	Method and Description
void	dispose() Disposes of all resources held by this object so that they can be garbage collected.
protected DrawingView	getActiveView()
AttributeEditor<T>	getAttributeEditor() Returns the AttributeEditor to which this FigureAttributeEditorHandler is attached.
AttributeKey<T>	getAttributeKey()
protected abstract java.util.Set<Figure>	getEditedFigures()
DrawingEditor	getEditor() Returns the DrawingEditor to which this FigureAttributeEditorHandler is attached.
DrawingView	getView() Returns the DrawingView to which this FigureAttributeEditorHandler is attached.
boolean	isUpdateDrawingEditorDefaults() Returns true if the attribute editor updates the default values of the drawing editor.
void	setAttributeEditor(AttributeEditor<T> newValue) Attaches the FigureAttributeEditorHandler to the specified AttributeEditor.
void	setAttributeKey(AttributeKey<T> newValue)
void	setEditor(DrawingEditor newValue) Attaches the FigureAttributeEditorHandler to the specified DrawingEditor.
void	setUpdateDrawingEditorDefaults(boolean newValue) Set this to true if you want the attribute editor to update the default values of the drawing editor.
void	setView(DrawingView newValue) Attaches the FigureAttributeEditorHandler to the specified DrawingView.
protected void	updateActiveView()
protected void	updateAttributeEditor()
protected void	updateFigures()

Methods inherited from class java.lang.Object

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

Field Detail

editor

protected DrawingEditor editor

view

protected DrawingView view

activeView

protected DrawingView activeView

attributeEditor

protected AttributeEditor<T> attributeEditor

attributeKey

protected AttributeKey<T> attributeKey

updateDepth

protected int updateDepth

attributeRestoreData

protected java.util.LinkedList<java.lang.Object> attributeRestoreData

defaultAttributes

protected java.util.Map<AttributeKey,java.lang.Object> defaultAttributes

Constructor Detail

AbstractAttributeEditorHandler

public AbstractAttributeEditorHandler(AttributeKey<T> key,
                                      AttributeEditor<T> attributeEditor,
                                      DrawingEditor drawingEditor)

AbstractAttributeEditorHandler

public AbstractAttributeEditorHandler(AttributeKey<T> key,
                                      AttributeEditor<T> attributeEditor,
                                      DrawingEditor drawingEditor,
                                      boolean updateDrawingEditorDefaults)

AbstractAttributeEditorHandler

public AbstractAttributeEditorHandler(AttributeKey<T> key,
                                      java.util.Map<AttributeKey,java.lang.Object> defaultAttributes,
                                      AttributeEditor<T> attributeEditor,
                                      DrawingEditor drawingEditor,
                                      boolean updateDrawingEditorDefaults)

Method Detail

setEditor

public void setEditor(DrawingEditor newValue)

Attaches the FigureAttributeEditorHandler to the specified DrawingEditor.

The FigureAttributeEditorHandler listens to view changes and selection changes of the drawing editor and calls setEnabled(boolean) and updateField(Set<Figure>) on the field accordingly.

Parameters:

newValue - a drawing editor.

getEditor

public DrawingEditor getEditor()

Returns the DrawingEditor to which this FigureAttributeEditorHandler is attached.

setView

public void setView(DrawingView newValue)

Attaches the FigureAttributeEditorHandler to the specified DrawingView.

If a non-null value is provided, the FigureAttributeEditorHandler listens only to selection changes of the specified view. If a null value is provided, the FigureAttributeEditorHandler listens to all views of the drawing editor.

Parameters:

newValue - a drawing view.

getView

public DrawingView getView()

Returns the DrawingView to which this FigureAttributeEditorHandler is attached. Returns null, if the FigureAttributeEditorHandler is attached to all views of the DrawingEditor.

setUpdateDrawingEditorDefaults

public void setUpdateDrawingEditorDefaults(boolean newValue)

Set this to true if you want the attribute editor to update the default values of the drawing editor.

Parameters:

newValue -

isUpdateDrawingEditorDefaults

public boolean isUpdateDrawingEditorDefaults()

Returns true if the attribute editor updates the default values of the drawing editor.

getActiveView

protected DrawingView getActiveView()

setAttributeEditor

public void setAttributeEditor(AttributeEditor<T> newValue)

Attaches the FigureAttributeEditorHandler to the specified AttributeEditor.

getAttributeEditor

public AttributeEditor<T> getAttributeEditor()

Returns the AttributeEditor to which this FigureAttributeEditorHandler is attached.

getAttributeKey

public AttributeKey<T> getAttributeKey()

setAttributeKey

public void setAttributeKey(AttributeKey<T> newValue)

updateActiveView

protected void updateActiveView()

getEditedFigures

protected abstract java.util.Set<Figure> getEditedFigures()

updateAttributeEditor

protected void updateAttributeEditor()

updateFigures

protected void updateFigures()

dispose

public void dispose()

Description copied from interface: Disposable

Disposes of all resources held by this object so that they can be garbage collected.

Specified by:

dispose in interface Disposable