public class TLcdGXYDataObjectLabelPainter extends TLcdGXYLabelPainter implements ILcdGXYLabelPainter
TLcdGXYLabelPainter
that retrieves the label content through
the ILcdDataObject
interface instead of using object.toString()
.
It therefore assumes that the object of the label to paint (given in TLcdGXYLabelPainter.setObject(Object)
)
implements the ILcdDataObject
interface. In order to build the label content
(see retrieveLabels
), it computes
the value of the expression specified using setExpressions(String...)
.
Expressions are converted into labels using this object's data object expression language
. The default data object language expression of this label
painter is TLcdDataObjectExpressionLanguage
.
Note that in case the label content can't be expressed using the data object expression language,
it is advised to tailor retrieveLabels(int, com.luciad.view.gxy.ILcdGXYContext)
to the
specific needs.ALcdDataObjectExpressionLanguage
,
Serialized FormLABEL_TEXT_ALIGNMENT_CENTER, LABEL_TEXT_ALIGNMENT_DEFAULT, LABEL_TEXT_ALIGNMENT_LEFT, LABEL_TEXT_ALIGNMENT_RIGHT
CENTER, EAST, MAXIMUM_AVAILABLE_LOCATIONS, NORTH, NORTH_EAST, NORTH_WEST, SOUTH, SOUTH_EAST, SOUTH_WEST, WEST
DEFAULT, SELECTED
BODY, CREATING, HANDLES, RESHAPING, SNAPS, TRANSLATING
CREATING, END_CREATION, RESHAPED, START_CREATION, TRANSLATED
Constructor and Description |
---|
TLcdGXYDataObjectLabelPainter()
Creates a new
TLcdGXYDataObjectLabelPainter . |
TLcdGXYDataObjectLabelPainter(ALcdGXYInteractiveLabelProvider aGXYInteractiveLabelProvider)
Creates a new
TLcdGXYDataObjectLabelPainter . |
TLcdGXYDataObjectLabelPainter(TLcdGXYDataObjectLabelPainter aLabelPainter)
Copy constructor.
|
Modifier and Type | Method and Description |
---|---|
boolean |
acceptSnapTargetForLabel(Graphics aGraphics,
ILcdGXYContext aGXYContext)
Returns whether the label specified by
setObject , setLabelIndex and
setSubLabelIndex accepts the snap target in the given
ILcdGXYContext . |
protected void |
addComponentToGXYView(ILcdGXYView aGXYView,
Component aComponent)
Adds the specified interactive label to the user interface.
|
protected void |
anchorPointSFCT(Graphics aGraphics,
int aMode,
ILcdGXYContext aContext,
Point aPointSFCT)
Retrieves an anchor point that is used to determine where the pin
of the label (specified by
setObject , setLabelIndex and
setSubLabelIndex ) attaches to the object representation. |
protected boolean |
canAddComponentToGXYView(ILcdGXYView aGXYView)
Returns whether or not an interactive label can be added to the given view.
|
void |
cancelLabelInteraction()
Cancels the interactive label, if there is one.
|
boolean |
canStopLabelInteraction()
Returns whether or not the label interaction can be stopped.
|
void |
clearImageCache()
Clears the entire label image cache.
|
void |
clearImageCache(Object aObject)
Clears the label image cache for the given object.
|
Object |
clone()
Returns a new instance of this
ALcdGXYLabelPainter . |
boolean |
editLabel(Graphics aGraphics,
int aMode,
ILcdGXYContext aGXYContext)
Adapts the set
TLcdLabelLocation according to the information present in
aGXYContext. |
protected void |
firePropertyChangeEvent(PropertyChangeEvent aPropertyChangeEvent)
Notifies the registered
PropertyChangeListener s of the specified event. |
protected Component |
getComponentForGXYView(ILcdGXYView aGXYView)
Gets the component that represents the given
ILcdGXYView . |
ALcdDataObjectExpressionLanguage |
getDataObjectExpressionLanguage()
Returns the data object expression language used by this label painter.
|
String |
getDisplayName()
This default implementation returns the display name set with
setDisplayName , or toString() if this was set to null . |
Object |
getDomainObjectForInteractiveLabel()
Returns the domain object for the interactive label, or
null if there is no
interactive label. |
String[] |
getExpressions()
Returns the expressions that are
evaluated to compute the label of the object.
|
ALcdGXYInteractiveLabelProvider |
getGXYInteractiveLabelProvider()
Returns the interactive label provider.
|
ILcdGXYLabelEditor |
getGXYLabelEditor(Object aObject)
Returns a valid
ILcdGXYLabelEditor for editing the labels of aObject. |
ALcdGXYLabelStamp |
getGXYLabelStamp()
Returns the
ALcdGXYLabelStamp that is used by this painter to paint the labels. |
TLcdHaloAlgorithm |
getHaloAlgorithm()
Returns the algorithm that is used for rendering halo's.
|
Color |
getHaloColor()
Returns the current halo color.
|
Color |
getHaloPinColor()
Returns the current halo pin color.
|
int |
getHaloThickness()
Returns the current halo thickness.
|
int |
getLabelCreationClickCount()
Returns the number of points required to initialize the label of the set
Object . |
Cursor |
getLabelCursor(Graphics aGraphics,
int aMode,
ILcdGXYContext aGXYContext)
Returns a
Cursor to indicate the type of editing aMode and
aGXYContext . |
Color |
getPinColor()
Returns the color in which the pin is drawn.
|
String |
getPositionAsString(int aPosition)
Returns the string representation of the given position of the labels relative to the anchor point.
|
int[] |
getPositionList()
Returns the list of possible positions to place the labels.
|
String[] |
getPositionListAsString()
Gets the
String representations of the current position list. |
int |
getPossibleLocationCount(Graphics aGraphics)
Returns the number of possible locations to use (starting from the default position).
|
Color |
getSelectedPinColor()
Returns the color in which the pin should be drawn of the label of a selected object.
|
int |
getShiftLabelPosition()
Returns how many pixels the label must be removed from the anchor point of the domain object.
|
boolean |
isHaloEnabled()
Returns true if the halo effect is on for the labels, false otherwise.
|
boolean |
isHaloPinEnabled()
Returns true if the halo effect also includes the pin.
|
boolean |
isLabelTouched(Graphics aGraphics,
int aMode,
ILcdGXYContext aGXYContext)
Tests if the label specified by
setObject , setLabelIndex and
setSubLabelIndex is touched at view location (specified by
aGXYContext.getX() and aGXYContext.getY() ), considering the mode and the
ILcdGXYContext instance. |
boolean |
isMakeLabelsStickyOnEdit()
Returns whether the labels this editor edits are made sticky.
|
boolean |
isUseImageCache()
Returns
true when image caching for labels with a halo is enabled,
false otherwise. |
boolean |
isWithAnchorPoint()
Returns whether to draw an anchor point at
anchorPointSFCT . |
boolean |
isWithPin()
Returns whether a pin is drawn from the object to the label.
|
void |
labelAnchorPointSFCT(Graphics aGraphics,
int aMode,
ILcdGXYContext aGXYContext,
Point aPointSFCT)
Sets
aPointSFCT to the anchor point of the label specified by
setObject , setLabelIndex and setSubLabelIndex . |
double |
labelBoundsSFCT(Graphics aGraphics,
int aMode,
ILcdGXYContext aContext,
Rectangle aRectangle)
Calculates the bounds of the label that can be painted.
|
Object |
labelSnapTarget(Graphics aGraphics,
ILcdGXYContext aGXYContext)
Returns an
Object that can be used as snapping target when graphically editing
another Object or label than the one this ILcdGXYLabelPainter2 represents. |
protected void |
removeComponentFromGXYView(ILcdGXYView aGXYView,
Component aComponent)
Removes the specified
java.awt.Component from the user interface. |
protected String[] |
retrieveLabels(int aMode,
ILcdGXYContext aGXYContext)
Returns an array containing the lines of text for a single label.
|
static void |
setClassTraceOn(boolean aClassTraceOn)
Deprecated.
This method has been deprecated. It is recommended to use the
standard Java logging framework directly.
|
void |
setDataObjectExpressionLanguage(ALcdDataObjectExpressionLanguage aExpressionLanguage)
Sets the data object expression language used by this label painter.
|
void |
setExpressions(String... aExpressions)
Sets the expressions whose evaluation yields the label for the object.
|
void |
setGXYInteractiveLabelProvider(ALcdGXYInteractiveLabelProvider aGXYInteractiveLabelProvider)
Deprecated.
this is controller logic. Use
TLcdGXYInteractiveLabelsController instead. |
void |
setHaloAlgorithm(TLcdHaloAlgorithm aHaloAlgorithm)
Sets the algorithm to be used for rendering halo's.
|
void |
setHaloColor(Color aColor)
Sets the color of the halo to be added around labels.
|
void |
setHaloEnabled(boolean aHaloEnabled)
Switches the halo effect for the labels on or off.
|
void |
setHaloPinColor(Color aColor)
Sets the color of the halo to be added around pins.
|
void |
setHaloPinEnabled(boolean aHaloPinEnabled)
Sets if the halo effect should be applied to the pin.
|
void |
setHaloThickness(int aThickness)
Sets the thickness (in pixels) of the halo to be added around labels.
|
void |
setMakeLabelsStickyOnEdit(boolean aMakeLabelsStickyOnEdit)
Sets whether or not this editor should set the label edit mode of the edited labels to include the sticky flag.
|
void |
setPinColor(Color aPinColor)
Sets the color in which the pin should be drawn.
|
void |
setPositionList(int[] aPositionList)
Sets a new position list.
|
void |
setPositionListAsString(String[] aPositionList)
The labels can occupy various positions relative to the anchor point
(see description above).
|
void |
setProvideInteractiveLabelOnMouseOver(boolean aProvideInteractiveLabelOnMouseOver)
Deprecated.
this is controller logic. Use
TLcdGXYInteractiveLabelsController instead. |
void |
setSelectedPinColor(Color aSelectedPinColor)
Sets the color in which the pin of the label of a selected label should be drawn.
|
void |
setShiftLabelPosition(int aShift)
Sets how many pixels the label must be removed from the anchor point of the domain object.
|
void |
setUseImageCache(boolean aUseCache)
Sets whether or not labels with halos should be cached as images.
|
void |
setWithAnchorPoint(boolean aWithAnchorPoint)
Determines whether to draw an anchor point at
anchorPointSFCT . |
void |
setWithPin(boolean aWithPin)
The property
withPin determines whether a pin should be drawn from the object to
the label. |
void |
startLabelInteraction(Object aDomainObject,
int aLabelIndex,
int aSubLabelIndex,
ILcdGXYContext aGXYContext)
Configure an interactive label for the specified label and show it in the GUI.
|
boolean |
stopLabelInteraction()
Stops the interactive label, if there is one.
|
calculateMaxLabelWidth, getBackground, getFont, getForeground, getFrameColor, getGXYLabelPainter, getLabelTextAlignmentMode, getPadding, getPinPointSFCT, getSelectionColor, getUpperLeftPointSFCT, getVerticalSpacing, isAntiAliased, isConsiderPinForBounds, isFilled, isFrame, labelPositionForLocationIndexSFCT, paintLabel, paintLabel, paintPin, pinPointSFCT, retrieveLabels, setAntiAliased, setBackground, setConsiderPinForBounds, setFilled, setFont, setForeground, setFrame, setFrameColor, setGXYLabelStamp, setLabelIndex, setLabelTextAlignmentMode, setObject, setPadding, setSelectionColor, setSubLabelIndex, setVerticalSpacing
addPropertyChangeListener, getLabelCount, getLabelIndex, getLabelLocation, getLocationIndex, getObject, getSubLabelCount, getSubLabelIndex, removePropertyChangeListener, setDisplayName, setLabelLocation, setLocationIndex, supportLabelSnap
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
getLocationIndex, getObject, getPossibleLocationCount, labelBoundsSFCT, paintLabel, setLocationIndex, setObject
getLabelLocation, setLabelLocation, supportLabelSnap
getLabelCount, getLabelIndex, getSubLabelCount, getSubLabelIndex
getLabelCount, getLabelIndex, getLabelLocation, getObject, getSubLabelCount, getSubLabelIndex, setLabelLocation
addPropertyChangeListener, removePropertyChangeListener
public TLcdGXYDataObjectLabelPainter()
TLcdGXYDataObjectLabelPainter
. Define the desired label content
using setExpressions(String...)
.public TLcdGXYDataObjectLabelPainter(TLcdGXYDataObjectLabelPainter aLabelPainter)
aLabelPainter
- The TLcdGXYDataObjectLabelPainter
to clone.public TLcdGXYDataObjectLabelPainter(ALcdGXYInteractiveLabelProvider aGXYInteractiveLabelProvider)
TLcdGXYDataObjectLabelPainter
. Define the desired label content
using setExpressions(String...)
.aGXYInteractiveLabelProvider
- The interactive label provider that should be used. See
setGXYInteractiveLabelProvider
for more details.public String[] getExpressions()
public void setExpressions(String... aExpressions)
aExpressions
- the expressions to use for this objectprotected String[] retrieveLabels(int aMode, ILcdGXYContext aGXYContext)
Returns an array containing the lines of text for a single label.
This method is called to retrieve the actual label text.
Each array element is treated as a line of the label defined by
setObject
, setLabelIndex
and setSubLabelIndex
.
If this method returns null or a zero-length array, no label will be painted. If this method returns
an array containing an empty String, a label is painted without text (decorations like pin and frame are
painted).
A text line can contain HTML commands if its content is surrounded by an <html>
tag.
The HTML support is limited to what is supported by Swing.
By default, this method calls TLcdGXYLabelPainter.retrieveLabels(com.luciad.view.gxy.ILcdGXYContext)
,
which returns a single line of text (i.e. an array of one String
) containing
getObject().toString()
, or null if the object has an empty toString() result.
Override this method to return other text.
Never modify the content of the returned array.
This method may only be called for the label painter's supported label and sublabel indices.
Override the getLabelCount
and/or getSubLabelCount
methods
if you want to define multiple labels per domain object.
This implementation tries to cast the object into an ILcdDataObject
.
If it succeeds, it returns, in a String
array, the result of evaluating
the expression specified in getExpressions()
with the the object as root.
The mode aMode
is ignored.
retrieveLabels
in class TLcdGXYLabelPainter
aMode
- the label painting mode. See ILcdGXYLabelPainter2.paintLabel(java.awt.Graphics,
int, ILcdGXYContext)
for more information about the mode.aGXYContext
- the context in which the label is painted.TLcdGXYLabelPainter.retrieveLabels(ILcdGXYContext)
.TLcdGXYLabelPainter.retrieveLabels(int, com.luciad.view.gxy.ILcdGXYContext)
,
ILcdDataObject
public Object clone()
ALcdGXYLabelPainter
ALcdGXYLabelPainter
. The label location
of the clone is a clone of the label location of the original. No other objects
are cloned.clone
in interface ILcdGXYLabelEditor
clone
in interface ILcdGXYLabelEditorProvider
clone
in interface ILcdGXYLabelPainter
clone
in interface ILcdGXYLabelPainter2
clone
in interface ILcdGXYLabelPainterProvider
clone
in class TLcdGXYLabelPainter
ALcdGXYLabelPainter
of which the label location
is a deep clone.public ALcdDataObjectExpressionLanguage getDataObjectExpressionLanguage()
setDataObjectExpressionLanguage(ALcdDataObjectExpressionLanguage)
public void setDataObjectExpressionLanguage(ALcdDataObjectExpressionLanguage aExpressionLanguage)
aExpressionLanguage
- the data object expression language to be used by this label paintergetDataObjectExpressionLanguage()
public int getPossibleLocationCount(Graphics aGraphics)
aGraphics
- the Graphics the label will be painted on. Not used in this implementation.ILcdGXYLabelPainter.setLocationIndex(int)
public void setPositionList(int[] aPositionList)
Sets a new position list. This list is only used when the labels are not placed freely.
By default, all supported positions are offered:
SOUTH_EAST, NORTH_WEST, NORTH_EAST, SOUTH_WEST, EAST, WEST, NORTH, SOUTH, and CENTER.
See setShiftLabelPosition(int)
for how these positions affect the label.
aPositionList
- the list of possible positions to place the labels.getPositionList()
,
ALcdGXYLabelPainter.setLabelLocation(TLcdLabelLocation)
,
setShiftLabelPosition(int)
public int[] getPositionList()
setPositionList(int[])
public void setPositionListAsString(String[] aPositionList)
String
objects are valid
(independent of the font case):
aPositionList
- the list of possible positions to place labels givens as Strings objects.getPositionListAsString()
public String[] getPositionListAsString()
String
representations of the current position list.String
representations of the current position list.setPositionListAsString(java.lang.String[])
public String getPositionAsString(int aPosition)
aPosition
- the integer code for a position. Can be any of SOUTH_EAST, SOUTH, SOUTH_WEST, WEST,
NORTH_WEST, NORTH, NORTH_EAST, EAST or CENTER.getPositionConstantFromString(java.lang.String)
public void setShiftLabelPosition(int aShift)
Sets how many pixels the label must be removed from the anchor point of the domain object. If
the position of the label is east
or west
, this shift is applied in
horizontal direction; if the position is north
or south
, this
shift is applied in vertical direction. In case of north east
, south east
, south west
or north west
, this
shift is applied in both directions. If the location of the label is center
,
the shift is ignored.
The default for this value is 8
pixels.
aShift
- the distance, expressed in pixels, that the label must be removed from the domain
object.getShiftLabelPosition()
public int getShiftLabelPosition()
setShiftLabelPosition(int)
@Deprecated public void setGXYInteractiveLabelProvider(ALcdGXYInteractiveLabelProvider aGXYInteractiveLabelProvider)
TLcdGXYInteractiveLabelsController
instead.Sets the interactive label provider. This method can be called at most once. If the interactive
label provider was previously set (with this method or in the constructor), calling this method
will throw and IllegalStateException
.
setProvideInteractiveLabelOnMouseOver
must be set to true
.aGXYInteractiveLabelProvider
- The interactive label provider that will be used to
configure and show a component that can, for instance, be
used to edit the properties of the labeled domain object.
This cannot be null
.IllegalStateException
- When the interactive label provider was already set.IllegalArgumentException
- When the interactive label provider was null
.setProvideInteractiveLabelOnMouseOver(boolean)
public ALcdGXYInteractiveLabelProvider getGXYInteractiveLabelProvider()
setGXYInteractiveLabelProvider(ALcdGXYInteractiveLabelProvider)
protected Component getComponentForGXYView(ILcdGXYView aGXYView)
Gets the component that represents the given ILcdGXYView
. By default this is
the view itself casted to java.awt.Component
. This information is used for
handling mouse events.
Override this method if your ILcdGXYView
implementation does not extend from
java.awt.Component
.
aGXYView
- The view for which a Component
must be retrieved.java.awt.Component
which corresponds to the given
ILcdGXYView
IllegalArgumentException
- By default when aGXYView
is not a
java.awt.Component
ALcdGXYInteractiveLabelProvider.dispatchMouseEvent(java.awt.event.MouseEvent,
java.awt.Component, java.awt.Component)
protected boolean canAddComponentToGXYView(ILcdGXYView aGXYView)
Returns whether or not an interactive label can be added to the given view. If this method
returns false
, addComponentToGXYView
must not be called. By default this method checks if the given
ILcdGXYView
is an instance of java.awt.Container
without a layout
set on it.
Override this method if your ILcdGXYView
implementation is not a
java.awt.Container
or if you add components to another container than the
specified ILcdGXYView
.
aGXYView
- The ILcdGXYView
for which to check if a component can be added.true
if a component can be added, false
otherwise.addComponentToGXYView(ILcdGXYView, java.awt.Component)
protected void addComponentToGXYView(ILcdGXYView aGXYView, Component aComponent)
Adds the specified interactive label to the user interface. By default this method casts the
given ILcdGXYView
to java.awt.Container
and adds the component to the
view.
Override this method if your implementation of ILcdGXYView
does not extend from
java.awt.Container
or if you want to add the interactive label to another
java.awt.Container
because, for instance, you already need to add other components
to the specified ILcdGXYView
.
If you override this method, you also need to override canAddComponentToGXYView
and removeComponentFromGXYView
as these methods are closely related to each other.
This method will not be called if canAddComponentToGXYView
returns false
.
aGXYView
- The view to which the interactive label should be added.aComponent
- The interactive label that should be added to the user interface.IllegalArgumentException
- By default if aGXYView
is not an instance of
java.awt.Container
or if the layout of
aGXYView
is not null.canAddComponentToGXYView(ILcdGXYView)
,
removeComponentFromGXYView(ILcdGXYView, java.awt.Component)
protected void removeComponentFromGXYView(ILcdGXYView aGXYView, Component aComponent)
Removes the specified java.awt.Component
from the user interface. By default
this method casts the specified ILcdGXYView
to java.awt.Container
and
removes the component from that container.
Override this method if you have overridden
addComponentToGXYView
.
aGXYView
- The view from which the interactive label should be removed.aComponent
- The interactive label that should be removed from the user interfaceIllegalArgumentException
- By default if the view does not extend from
java.awt.Container
public void startLabelInteraction(Object aDomainObject, int aLabelIndex, int aSubLabelIndex, ILcdGXYContext aGXYContext)
aDomainObject
- The domain object for which to display an interactive label.aLabelIndex
- The index of the label for which an interactive label should be
displayed.aSubLabelIndex
- The index of the sublabel for which an interactive label should be
displayed.aGXYContext
- An instance of ILcdGXYContext
containing the layer and the
view for which the label should be made interactivepublic boolean canStopLabelInteraction()
Returns whether or not the label interaction can be stopped. For instance, when the
interactive label contains invalid text, this method should return false
.
true
if the label interaction can be stopped, false
otherwise.public boolean stopLabelInteraction()
Stops the interactive label, if there is one. The interactive label will commit any outstanding changes.
true
if the interactive label could be stopped or if there was no
interactive label, false
otherwise.canStopLabelInteraction()
,
ALcdGXYInteractiveLabelProvider.stopInteraction()
public void cancelLabelInteraction()
public Object getDomainObjectForInteractiveLabel()
null
if there is no
interactive label.null
if there is no
interactive label.@Deprecated public void setProvideInteractiveLabelOnMouseOver(boolean aProvideInteractiveLabelOnMouseOver)
TLcdGXYInteractiveLabelsController
instead.Enables the ALcdGXYInteractiveLabelProvider
functionality, so that the interactive
label is present when the mouse hoovers over a label. This flag is typically enabled/disabled
whenever the interactive label functionality is desired/not wanted. For example, the interactive
labels could only be desired when a certain ILcdGXYController
is active.
aProvideInteractiveLabelOnMouseOver
- true
to activate the
ALcdGXYInteractiveLabelProvider
, false
otherwise.setGXYInteractiveLabelProvider
public boolean isLabelTouched(Graphics aGraphics, int aMode, ILcdGXYContext aGXYContext)
ILcdGXYLabelPainter2
setObject
, setLabelIndex
and
setSubLabelIndex
is touched at view location (specified by
aGXYContext.getX()
and aGXYContext.getY()
), considering the mode and the
ILcdGXYContext
instance.
Before calling this method, the domain object, the label index, the sublabel index and the location of the label should be set using the respective methods.
isLabelTouched
in interface ILcdGXYLabelPainter2
aGraphics
- The Graphics
instance on which the label is painted.aMode
- the mode to consider. This is a bitwise combinations of several constants.
See ILcdGXYLabelPainter2.paintLabel(java.awt.Graphics, int, com.luciad.view.gxy.ILcdGXYContext)
for more information.aGXYContext
- the ILcdGXYContext
to consider.ILcdGXYContext
public void labelAnchorPointSFCT(Graphics aGraphics, int aMode, ILcdGXYContext aGXYContext, Point aPointSFCT) throws TLcdNoBoundsException
ILcdGXYLabelPainter2
Sets aPointSFCT
to the anchor point of the label specified by
setObject
, setLabelIndex
and setSubLabelIndex
.
If the location index is less than 0, the label anchor point is unambiguously determined by the
label location
. The actual label is to be painted somewhere around
this anchor point. This method is typically called to compare the result with
the label bounds, thus determining the exact relation between the label
and its location
.
Before calling this method, the domain object, the label index, the sublabel index and the location of the label should be set using the respective methods.
labelAnchorPointSFCT
in interface ILcdGXYLabelPainter2
aGraphics
- The Graphics
instance on which the label is painted.aMode
- The mode to consider. This can be a bitwise combination of several
constants. See ILcdGXYLabelPainter2.paintLabel(java.awt.Graphics, int, com.luciad.view.gxy.ILcdGXYContext)
for more information.aGXYContext
- The ILcdGXYContext
that can be used to retrieve extra
information.aPointSFCT
- The point which will be updated to reflect the location of the anchor
point.TLcdNoBoundsException
- if the Object doesn't have any valid anchor point, e.g. if it is
always invisible in the current projection.ILcdGXYLabelPainter2.paintLabel(java.awt.Graphics, int, com.luciad.view.gxy.ILcdGXYContext)
,
ILcdGXYLabelPainter2.getLabelLocation()
,
ILcdGXYLabelPainter2.labelBoundsSFCT(java.awt.Graphics, int, com.luciad.view.gxy.ILcdGXYContext, java.awt.Rectangle)
public boolean editLabel(Graphics aGraphics, int aMode, ILcdGXYContext aGXYContext)
ILcdGXYLabelEditor
Adapts the set TLcdLabelLocation
according to the information present in
aGXYContext. If the method returns true
, the TLcdLabelLocation
was
modified, if false
is returned, it wasn't changed.
The implementation of this method shall define how to edit the label specified by the set
domain Object
, label index and
sublabel index, considering the given mode and
aGXYContext
. These should all be set before calling this method. Note that
if aMode
is one of the creating modes, the (sub) label indices are irrelevant.
editLabel
in interface ILcdGXYLabelEditor
aGraphics
- The Graphics
on which the label is painted.aMode
- the mode to consider when editing aObject: aMode shall be a combination of
ILcdGXYLabelEditor.TRANSLATED
,ILcdGXYLabelEditor.RESHAPED
, ILcdGXYLabelEditor.START_CREATION
,ILcdGXYLabelEditor.CREATING
, ILcdGXYLabelEditor.END_CREATION
.aGXYContext
- contains the information to consider when editing the set Object.ILcdGXYContext
public Object labelSnapTarget(Graphics aGraphics, ILcdGXYContext aGXYContext)
ALcdGXYLabelPainter
Object
that can be used as snapping target when graphically editing
another Object
or label than the one this ILcdGXYLabelPainter2 represents. The
returned Object
can be the Object
this ILcdGXYLabelPainter2
represents or any other (e.g. an ILcdPoint
if getObject() is an
ILcdPointList
).
This default implementation always returns null
. Override this method if you want
to support snapping.
labelSnapTarget
in interface ILcdGXYLabelPainter2
labelSnapTarget
in class ALcdGXYLabelPainter
aGraphics
- the Graphics on which is worked.aGXYContext
- the ILcdGXYContext of the snapping.Object
that can be used as snapping target when graphically editing
another Object
or label than the one this ILcdGXYLabelPainter2 represents
(returned by getObject()). This object can be null
.public ILcdGXYLabelEditor getGXYLabelEditor(Object aObject)
ILcdGXYLabelEditorProvider
Returns a valid ILcdGXYLabelEditor
for editing the labels of aObject. The
returned ILcdGXYLabelEditor
must have aObject
set on it. The
TLcdLabelLocation must not yet be set on it.
getGXYLabelEditor
in interface ILcdGXYLabelEditorProvider
aObject
- the Object for which to obtain a ILcdGXYLabelEditor
.ILcdGXYLabelEditor
for editing the labels of aObject
with aObject
set on it.ILcdGXYLabelEditor.setObject(java.lang.Object)
public ALcdGXYLabelStamp getGXYLabelStamp()
ALcdGXYLabelStamp
that is used by this painter to paint the labels.ALcdGXYLabelStamp
that is used by this painter to paint the labels.setGXYLabelStamp(ALcdGXYLabelStamp)
protected void firePropertyChangeEvent(PropertyChangeEvent aPropertyChangeEvent)
ALcdGXYLabelPainter
PropertyChangeListener
s of the specified event.firePropertyChangeEvent
in class ALcdGXYLabelPainter
aPropertyChangeEvent
- The event describing the property change of which the registered
listeners should be notified.ALcdGXYLabelPainter.addPropertyChangeListener(java.beans.PropertyChangeListener)
public String getDisplayName()
ALcdGXYLabelPainter
setDisplayName
, or toString()
if this was set to null
.getDisplayName
in interface ILcdGXYLabelEditor
getDisplayName
in interface ILcdGXYLabelPainter2
getDisplayName
in class ALcdGXYLabelPainter
ILcdGXYLabelPainter2
public Cursor getLabelCursor(Graphics aGraphics, int aMode, ILcdGXYContext aGXYContext)
ALcdGXYLabelPainter
Cursor
to indicate the type of editing aMode
and
aGXYContext
.
This default implementation always returns null
. Override this method if you want
to display custom cursors.
getLabelCursor
in interface ILcdGXYLabelPainter2
getLabelCursor
in class ALcdGXYLabelPainter
aGraphics
- The Graphics
instance on which the label is painted.aMode
- The mode to consider. See ILcdGXYLabelPainter2.paintLabel(java.awt.Graphics, int,
ILcdGXYContext)
for more information.aGXYContext
- The ILcdGXYContext
containing extra information, such as the
layer, the view and the mouse position.Cursor
to indicate the type of editing aMode
and
aGXYContext
. Returns null
if no particular
Cursor
is required.public boolean acceptSnapTargetForLabel(Graphics aGraphics, ILcdGXYContext aGXYContext)
ILcdGXYLabelEditor
Returns whether the label specified by setObject
, setLabelIndex
and
setSubLabelIndex
accepts the snap target in the given
ILcdGXYContext
.
The snap target is the Object
returned by aGXYContext.getSnapTarget()
,
and is on the ILcdGXYLayer
returned by aGXYContext.getSnapTargetLayer()
.
acceptSnapTargetForLabel
in interface ILcdGXYLabelEditor
aGraphics
- The Graphics
on which the label is painted.aGXYContext
- The ILcdGXYContext
containing the snapping information.true
if the label accepts the snap target, false
otherwise.ILcdGXYContext.getSnapTarget()
,
ILcdGXYContext.getSnapTargetLayer()
public double labelBoundsSFCT(Graphics aGraphics, int aMode, ILcdGXYContext aContext, Rectangle aRectangle) throws TLcdNoBoundsException
ILcdGXYLabelPainter2
Calculates the bounds of the label that can be painted. The bounds are set as a side effect
in aRectangleSFCT
, the orientation of aRectangleSFCT
is returned as
an angle.
The bounds represent the upper left point of the label, and a width and a height. The rotation value represents the rotation of the label bounds around the upper left point.
The domain object, the label index, the sublabel index and the location of the label for which the bounds are retrieved should be set before calling this method using the respective methods.
Note that if this label painter is used in conjunction with a labeling algorithm, the bounds should preferably be independent of the location, as this will yield the best results.
labelBoundsSFCT
in interface ILcdGXYLabelPainter
labelBoundsSFCT
in interface ILcdGXYLabelPainter2
aGraphics
- the aGraphics
to consider.aMode
- the representation mode of the label.aContext
- the ILcdGXYContext
the drawing depends on.aRectangle
- the Rectangle
containing the bounds of the label in view /
graphics coordinates as side effect.TLcdNoBoundsException
- if the Object doesn't have any valid bounds, e.g. if it is always
invisible in the current projection.ILcdGXYViewLabelPainter
,
ILcdGXYLayerLabelPainter
,
ILcdGXYLabelPainter2.labelAnchorPointSFCT(java.awt.Graphics, int, com.luciad.view.gxy.ILcdGXYContext, java.awt.Point)
protected void anchorPointSFCT(Graphics aGraphics, int aMode, ILcdGXYContext aContext, Point aPointSFCT) throws TLcdNoBoundsException
setObject
, setLabelIndex
and
setSubLabelIndex
) attaches to the object representation.
Implementations of this class can also use it to determine, for example, discrete positions
for a label.
By default, this anchor point is the result of the anchorPointSFCT
method of
the corresponding ILcdGXYPainter
for the Object to be painted
(see aGXYContext.getGXYLayer().getGXYPainter( aObject )
).
When the set TLcdLabelLocation
can retrieve an anchor point, this anchor
point should be returned.
Before calling this method, the domain object, the label index, the sublabel index and the location of the label should be set using the respective methods.
aGraphics
- the Graphics for which the labels anchor point should be calculated.aMode
- the mode for the which the label anchor point should be calculated. Can be
ILcdGXYLabelPainter.SELECTED or ILcdGXYLabelPainter.DEFAULT.aContext
- the context in which this label will be painted.aPointSFCT
- the point that will be moved to the computed anchor point.TLcdNoBoundsException
- if the Object doesn't have any valid anchor point, e.g. if it is always invisible in
the current projection.public void setMakeLabelsStickyOnEdit(boolean aMakeLabelsStickyOnEdit)
aMakeLabelsStickyOnEdit
- true
if you want the labels to be sticky after they are edited,
false
otherwise.TLcdLabelLocation.getLabelEditMode()
,
ILcdGXYViewLabelPainter
,
ILcdGXYLayerLabelPainter
public boolean isMakeLabelsStickyOnEdit()
true
if this editor sets the labels it edits to be sticky, false
otherwise. The
default value is false
.setMakeLabelsStickyOnEdit(boolean)
public int getLabelCreationClickCount()
ILcdGXYLabelEditor
Object
.getLabelCreationClickCount
in interface ILcdGXYLabelEditor
Object
or
-1 if this is undefined like for a polyline or a polygon. 0 means graphical creation
of labels is not supported.public Color getPinColor()
setPinColor(java.awt.Color)
public void setPinColor(Color aPinColor)
aPinColor
- The color in which the pin should be drawn.getPinColor()
,
setWithPin(boolean)
public Color getSelectedPinColor()
public void setSelectedPinColor(Color aSelectedPinColor)
aSelectedPinColor
- The color in which the pin of the label of a selected label should be drawn.setWithPin(boolean)
public boolean isHaloEnabled()
setHaloEnabled(boolean)
public void setHaloEnabled(boolean aHaloEnabled)
aHaloEnabled
- true if halos should be added, false otherwiseisHaloEnabled()
,
setHaloPinEnabled(boolean)
public boolean isHaloPinEnabled()
setHaloPinEnabled(boolean)
,
setHaloEnabled(boolean)
public void setHaloPinEnabled(boolean aHaloPinEnabled)
aHaloPinEnabled
- true if the halo effect includes the pin, false otherwiseisHaloPinEnabled()
,
setHaloEnabled(boolean)
,
setWithPin(boolean)
public int getHaloThickness()
setHaloThickness(int)
public void setHaloThickness(int aThickness)
aThickness
- the new halo thicknessTLcdGXYHaloLabelPainter.setHaloThickness(int)
,
setHaloEnabled(boolean)
public Color getHaloColor()
setHaloColor(java.awt.Color)
public void setHaloColor(Color aColor)
aColor
- the new halo colorTLcdGXYHaloLabelPainter.setHaloColor(java.awt.Color)
,
setHaloEnabled(boolean)
public void setHaloAlgorithm(TLcdHaloAlgorithm aHaloAlgorithm)
TLcdHaloAlgorithm
for more information on the available algorithms.aHaloAlgorithm
- the algorithm to be used for rendering halo's.TLcdHaloAlgorithm
,
getHaloAlgorithm()
,
setHaloEnabled(boolean)
public TLcdHaloAlgorithm getHaloAlgorithm()
TLcdHaloAlgorithm
,
setHaloAlgorithm(com.luciad.util.TLcdHaloAlgorithm)
public Color getHaloPinColor()
setHaloColor(java.awt.Color)
public void setHaloPinColor(Color aColor)
aColor
- the new halo colorgetHaloPinColor()
,
setHaloPinEnabled(boolean)
public boolean isUseImageCache()
true
when image caching for labels with a halo is enabled,
false
otherwise.true
when label image caching is enabled, false
otherwisesetUseImageCache(boolean)
public void setUseImageCache(boolean aUseCache)
aUseCache
- specifies whether image caching should be enabledTLcdGXYHaloLabelPainter.setUseImageCache(boolean)
,
setHaloEnabled(boolean)
,
setHaloPinEnabled(boolean)
,
isUseImageCache()
public void clearImageCache()
clearImageCache(Object)
.setUseImageCache(boolean)
public void clearImageCache(Object aObject)
clearImageCache()
.aObject
- the object for which the cache to be cleared.setUseImageCache(boolean)
public void setWithPin(boolean aWithPin)
withPin
determines whether a pin should be drawn from the object to
the label. The pin is attached to the object at the anchor point
and to the label stamp at the pin point
.aWithPin
- true to paint a pin connecting the label and the object.isWithPin()
,
anchorPointSFCT(java.awt.Graphics, int, com.luciad.view.gxy.ILcdGXYContext, java.awt.Point)
,
pinPointSFCT(java.awt.Graphics, int, com.luciad.view.gxy.ILcdGXYContext, java.awt.Point, java.awt.Rectangle, double, java.awt.Point)
,
paintPin(java.awt.Graphics, int, int, int, int, int)
public boolean isWithPin()
true
if a pin is drawn from the object to the labelsetWithPin(boolean)
public void setWithAnchorPoint(boolean aWithAnchorPoint)
anchorPointSFCT
.aWithAnchorPoint
- true to paint an anchor pointisWithAnchorPoint()
,
anchorPointSFCT(java.awt.Graphics, int, com.luciad.view.gxy.ILcdGXYContext, java.awt.Point)
,
paintAnchorPoint(java.awt.Graphics, int, int, int)
public boolean isWithAnchorPoint()
anchorPointSFCT
.true
if an anchor point is painted, false
otherwisesetWithAnchorPoint(boolean)
public static void setClassTraceOn(boolean aClassTraceOn)
true
then all log messages are recorded, otherwise only
the informative, warning and error messages are recorded.aClassTraceOn
- if true then all log messages are recorded,
otherwise only the informative, warning and error messages are recorded.