Package com.luciad.view

Class TLcdLabelLocations

java.lang.Object

com.luciad.view.ALcdLabelLocations

com.luciad.view.TLcdLabelLocations

public class TLcdLabelLocations
extends ALcdLabelLocations

Implementation of ALcdLabelLocations that stores the label locations external from the domain objects.

This implementation returns the default location (specified in the constructor) when the requested information is not present.

This implementation relies on the identity of the object that is passed to the methods, so == instead of equals.

Since:

7.0

Nested Class Summary

Nested classes/interfaces inherited from class com.luciad.view.ALcdLabelLocations

ALcdLabelLocations.LabelLocationFunction

Constructor Summary

Constructors

Constructor	Description
TLcdLabelLocations(ILcdLayer aLayer, TLcdLabelLocation aDefaultLabelLocation)	Constructs a new instance with the specified default location and belonging to the specified layer.
TLcdLabelLocations(ILcdLayer aLayer, TLcdLabelLocation aDefaultLabelLocation, ILcdLabelDependencyProvider aLabelDependencyProvider)	Constructs a new instance with the specified default location and belonging to the specified layer.

Method Summary

Modifier and Type	Method	Description
void	addLabelLocationListener(ILcdLabelLocationListener aListener)	Adds the specified listener to this information store.
void	addLabelPaintedListener(ILcdLabelPaintedListener aListener)	Adds the specified listener to this information store.
void	applyOnAllLabelLocations(ILcdView aView, ALcdLabelLocations.LabelLocationFunction aLabelLocationFunction)	Iterates over all stored label locations by calling applyOnLabelLocation for every label location.
void	applyOnPaintedLabelLocations(ILcdView aView, ALcdLabelLocations.LabelLocationFunction aLabelLocationFunction)	Iterates over all label locations for the labels that were painted by calling applyOnLabelLocation for every painted label location.
void	clearAllPainted(ILcdView aView, int aEventMode)	Clears the painted status of all labels for the given ILcdView.
TLcdLabelLocation	createLabelLocation()	Creates a new TLcdLabelLocation by cloning the given default label location.
void	fireCollectedChanges(ILcdView aView)	Informs the label location listeners of the changes that were collected in putLabelLocation.
void	fireCollectedLabelPaintedChanges(ILcdView aView)	Informs the listeners registered using ALcdLabelLocations.addLabelPaintedListener(ILcdLabelPaintedListener) of the changes that were collected in ALcdLabelLocations.setPainted(Object, int, int, ILcdView, boolean, int) and ALcdLabelLocations.clearAllPainted(ILcdView, int).
void	getDefaultLabelLocationSFCT(Object aObject, int aLabelIndex, int aSubLabelIndex, ILcdView aView, TLcdLabelLocation aLocationSFCT)	Retrieves the default label location information of the specified label and puts that information in aLocationSFCT.
boolean	getLabelLocationSFCT(Object aObject, int aLabelIndex, int aSubLabelIndex, ILcdView aView, TLcdLabelLocation aLocationSFCT)	Retrieves the label location information of the specified label and puts that information in aLocationSFCT.
ILcdLayer	getLayer()	Returns the layer to which this ALcdLabelLocations instance belongs.
boolean	isPainted(Object aObject, int aLabelIndex, int aSubLabelIndex, ILcdView aView)	Returns whether or not the specified label is currently painted.
void	putLabelLocation(Object aObject, int aLabelIndex, int aSubLabelIndex, ILcdView aView, TLcdLabelLocation aLocation, int aEventMode)	Stores the given information so it can be retrieved later on.
void	removeLabelLocationListener(ILcdLabelLocationListener aListener)	Removes the specified listener.
void	removeLabelPaintedListener(ILcdLabelPaintedListener aListener)	Removes the specified listener.
void	setLayer(ILcdLayer aLayer)	Sets the layer to which this instance belongs.
void	setPainted(Object aObject, int aLabelIndex, int aSubLabelIndex, ILcdView aView, boolean aPainted, int aEventMode)	Marks the specified label as painted or not painted according to aPainted.

Methods inherited from class java.lang.Object

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

Constructor Details

TLcdLabelLocations

public TLcdLabelLocations(ILcdLayer aLayer,
 TLcdLabelLocation aDefaultLabelLocation)

Constructs a new instance with the specified default location and belonging to the specified layer.

Parameters:

aLayer - The layer to which this instance belongs. This can be null, but the layer must be set with setLayer(ILcdLayer) before any other method of this class is called.

aDefaultLabelLocation - The default location information to return when the requested label location is not available. See ALcdLabelLocations.getLabelLocationSFCT(Object, int, int, ILcdView, TLcdLabelLocation)

