org.openide.text
Class Annotation

java.lang.Object
  |
  +--org.openide.text.Annotation

public abstract class Annotation

extends Object

Description of annotation. The class is extended by modules which creates annotations and defines annotation type and tooltip. The annotation can be attached to Annotatable object. Editors which displays Annotations listen on PropertyChangeListner for changes of annotation type or tooltip text. The tooltip text can be evaluated asynchronously. It means that editors after the getShortDescription call must listen on PropertyChangeListner while the tooltip is visible. If the tooltip text property is changed, the tooltip value must be updated.

Since:

1.20

Field Summary

static String	PROP_ANNOTATION_TYPE Property name of the annotation type
static String	PROP_MOVE_TO_FRONT Virtual property which does not have getter/setter.
static String	PROP_SHORT_DESCRIPTION Property name of the tip text

Constructor Summary

Annotation()

Method Summary

void	addPropertyChangeListener(PropertyChangeListener l) Add listeners on changes of annotation properties
void	attach(Annotatable anno) Attach annotation to Annotatable object.
void	detach() Detach annotation.
protected void	firePropertyChange(String propertyName, Object oldValue, Object newValue) Fire property change to registered listeners.
abstract String	getAnnotationType() Returns name of the file which describes the annotation type.
Annotatable	getAttachedAnnotatable() Gets annotatable object to which this annotation is attached.
abstract String	getShortDescription() Returns the tooltip text for this annotation.
void	moveToFront() Helper method for moving annotation which is covered by other annotations on the same line in front of others.
protected void	notifyAttached(Annotatable toAnno) Notifies the annotation that it was attached to the annotatable.
protected void	notifyDetached(Annotatable fromAnno) Notifies the annotation that it was detached from the annotatable.
void	removePropertyChangeListener(PropertyChangeListener l) Remove listeners on changes of annotation properties

Methods inherited from class java.lang.Object

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

Field Detail

PROP_SHORT_DESCRIPTION

public static final String PROP_SHORT_DESCRIPTION

Property name of the tip text

PROP_ANNOTATION_TYPE

public static final String PROP_ANNOTATION_TYPE

Property name of the annotation type

PROP_MOVE_TO_FRONT

public static final String PROP_MOVE_TO_FRONT

Virtual property which does not have getter/setter. When change on this property is fired, listeners (= editors) must ensure that this annotation is not covered by some other annotation which is on the same line - annotation must be moved in front of others. See also moveToFront() method.

Since:

1.27

Constructor Detail

Annotation

public Annotation()

Method Detail

getAnnotationType

public abstract String getAnnotationType()

Returns name of the file which describes the annotation type. The file must be defined in module installation layer in the directory "Editors/AnnotationTypes"

Returns:

name of the anotation type

getShortDescription

public abstract String getShortDescription()

Returns the tooltip text for this annotation.

Returns:

tooltip for this annotation

attach

public final void attach(Annotatable anno)

Attach annotation to Annotatable object.

Parameters:

anno - annotatable class to which this annotation will be attached

notifyAttached

protected void notifyAttached(Annotatable toAnno)

Notifies the annotation that it was attached to the annotatable.

Parameters:

toAnno - annotatable to which the annotation was attached.

Since:

1.38

detach

public final void detach()

Detach annotation.

notifyDetached

protected void notifyDetached(Annotatable fromAnno)

Notifies the annotation that it was detached from the annotatable.

Parameters:

fromAnno - annotatable from which the annotation was detached.

Since:

1.38

getAttachedAnnotatable

public final Annotatable getAttachedAnnotatable()

Gets annotatable object to which this annotation is attached.

Returns:

null if annotation is not attached or reference to annotatable object.

Since:

1.27

addPropertyChangeListener

public final void addPropertyChangeListener(PropertyChangeListener l)

Add listeners on changes of annotation properties

Parameters:

l - change listener

removePropertyChangeListener

public final void removePropertyChangeListener(PropertyChangeListener l)

Remove listeners on changes of annotation properties

Parameters:

l - change listener

firePropertyChange

protected final void firePropertyChange(String propertyName,
                                        Object oldValue,
                                        Object newValue)

Fire property change to registered listeners.

moveToFront

public final void moveToFront()

Helper method for moving annotation which is covered by other annotations on the same line in front of others. The method fires change on PROP_MOVE_TO_FRONT property on which editors must listen and do the fronting of the annotation. Whether the annotation is visible in editor or not is not guaranteed by this method - use Line.show instead.

Since:

1.27