org.itsnat.comp.label

Interface ItsNatLabel

All Superinterfaces:

ItsNatComponent, ItsNatElementComponent, ItsNatUserData

All Known Subinterfaces:

ItsNatFreeLabel, ItsNatHTMLLabel

public interface ItsNatLabel
extends ItsNatElementComponent

Is the base interface of label components.

A label component contains a single object value, this value is rendered as markup using a special object, the renderer, and may be optionally edited "in place" using a user defined editor.

Any change to the internal value is notified with a "value" property change event and may be vetoed (see setValue(Object). The new value, if accepted, is rendered as markup.

This component family is the "componentized" version of ElementLabel and follows a similar philosophy.

Author:

Jose Maria Arranz Santamaria

Method Summary

Methods

Modifier and Type	Method and Description
String	getEditorActivatorEvent() Returns the event type used to activate the label edition process by the user.
ItsNatLabelEditor	getItsNatLabelEditor() Returns the current label editor.
ItsNatLabelRenderer	getItsNatLabelRenderer() Returns the current component renderer.
ItsNatLabelUI	getItsNatLabelUI() Returns the user interface manager of this component.
Object	getValue() Returns the current value.
boolean	isEditing() Informs whether the label value is being edited.
boolean	isEditingEnabled() Informs whether the in place edition is enabled.
void	setEditingEnabled(boolean value) Enables or disables temporally the in place edition.
void	setEditorActivatorEvent(String eventType) Sets the event type used to activate the label edition process by the user.
void	setItsNatLabelEditor(ItsNatLabelEditor editor) Sets the label editor.
void	setItsNatLabelRenderer(ItsNatLabelRenderer renderer) Sets the component renderer.
void	setValue(Object value) Sets the value.
void	startEditing() Used to start programmatically the label edition process "in place".

Methods inherited from interface org.itsnat.comp.ItsNatElementComponent

getElement, getItsNatElementComponentUI

Methods inherited from interface org.itsnat.comp.ItsNatComponent

addEventListener, addEventListener, addEventListener, addEventListener, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, disableEventListener, disableEventListener, dispose, enableEventListener, enableEventListener, getArtifact, getArtifact, getItsNatComponentManager, getItsNatComponentUI, getItsNatDocument, getNode, getPropertyChangeListeners, getPropertyChangeListeners, getVetoableChangeListeners, isDisposed, isEnabled, registerArtifact, removeArtifact, removeEventListener, removeEventListener, removeEventListener, removeEventListener, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, setEnabled, setEventListenerParams, setEventListenerParams, setNode

Methods inherited from interface org.itsnat.core.ItsNatUserData

containsUserValueName, getUserValue, getUserValueNames, removeUserValue, setUserValue

Method Detail

getItsNatLabelUI

ItsNatLabelUI getItsNatLabelUI()

Returns the user interface manager of this component.

Returns:

the user interface manager.

getValue

Object getValue()

Returns the current value.

Returns:

the current value. The default value is null.

setValue

void setValue(Object value)
              throws PropertyVetoException

Sets the value. The new value will be rendered automatically to markup.

This new value is "voted" before is set firing a java.beans.PropertyChangeEvent event, with name "value", sent to the listeners registered with ItsNatComponent.addVetoableChangeListener(VetoableChangeListener) if some listener does a "veto" (throws a java.beans.PropertyVetoException) the new value is not set. If finally set the PropertyChangeEvent event is sent to the listeners registered with ItsNatComponent.addPropertyChangeListener(java.beans.PropertyChangeListener) or ItsNatComponent.addPropertyChangeListener(String,java.beans.PropertyChangeListener) with property name "value".

Parameters:

value - value to display (and may be edit).

Throws:

PropertyVetoException - if the new value was vetoed.

getItsNatLabelRenderer

ItsNatLabelRenderer getItsNatLabelRenderer()

Returns the current component renderer. This renderer converts the label value to markup.

Returns:

the current renderer. By default uses the default renderer (ItsNatComponentManager.createDefaultItsNatLabelRenderer())

See Also:

setItsNatLabelRenderer(ItsNatLabelRenderer)

setItsNatLabelRenderer

void setItsNatLabelRenderer(ItsNatLabelRenderer renderer)

Sets the component renderer.

Parameters:

renderer - the new renderer.

See Also:

getItsNatLabelRenderer()

getItsNatLabelEditor

ItsNatLabelEditor getItsNatLabelEditor()

Returns the current label editor. This object is used to edit in place the current label value.

Returns:

the current editor. By default uses the default editor calling (ItsNatComponentManager.createDefaultItsNatLabelEditor(ItsNatComponent)) with a null parameter.

See Also:

setItsNatLabelEditor(ItsNatLabelEditor)

setItsNatLabelEditor

void setItsNatLabelEditor(ItsNatLabelEditor editor)

Sets the label editor.

This component automatically adds a listener calling javax.swing.CellEditor.addCellEditorListener(javax.swing.event.CellEditorListener) this way the component is informed when the editor stops or cancels editing.

The edition process starts programmatically by calling startEditing() or by user action (usually double clicking the label or the action/event type specified by getEditorActivatorEvent()). Then the label markup (below the parent element) is removed and the method ItsNatLabelEditor.getLabelEditorComponent(ItsNatLabel,Object,Element) is called, this method usually places the editor component inside the label. Current label implementations do nothing with the editor component returned and may be null.

When the editor stops the component calls CellEditor.getCellEditorValue() to obtain the new value and sets this value to the label (calling setValue(Object)) and the editor is removed and the original label markup is restored modified by the renderer with the new value. If the editor is cancelled all is the same but no markup change is made.

Parameters:

editor - the new editor. May be null (edition disabled).

See Also:

getItsNatLabelEditor()

startEditing

void startEditing()

Used to start programmatically the label edition process "in place".

See Also:

isEditing()

isEditing

boolean isEditing()

Informs whether the label value is being edited.

Returns:

true if the label is being edited.

See Also:

startEditing()

getEditorActivatorEvent

String getEditorActivatorEvent()

Returns the event type used to activate the label edition process by the user.

If returns null edition activated by events is disabled .

Returns:

the event type used to activate the edition. By default is "dblclick".

See Also:

setEditorActivatorEvent(String)

setEditorActivatorEvent

void setEditorActivatorEvent(String eventType)

Sets the event type used to activate the label edition process by the user.

Parameters:

eventType - the event type used to activate the edition.

See Also:

getEditorActivatorEvent()

isEditingEnabled

boolean isEditingEnabled()

Informs whether the in place edition is enabled.

Returns:

false if the editing in place is temporally disabled. True by default.

See Also:

setEditingEnabled(boolean)

setEditingEnabled

void setEditingEnabled(boolean value)

Enables or disables temporally the in place edition.

Parameters:

value - true to enable in place edition.

See Also:

isEditingEnabled()