TLcdLabelLocations

public TLcdLabelLocations(ILcdLayer aLayer,
 TLcdLabelLocation aDefaultLabelLocation,
 ILcdLabelDependencyProvider aLabelDependencyProvider)

Constructs a new instance with the specified default location and belonging to the specified layer.

When this constructor is used, the given label dependency provider is used to place a reference to an other label in the TLcdLabelLocation instances when a requested label location is not available, see ALcdLabelLocations.getLabelLocationSFCT(java.lang.Object, int, int, com.luciad.view.ILcdView, com.luciad.view.TLcdLabelLocation).

The given label dependency provider should not contain cyclic dependencies, i.e. a label should not depend on itself (directly or indirectly). It should also return at most one parent label for each label. This parent should be a label of the same object as the the given label. So labels should not reference labels from other objects.

Parameters:

aLayer - The layer to which this instance belongs. This can be null, but the layer must be set with setLayer(ILcdLayer) before any other method of this class is called.

aDefaultLabelLocation - The default location information to return when the requested label location is not available. See ALcdLabelLocations.getLabelLocationSFCT(Object, int, int, ILcdView, TLcdLabelLocation)

aLabelDependencyProvider - a label dependency provider.

Method Details

addLabelLocationListener

public void addLabelLocationListener(ILcdLabelLocationListener aListener)

Description copied from class: ALcdLabelLocations

Adds the specified listener to this information store. This listener will be notified of changes in the label information.

Specified by:

addLabelLocationListener in class ALcdLabelLocations

Parameters:

aListener - The listener that should be informed when there are changes in the label information.

See Also:

• ALcdLabelLocations.putLabelLocation(Object, int, int, ILcdView, TLcdLabelLocation, int)

removeLabelLocationListener

public void removeLabelLocationListener(ILcdLabelLocationListener aListener)

Description copied from class: ALcdLabelLocations

Removes the specified listener. This listener will no longer be notified of changes in the label information.

Specified by:

removeLabelLocationListener in class ALcdLabelLocations

Parameters:

aListener - The listener to remove.

addLabelPaintedListener

public void addLabelPaintedListener(ILcdLabelPaintedListener aListener)

Description copied from class: ALcdLabelLocations

Adds the specified listener to this information store. The listener will be notified of changes in the label painted status with a TLcdLabelPaintedEvent.

Specified by:

addLabelPaintedListener in class ALcdLabelLocations

Parameters:

aListener - The listener that should be informed when there are changes in the painted status of a label.

See Also:

• ALcdLabelLocations.setPainted(Object, int, int, ILcdView, boolean, int)
• ALcdLabelLocations.clearAllPainted(ILcdView, int)

removeLabelPaintedListener

public void removeLabelPaintedListener(ILcdLabelPaintedListener aListener)

Description copied from class: ALcdLabelLocations

Removes the specified listener. This listener will no longer be notified of changes in the painted label information.

Specified by:

removeLabelPaintedListener in class ALcdLabelLocations

Parameters:

aListener - The listener to remove.

fireCollectedChanges

public void fireCollectedChanges(ILcdView aView)

Description copied from class: ALcdLabelLocations

Informs the label location listeners of the changes that were collected in putLabelLocation. These changes were only collected when the aEventMode parameter of this method was ILcdFireEventMode#FIRE_LATER.

The queue of collected changes is empty when this method returns.

Specified by:

fireCollectedChanges in class ALcdLabelLocations

Parameters:

aView - The ILcdView for which to fire the collected changes.

See Also:

• ALcdLabelLocations.addLabelLocationListener(ILcdLabelLocationListener)
• ALcdLabelLocations.putLabelLocation(Object, int, int, ILcdView, TLcdLabelLocation, int)

putLabelLocation

public void putLabelLocation(Object aObject,
 int aLabelIndex,
 int aSubLabelIndex,
 ILcdView aView,
 TLcdLabelLocation aLocation,
 int aEventMode)

Description copied from class: ALcdLabelLocations

Stores the given information so it can be retrieved later on.

This method also allows to remove the information: just let the TLcdLabelLocation be null.

If you specify ILcdFireEventMode#FIRE_LATER for aEventMode, you must either call ALcdLabelLocations.fireCollectedChanges(ILcdView) sometime afterward or call this method with ILcdFireEventMode#FIRE_NOW as event mode. This allows you to make multiple changes to the label locations and inform the listeners afterward in one go, which can be more efficient than informing them at each change.

Before storing the given label location, one should make sure that the bounds of the parent label are set (see TLcdLabelLocation.setParentBounds(java.awt.Rectangle, double). Examples of code that should do this are the label placer (see ILcdGXYViewLabelPlacer), the label editor, or other code that manually adjusts offset labels.

*

Specified by:

putLabelLocation in class ALcdLabelLocations

Parameters:

aObject - The domain object to which this label information applies. This object should be contained in the ILcdModel of the associated ILcdLayer

aLabelIndex - The label to which this label information applies.

aSubLabelIndex - The sub label to which this label information applies.

aView - The view for which the location applies.

aLocation - The label information. No reference to this object is kept within the implementations of this class. This allows the client of this class to reuse the same object. If this location is null, any label information already present in this instance about the given domain object, label index and sublabel index is removed from this class.

aEventMode - A code indicating if and when the listeners should be informed of this change. This code should be one of ILcdFireEventMode.FIRE_NOW, ILcdFireEventMode.FIRE_LATER or ILcdFireEventMode.NO_EVENT

See Also:

• ALcdLabelLocations.getLabelLocationSFCT(java.lang.Object, int, int, com.luciad.view.ILcdView, com.luciad.view.TLcdLabelLocation)

getLabelLocationSFCT

public boolean getLabelLocationSFCT(Object aObject,
 int aLabelIndex,
 int aSubLabelIndex,
 ILcdView aView,
 TLcdLabelLocation aLocationSFCT)

Retrieves the label location information of the specified label and puts that information in aLocationSFCT. The return value indicates whether or not the requested information was available in this store.

aObject should be contained in the ILcdModel of the ILcdLayer to which this ALcdLabelLocations belongs.

This implementation loads the default values in aLocationSFCT in case the requested information is not present. This is done by calling getDefaultLabelLocationSFCT.

Specified by:

getLabelLocationSFCT in class ALcdLabelLocations

Parameters:

aObject - The domain object for which you want to retrieve the label location information.

aLabelIndex - The label for which you want to retrieve the label location information.

aSubLabelIndex - The sub label for which you want to retrieve the label location information.

aView - The view for which the location is retrieved.

aLocationSFCT - The TLcdLabelLocation instance that will be updated with the label location information. It is up to the implementation of this class to decide what happens when the information was not available. One should use createLabelLocation to create a valid instance for this parameter.

Returns:

true if the requested label location information was available, false otherwise.

See Also:

• TLcdLabelLocations(ILcdLayer, TLcdLabelLocation)

getDefaultLabelLocationSFCT

public void getDefaultLabelLocationSFCT(Object aObject,
 int aLabelIndex,
 int aSubLabelIndex,
 ILcdView aView,
 TLcdLabelLocation aLocationSFCT)

Retrieves the default label location information of the specified label and puts that information in aLocationSFCT.

aObject should be contained in the ILcdModel of the ILcdLayer to which this ALcdLabelLocations belongs.

This implementation copies the properties of the default label location (given in the constructor) to the given label location. It also tries to add a parent label if an ILcdLabelDependencyProvider was passed in the constructor.

Overrides:

getDefaultLabelLocationSFCT in class ALcdLabelLocations

Parameters:

aObject - The domain object for which you want to retrieve the label location information.

aLabelIndex - The label for which you want to retrieve the label location information.

aSubLabelIndex - The sub label for which you want to retrieve the label location information.

aView - The view for which the location is retrieved.

aLocationSFCT - The TLcdLabelLocation instance that will be updated with the default label location information. One should use createLabelLocation to create a valid instance for this parameter.

applyOnAllLabelLocations

public void applyOnAllLabelLocations(ILcdView aView,
 ALcdLabelLocations.LabelLocationFunction aLabelLocationFunction)

Description copied from class: ALcdLabelLocations

Iterates over all stored label locations by calling applyOnLabelLocation for every label location.

If applyOnLabelLocation returns true, the iteration continues, if it returns false the iteration is aborted.

Specified by:

applyOnAllLabelLocations in class ALcdLabelLocations

Parameters:

aView - Iterate over the labels for this view.

aLabelLocationFunction - The label iterator. This label iterator contains the logic of what to do with each label.

applyOnPaintedLabelLocations

public void applyOnPaintedLabelLocations(ILcdView aView,
 ALcdLabelLocations.LabelLocationFunction aLabelLocationFunction)

Description copied from class: ALcdLabelLocations

Iterates over all label locations for the labels that were painted by calling applyOnLabelLocation for every painted label location. The iteration order is preferably the order in which they were marked as painted.

If applyOnLabelLocation returns true, the iteration continues, if it returns false the iteration is aborted.

Specified by:

applyOnPaintedLabelLocations in class ALcdLabelLocations

Parameters:

aView - Iterate over the labels painter for this view.

aLabelLocationFunction - The label iterator. This label iterator contains the logic of what to do with each label.

fireCollectedLabelPaintedChanges

public void fireCollectedLabelPaintedChanges(ILcdView aView)

Description copied from class: ALcdLabelLocations

Informs the listeners registered using ALcdLabelLocations.addLabelPaintedListener(ILcdLabelPaintedListener) of the changes that were collected in ALcdLabelLocations.setPainted(Object, int, int, ILcdView, boolean, int) and ALcdLabelLocations.clearAllPainted(ILcdView, int). These changes were only collected when the aEventMode parameter of this method was ILcdFireEventMode#FIRE_LATER.

The queue of collected changes is empty when this method returns.

Specified by:

fireCollectedLabelPaintedChanges in class ALcdLabelLocations

Parameters:

aView - The ILcdView for which to fire the collected changes.

See Also:

• ALcdLabelLocations.addLabelPaintedListener(ILcdLabelPaintedListener)
• ALcdLabelLocations.setPainted(Object, int, int, ILcdView, boolean, int)
• ALcdLabelLocations.clearAllPainted(ILcdView, int)

setPainted

public void setPainted(Object aObject,
 int aLabelIndex,
 int aSubLabelIndex,
 ILcdView aView,
 boolean aPainted,
 int aEventMode)

Description copied from class: ALcdLabelLocations

Marks the specified label as painted or not painted according to aPainted.

All code that paints a label should call this method when they actually paint a label. For instance implementations of ILcdGXYEditableLabelsLayer, ILcdGXYLayerLabelPainter and ILcdGXYViewLabelPainter should call this method when they paint a label.

Specified by:

setPainted in class ALcdLabelLocations

Parameters:

aObject - The domain object for which the label was painted.

aLabelIndex - The label index of the label that was painted.

aSubLabelIndex - The sub label index of the label that was painted.

aView - Mark the label painted or not painted on this view, according to aPainted.

aPainted - Whether or not the label should be marked as painted.

aEventMode - A code indicating if and when the listeners should be informed of this change. This code should be one of ILcdFireEventMode.FIRE_NOW, ILcdFireEventMode.FIRE_LATER or ILcdFireEventMode.NO_EVENT

See Also:

• ALcdLabelLocations.clearAllPainted(ILcdView, int)

isPainted

public boolean isPainted(Object aObject,
 int aLabelIndex,
 int aSubLabelIndex,
 ILcdView aView)

Description copied from class: ALcdLabelLocations

Returns whether or not the specified label is currently painted.

Specified by:

isPainted in class ALcdLabelLocations

Parameters:

aObject - The domain object

aLabelIndex - The label index of the label for which you want to know if it was painted.

aSubLabelIndex - The sub label index of the label for which you want to know if it was painted.

aView - The view for which we want to know if the label was painted on it.

Returns:

Whether or not the specified label was marked as painted for the given ILcdView.

See Also:

• ALcdLabelLocations.applyOnPaintedLabelLocations(com.luciad.view.ILcdView, com.luciad.view.ALcdLabelLocations.LabelLocationFunction)

clearAllPainted

public void clearAllPainted(ILcdView aView,
 int aEventMode)

Description copied from class: ALcdLabelLocations

Clears the painted status of all labels for the given ILcdView. This is typically done right before a layer (or layer label painter or view label painter etc) starts painting the labels.

Specified by:

clearAllPainted in class ALcdLabelLocations

Parameters:

aView - The view for which to clear all painted labels, or null to clear the status for all views.

aEventMode - A code indicating if and when the listeners should be informed of this change. This code should be one of ILcdFireEventMode.FIRE_NOW, ILcdFireEventMode.FIRE_LATER or ILcdFireEventMode.NO_EVENT

getLayer

public ILcdLayer getLayer()

Description copied from class: ALcdLabelLocations

Returns the layer to which this ALcdLabelLocations instance belongs.

Specified by:

getLayer in class ALcdLabelLocations

Returns:

The layer to which this ALcdLabelLocations instance belongs.

setLayer

public void setLayer(ILcdLayer aLayer)

Sets the layer to which this instance belongs. If this layer is not set in the constructor, it must be set before any other methods are called.

Parameters:

aLayer - The layer to which this instance belongs.

createLabelLocation

public TLcdLabelLocation createLabelLocation()

Creates a new TLcdLabelLocation by cloning the given default label location.

Specified by:

createLabelLocation in class ALcdLabelLocations

Returns:

A new TLcdLabelLocation.

See Also:

• TLcdLabelLocation