Class TLcdICAOAirspaceDetailedLabelPainter
- All Implemented Interfaces:
ILcdPropertyChangeSource
,ILcdGXYLabelEditor
,ILcdGXYLabelEditorProvider
,ILcdGXYLabelPainter
,ILcdGXYLabelPainter2
,ILcdGXYLabelPainterProvider
,ILcdGXYMultiLabelPainter
,Serializable
,Cloneable
The label will contain the following items
- type
- name
- unit providing service
- lower limit (value, unit and reference)
- upper limit (value, unit and reference)
If the airspace type is 'class', the actual value of the class will be used in the label instead of the type.
The setTypeExpression
method,
setClassExpression
method, the
setNameExpression
method, the
setLowerLimitValueExpression
method, the setLowerLimitUnitExpression
method, the
setLowerLimitReferenceExpression
method, the
setUpperLimitValueExpression
method, the setUpperLimitUnitExpression
method and the
setUpperLimitReferenceExpression
method allow the user to specify the
properties that are used to retrieve the values that will be shown in the
label item. The default value of each property is null
, which
means that the corresponding value will not be used in the label.
This label painter evaluates its expressions using an instance of
TLcdDataObjectExpressionLanguage
.
- See Also:
-
Field Summary
Fields inherited from class com.luciad.view.gxy.TLcdGXYStampLabelPainter
CENTER, EAST, MAXIMUM_AVAILABLE_LOCATIONS, NORTH, NORTH_EAST, NORTH_WEST, SOUTH, SOUTH_EAST, SOUTH_WEST, WEST
Fields inherited from interface com.luciad.view.gxy.ILcdGXYLabelEditor
CREATING, END_CREATION, RESHAPED, START_CREATION, TRANSLATED
Fields inherited from interface com.luciad.view.gxy.ILcdGXYLabelPainter
DEFAULT, SELECTED
Fields inherited from interface com.luciad.view.gxy.ILcdGXYLabelPainter2
BODY, CREATING, HANDLES, RESHAPING, SNAPS, TRANSLATING
-
Constructor Summary
ConstructorDescriptionDefault constructor.TLcdICAOAirspaceDetailedLabelPainter
(TLcdICAOAirspaceDetailedLabelPainter aDetailedLabelPainter) Copy constructor. -
Method Summary
Modifier and TypeMethodDescriptionboolean
acceptSnapTargetForLabel
(Graphics aGraphics, ILcdGXYContext aGXYContext) Returns whether the label specified bysetObject
,setLabelIndex
andsetSubLabelIndex
accepts the snap target in the givenILcdGXYContext
.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 bysetObject
,setLabelIndex
andsetSubLabelIndex
) attaches to the object representation.int
calculateMaxLabelWidth
(String[] aLabels, Graphics aGraphics) Calculates the maximum label width, given the specified labels.protected boolean
canAddComponentToGXYView
(ILcdGXYView aGXYView) Returns whether or not an interactive label can be added to the given view.void
Cancels the interactive label, if there is one.boolean
Returns whether or not the label interaction can be stopped.void
Clears the entire label image cache.void
clearImageCache
(Object aObject) Clears the label image cache for the given object.clone()
Returns a new instance of thisALcdGXYLabelPainter
.boolean
editLabel
(Graphics aGraphics, int aMode, ILcdGXYContext aGXYContext) Adapts the setTLcdLabelLocation
according to the information present in aGXYContext.protected void
firePropertyChangeEvent
(PropertyChangeEvent aPropertyChangeEvent) Notifies the registeredPropertyChangeListener
s of the specified event.Returns the featured airspace to be labeled.Returns the color of the label frames filling.protected Component
getComponentForGXYView
(ILcdGXYView aGXYView) Gets the component that represents the givenILcdGXYView
.This default implementation returns the display name set withsetDisplayName
, ortoString()
if this was set tonull
.int
Returns the vertical spacing between the upper altitude and the separation line between upper and lower altitude, expressed in pixels.Returns the domain object for the interactive label, ornull
if there is no interactive label.getFont()
Returns the font for drawing the labels.Returns the color of the labels.Returns the interactive label provider.getGXYLabelEditor
(Object aObject) Returns a validILcdGXYLabelEditor
for editing the labels of aObject.getGXYLabelPainter
(Object aObject) Finds anILcdGXYLabelPainter
that can be used to label the object passed.Returns theALcdGXYLabelStamp
that is used by this painter to paint the labels.Returns the algorithm that is used for rendering halo's.Returns the current halo color.Returns the current halo pin color.int
Returns the current halo thickness.int
Returns the horizontal spacing between two strings in the label, expressed in pixels.int
Returns the number of points required to initialize the label of the setObject
.getLabelCursor
(Graphics aGraphics, int aMode, ILcdGXYContext aGXYContext) Returns aCursor
to indicate the type of editingaMode
andaGXYContext
.Returns the color in which the pin is drawn.getPositionAsString
(int aPosition) Returns the string representation of the given position of the labels relative to the anchor point.int[]
Returns the list of possible positions to place the labels.String[]
Gets theString
representations of the current position list.int
getPossibleLocationCount
(Graphics aGraphics) Returns the number of possible locations to use (starting from the default position).Returns the color in which the pin should be drawn of the label of a selected object.Returns the color of the label of a selected object.int
Returns how many pixels the label must be removed from the anchor point of the domain object.int
Returns the vertical distance in pixels between successive features.boolean
isFilled()
Returns whether the label's rectangle is painted filled.boolean
Returns true if the halo effect is on for the labels, false otherwise.boolean
Returns true if the halo effect also includes the pin.boolean
isLabelTouched
(Graphics aGraphics, int aMode, ILcdGXYContext aGXYContext) Tests if the label specified bysetObject
,setLabelIndex
andsetSubLabelIndex
is touched at view location(specified by aGXYContext.getX()
andaGXYContext.getY()
), considering the mode and theILcdGXYContext
instance.boolean
Returns whether the labels this editor edits are made sticky.boolean
Returns whether intermediate results should be cached.boolean
Returnstrue
when image caching for labels with a halo is enabled,false
otherwise.boolean
Returns whether to draw an anchor point atanchorPointSFCT
.boolean
Returns whether a pin is drawn from the object to the label.void
labelAnchorPointSFCT
(Graphics aGraphics, int aMode, ILcdGXYContext aGXYContext, Point aPointSFCT) SetsaPointSFCT
to the anchor point of the label specified bysetObject
,setLabelIndex
andsetSubLabelIndex
.double
labelBoundsSFCT
(Graphics aGraphics, int i, ILcdGXYContext aILcdGXYContext, Rectangle aRectangle) Calculates the bounds of the label that can be painted.protected double
labelPositionForLocationIndexSFCT
(int aLocationIndex, int aWidth, int aHeight, Point aAnchorPoint, int aMode, ILcdGXYContext aGXYContext, Graphics aGraphics, Point aPointSFCT) For discrete placement, the upper left corner is chosen as follows: - east-oriented positions: left label side touches aPointSFCT + shift - west-oriented positions: right label side touches aPointSFCT + shift - middle-oriented positions: vertical center axis of label touches aPointSFCT - north-oriented positions: lower side touches aPointSFCT + shift - south-oriented positions: upper side touches aPointSFCT + shift - center-oriented positions: horizontal center axis touches aPointSFCT The labels are unrotated.labelSnapTarget
(Graphics aGraphics, ILcdGXYContext aGXYContext) Returns anObject
that can be used as snapping target when graphically editing anotherObject
or label than the one this ILcdGXYLabelPainter2 represents.void
paintLabel
(Graphics aGraphics, int aMode, ILcdGXYContext aILcdGXYContext) Paints the label specified bysetObject
,setLabelIndex
andsetSubLabelIndex
onaGraphics
.protected void
paintPin
(Graphics aGraphics, int aMode, int aStartPointX, int aStartPointY, int aEndPointX, int aEndPointY) Draws a label pin on the given graphics between the given lines.protected boolean
pinPointSFCT
(Graphics aGraphics, int aMode, ILcdGXYContext aGXYContext, Point aAnchorPoint, Rectangle aLabelBounds, double aRotation, Point aPinPointSFCT) Determines where the pin attaches to the label.protected void
removeComponentFromGXYView
(ILcdGXYView aGXYView, Component aComponent) Removes the specifiedjava.awt.Component
from the user interface.protected String[]
retrieveLabels
(int aMode, ILcdGXYContext aContext) void
setBackground
(Color aBackground) Sets the color of the label frames filling.void
setClassExpression
(String aExpression) Specifies the expression that evaluates to the airspace class.void
setClassIndex
(int aIndex) Deprecated.static void
setClassTraceOn
(boolean aClassTraceOn) Deprecated.This method has been deprecated.void
setDistanceToAltitudeLine
(int aDistanceToAltitudeLine) Specifies the vertical spacing between the upper altitude and the horizontal separation line between upper and lower altitude, expressed in pixels.void
setFilled
(boolean aFilled) Sets whether the label's rectangle must be painted filled.void
Sets the font for drawing the labels.void
setForeground
(Color aForeground) Sets the color of the labels.void
setGXYInteractiveLabelProvider
(ALcdGXYInteractiveLabelProvider aGXYInteractiveLabelProvider) Deprecated.this is controller logic.void
setGXYLabelStamp
(ALcdGXYLabelStamp aGXYLabelStamp) Sets theALcdGXYLabelStamp
that this painter should use to paint the labels.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
setHorizontalSpacing
(int aHorizontalSpacing) Specifies the horizontal spacing between two strings in the label, expressed in pixels.void
setLowerLimitReferenceExpression
(String aExpression) Specifies the expression that evaluates to the lower limit reference.void
setLowerLimitReferenceIndex
(int aIndex) Deprecated.void
setLowerLimitUnitExpression
(String aExpression) Specifies the expression that evaluates to the lower limit unit.void
setLowerLimitUnitIndex
(int aIndex) Deprecated.void
setLowerLimitValueExpression
(String aExpression) Specifies the expression that evaluates to the lower limit value.void
setLowerLimitValueIndex
(int aIndex) Deprecated.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
setNameExpression
(String aExpression) Specifies the expression that evaluates to the name.void
setNameIndex
(int aIndex) Deprecated.void
Sets the Object to be labeled by this ILcdGXYLabelPainter.void
setPaintCache
(boolean aPaintCache) The paintCache property determines whether the painter will cache (intermediate) calculated points.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.void
setSelectedPinColor
(Color aSelectedPinColor) Sets the color in which the pin of the label of a selected label should be drawn.void
setSelectionColor
(Color aSelectionColor) Sets the color of the label of a selected objectvoid
setShiftLabelPosition
(int aShift) Sets how many pixels the label must be removed from the anchor point of the domain object.void
setTypeExpression
(String aExpression) Specifies the expression that evaluates to the airspace type feature.void
setTypeIndex
(int aIndex) Deprecated.void
setUnitProvidingServiceExpression
(String aExpression) Specifies the expression that evaluates to the unit providing service.void
setUnitProvidingServiceIndex
(int aIndex) Deprecated.void
setUpperLimitReferenceExpression
(String aExpression) Specifies the expression that evaluates to the upper limit reference.void
setUpperLimitReferenceIndex
(int aIndex) Deprecated.void
setUpperLimitUnitExpression
(String aExpression) Specifies the expression that evaluates to the upper limit unit.void
setUpperLimitUnitIndex
(int aIndex) Deprecated.void
setUpperLimitValueExpression
(String aExpression) Specifies the expression that evaluates to the upper limit value.void
setUpperLimitValueIndex
(int aIndex) Deprecated.void
setUseImageCache
(boolean aUseCache) Sets whether or not labels with halos should be cached as images.void
setVerticalSpacing
(int aVerticalSpacing) Sets the vertical distance in pixels between successive features.void
setWithAnchorPoint
(boolean aWithAnchorPoint) Determines whether to draw an anchor point atanchorPointSFCT
.void
setWithPin
(boolean aWithPin) The propertywithPin
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
Stops the interactive label, if there is one.Methods inherited from class com.luciad.view.gxy.ALcdGXYLabelPainter
addPropertyChangeListener, getLabelCount, getLabelIndex, getLabelLocation, getLocationIndex, getObject, getSubLabelCount, getSubLabelIndex, removePropertyChangeListener, setDisplayName, setLabelIndex, setLabelLocation, setLocationIndex, setSubLabelIndex, supportLabelSnap
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface com.luciad.view.gxy.ILcdGXYLabelEditor
getLabelCount, getLabelIndex, getLabelLocation, getObject, getSubLabelCount, getSubLabelIndex, setLabelIndex, setLabelLocation, setSubLabelIndex
Methods inherited from interface com.luciad.view.gxy.ILcdGXYLabelPainter
getLocationIndex, getObject, setLocationIndex
Methods inherited from interface com.luciad.view.gxy.ILcdGXYLabelPainter2
getLabelLocation, setLabelLocation, supportLabelSnap
Methods inherited from interface com.luciad.view.gxy.ILcdGXYMultiLabelPainter
getLabelCount, getLabelIndex, getSubLabelCount, getSubLabelIndex, setLabelIndex, setSubLabelIndex
Methods inherited from interface com.luciad.util.ILcdPropertyChangeSource
addPropertyChangeListener, removePropertyChangeListener
-
Constructor Details
-
TLcdICAOAirspaceDetailedLabelPainter
public TLcdICAOAirspaceDetailedLabelPainter()Default constructor. -
TLcdICAOAirspaceDetailedLabelPainter
public TLcdICAOAirspaceDetailedLabelPainter(TLcdICAOAirspaceDetailedLabelPainter aDetailedLabelPainter) Copy constructor.- Parameters:
aDetailedLabelPainter
- the object to be copied.
-
-
Method Details
-
setObject
Description copied from interface:ILcdGXYLabelPainter2
Sets the Object to be labeled by this ILcdGXYLabelPainter.Setting the object should set the
TLcdLabelLocation
tonull
, to ensure that older code which has not been adapted to this new interface keeps working.- Specified by:
setObject
in interfaceILcdGXYLabelEditor
- Specified by:
setObject
in interfaceILcdGXYLabelPainter
- Specified by:
setObject
in interfaceILcdGXYLabelPainter2
- Overrides:
setObject
in classALcdGXYLabelPainter
- Parameters:
aObject
- The object to be labeled.- See Also:
-
clone
Description copied from class:ALcdGXYLabelPainter
Returns a new instance of thisALcdGXYLabelPainter
. The label location of the clone is a clone of the label location of the original. No other objects are cloned.- Specified by:
clone
in interfaceILcdGXYLabelEditor
- Specified by:
clone
in interfaceILcdGXYLabelEditorProvider
- Specified by:
clone
in interfaceILcdGXYLabelPainter
- Specified by:
clone
in interfaceILcdGXYLabelPainter2
- Specified by:
clone
in interfaceILcdGXYLabelPainterProvider
- Returns:
- A new instance of this
ALcdGXYLabelPainter
of which the label location is a deep clone.
-
paintLabel
Description copied from interface:ILcdGXYLabelPainter2
Paints the label specified by
setObject
,setLabelIndex
andsetSubLabelIndex
onaGraphics
.aGXYContext
should contain theILcdGXYView
for which the label is painted andILcdGXYLayer
to which the object belongsThe implementation of this method shall define how to paint the specified label in the given mode, considering
aGXYContext
and the setTLcdLabelLocation
.The domain object, label index, sublabel index and the label location should be set before calling this method using the respective methods.
This interface extends the original contract of the paintLabel method to allow for more modes. Where in the super interface the mode could only be one of
ILcdGXYLabelPainter.DEFAULT
orILcdGXYLabelPainter.SELECTED
, the mode now can be a bitwise combination of several constants- Specified by:
paintLabel
in interfaceILcdGXYLabelPainter
- Specified by:
paintLabel
in interfaceILcdGXYLabelPainter2
- Parameters:
aGraphics
- The graphics object to paint the label onaMode
- A bitwise combination ofaILcdGXYContext
- the drawing context for the label- See Also:
-
labelBoundsSFCT
public double labelBoundsSFCT(Graphics aGraphics, int i, ILcdGXYContext aILcdGXYContext, Rectangle aRectangle) throws TLcdNoBoundsException Description copied from interface:ILcdGXYLabelPainter2
Calculates the bounds of the label that can be painted. The bounds are set as a side effect in
aRectangleSFCT
, the orientation ofaRectangleSFCT
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.
- Specified by:
labelBoundsSFCT
in interfaceILcdGXYLabelPainter
- Specified by:
labelBoundsSFCT
in interfaceILcdGXYLabelPainter2
- Parameters:
aGraphics
- theaGraphics
to consider.i
- the representation mode of the label.aILcdGXYContext
- theILcdGXYContext
the drawing depends on.aRectangle
- theRectangle
containing the bounds of the label in view / graphics coordinates as side effect.- Returns:
- the angle orientation of the rectangle around the labels in RADIANs, clockwise, 0 at 3 o'clock.
- Throws:
TLcdNoBoundsException
- if the Object doesn't have any valid bounds, e.g. if it is always invisible in the current projection.- See Also:
-
isLabelTouched
Description copied from interface:ILcdGXYLabelPainter2
Tests if the label specified bysetObject
,setLabelIndex
andsetSubLabelIndex
is touched at view location(specified by aGXYContext.getX()
andaGXYContext.getY()
), considering the mode and theILcdGXYContext
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.
- Specified by:
isLabelTouched
in interfaceILcdGXYLabelPainter2
- Parameters:
aGraphics
- TheGraphics
instance on which the label is painted.aMode
- the mode to consider. This is a bitwise combinations of several constants. SeeILcdGXYLabelPainter2.paintLabel(java.awt.Graphics, int, com.luciad.view.gxy.ILcdGXYContext)
for more information.aGXYContext
- theILcdGXYContext
to consider.- Returns:
- true if the representation of the Object returned by getObject() is touched, false otherwise
- See Also:
-
calculateMaxLabelWidth
Calculates the maximum label width, given the specified labels.- Parameters:
aLabels
- The labels of the airspace, determined throughretrieveLabels(int,com.luciad.view.gxy.ILcdGXYContext)
.aGraphics
- A Graphics instance, which is used to retrieve the font properties.- Returns:
- the maximum label width, given the specified labels.
-
getAirspace
Returns the featured airspace to be labeled. The resulting object is the same as when you call the getObject method. The advantage of getAirspace is that you avoid a class cast.- Returns:
- the featured airspace to be labeled.
-
setTypeIndex
Deprecated.Specifies the index of the airspace type feature.- Parameters:
aIndex
- the index of the airspace type feature.
-
setTypeExpression
Specifies the expression that evaluates to the airspace type feature.- Parameters:
aExpression
- the airspace type property name.- See Also:
-
setClassIndex
Deprecated.Specifies the index of the airspace class feature. Note that the airspace class feature will only be used when the airspace type feature has as value 'class'. In that case, the actual class will be displayed in the label instead of the general value 'class'.- Parameters:
aIndex
- the index of the airspace class feature.
-
setClassExpression
Specifies the expression that evaluates to the airspace class. Note that the airspace class property will only be used when the airspace type property has as value 'class'. In that case, the actual class will be displayed in the label instead of the general value 'class'.- Parameters:
aExpression
- the airspace class expression.- See Also:
-
setNameIndex
Deprecated.Specifies the index of the name feature.- Parameters:
aIndex
- the index of the name feature.
-
setNameExpression
Specifies the expression that evaluates to the name.- Parameters:
aExpression
- the name expression- See Also:
-
setUnitProvidingServiceIndex
Deprecated.Specifies the index of the unit providing service.- Parameters:
aIndex
- the index of the unit providing service.
-
setUnitProvidingServiceExpression
Specifies the expression that evaluates to the unit providing service.- Parameters:
aExpression
- the unit providing service expression- See Also:
-
setLowerLimitValueIndex
Deprecated.Specifies the index of the lower limit value feature.- Parameters:
aIndex
- the index of the lower limit value feature.
-
setLowerLimitValueExpression
Specifies the expression that evaluates to the lower limit value.- Parameters:
aExpression
- the lower limit value expression.- See Also:
-
setLowerLimitUnitIndex
Deprecated.Specifies the index of the lower limit unit feature.- Parameters:
aIndex
- the index of the lower limit unit feature.
-
setLowerLimitUnitExpression
Specifies the expression that evaluates to the lower limit unit.- Parameters:
aExpression
- the lower limit unit expression.- See Also:
-
setLowerLimitReferenceIndex
Deprecated.Specifies the index of the lower limit reference feature.- Parameters:
aIndex
- the index of the lower limit reference feature.
-
setLowerLimitReferenceExpression
Specifies the expression that evaluates to the lower limit reference.- Parameters:
aExpression
- the lower limit reference expression- See Also:
-
setUpperLimitValueIndex
Deprecated.Specifies the index of the upper limit value feature.- Parameters:
aIndex
- the index of the upper limit value feature.
-
setUpperLimitValueExpression
Specifies the expression that evaluates to the upper limit value.- Parameters:
aExpression
- the upper limit value expression.- See Also:
-
setUpperLimitUnitIndex
Deprecated.Specifies the index of the upper limit unit feature.- Parameters:
aIndex
- the index of the upper limit unit feature.
-
setUpperLimitUnitExpression
Specifies the expression that evaluates to the upper limit unit.- Parameters:
aExpression
- the upper limit unit expression.- See Also:
-
setUpperLimitReferenceIndex
Deprecated.Specifies the index of the upper limit reference feature.- Parameters:
aIndex
- the index of the upper limit reference feature.
-
setUpperLimitReferenceExpression
Specifies the expression that evaluates to the upper limit reference.- Parameters:
aExpression
- the upper limit reference expression.- See Also:
-
getHorizontalSpacing
public int getHorizontalSpacing()Returns the horizontal spacing between two strings in the label, expressed in pixels.- Returns:
- the horizontal spacing between two strings in the label, expressed in pixels.
- See Also:
-
setHorizontalSpacing
public void setHorizontalSpacing(int aHorizontalSpacing) Specifies the horizontal spacing between two strings in the label, expressed in pixels.- Parameters:
aHorizontalSpacing
- the horizontal spacing between two strings in the label, expressed in pixels.- See Also:
-
getDistanceToAltitudeLine
public int getDistanceToAltitudeLine()Returns the vertical spacing between the upper altitude and the separation line between upper and lower altitude, expressed in pixels. This is also the vertical spacing between the altitude separation line and the lower altitude.- Returns:
- the vertical spacing between the upper altitude and the separation line between upper and lower altitude, expressed in pixels.
- See Also:
-
setDistanceToAltitudeLine
public void setDistanceToAltitudeLine(int aDistanceToAltitudeLine) Specifies the vertical spacing between the upper altitude and the horizontal separation line between upper and lower altitude, expressed in pixels. This is also the vertical spacing between the altitude separation line and the lower altitude.- Parameters:
aDistanceToAltitudeLine
- the vertical spacing between the upper altitude and the horizontal separation line between upper and lower altitude, expressed in pixels.- See Also:
-
isPaintCache
public boolean isPaintCache()Returns whether intermediate results should be cached.- Returns:
- true when intermediate results are cached.
- See Also:
-
setPaintCache
public void setPaintCache(boolean aPaintCache) The paintCache property determines whether the painter will cache (intermediate) calculated points. When the label has to be repainted, the labels of the objects that haven't been edited upon, can then be drawn more quickly.- Parameters:
aPaintCache
- true to cache intermediate results.- See Also:
-
setFont
Sets the font for drawing the labels.- Parameters:
aFont
- the font for drawing the labels.
-
getFont
Returns the font for drawing the labels.- Returns:
- the font for drawing the labels.
-
setForeground
Sets the color of the labels.- Parameters:
aForeground
- the color of the labels.
-
getForeground
Returns the color of the labels.- Returns:
- the color of the labels.
-
setBackground
Sets the color of the label frames filling.- Parameters:
aBackground
- the color of the label frames filling.
-
getBackground
Returns the color of the label frames filling.- Returns:
- the color of the label frames filling.
-
setSelectionColor
Sets the color of the label of a selected object- Parameters:
aSelectionColor
- the color of the label of a selected object.
-
getSelectionColor
Returns the color of the label of a selected object.- Returns:
- the color of the label of a selected object.
-
setFilled
public void setFilled(boolean aFilled) Sets whether the label's rectangle must be painted filled.- Parameters:
aFilled
- whether the label's rectangle must be painted filled.
-
isFilled
public boolean isFilled()Returns whether the label's rectangle is painted filled.- Returns:
- true if the label's rectangle is painted filled.
-
setVerticalSpacing
public void setVerticalSpacing(int aVerticalSpacing) Sets the vertical distance in pixels between successive features.- Parameters:
aVerticalSpacing
- the vertical distance in pixels between successive features.
-
getVerticalSpacing
public int getVerticalSpacing()Returns the vertical distance in pixels between successive features.- Returns:
- the vertical distance in pixels between successive features.
-
retrieveLabels
-
getPossibleLocationCount
Returns the number of possible locations to use (starting from the default position).- Parameters:
aGraphics
- the Graphics the label will be painted on. Not used in this implementation.- Returns:
- the number of possible locations to use (starting from the default position).
- See Also:
-
setPositionList
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.- Parameters:
aPositionList
- the list of possible positions to place the labels.- See Also:
-
getPositionList
public int[] getPositionList()Returns the list of possible positions to place the labels.- Returns:
- the list of possible positions to place the labels.
- See Also:
-
setPositionListAsString
The labels can occupy various positions relative to the anchor point (see description above). The following entries for theString
objects are valid (independent of the font case):- "C" or "center".
- "N" or "north".
- "S" or "south".
- "E" or "east".
- "W" or "west".
- "SE" or "southeast"
- "NE" or "northeast"
- "SW" or "southwest"
- "NW" or "northwest"
- Parameters:
aPositionList
- the list of possible positions to place labels givens as Strings objects.- See Also:
-
getPositionListAsString
Gets theString
representations of the current position list.- Returns:
- the
String
representations of the current position list. - See Also:
-
getPositionAsString
Returns the string representation of the given position of the labels relative to the anchor point.- Parameters:
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.- Returns:
- the string representation of the given position of the labels relative to the anchor point.
- See Also:
-
labelPositionForLocationIndexSFCT
protected double labelPositionForLocationIndexSFCT(int aLocationIndex, int aWidth, int aHeight, Point aAnchorPoint, int aMode, ILcdGXYContext aGXYContext, Graphics aGraphics, Point aPointSFCT) For discrete placement, the upper left corner is chosen as follows: - east-oriented positions: left label side touches aPointSFCT + shift - west-oriented positions: right label side touches aPointSFCT + shift - middle-oriented positions: vertical center axis of label touches aPointSFCT - north-oriented positions: lower side touches aPointSFCT + shift - south-oriented positions: upper side touches aPointSFCT + shift - center-oriented positions: horizontal center axis touches aPointSFCT The labels are unrotated.- Parameters:
aLocationIndex
- the location index. This index is non-negative, thus representing a fixed label location.aWidth
- the width of the label.aHeight
- the height of the label.aAnchorPoint
- The anchor point, retrieved using #anchorPointSFCT.aMode
- the mode to consider.aGXYContext
- the context.aGraphics
- the Graphics.aPointSFCT
- This point should be moved to the upper left label corner.- Returns:
- the rotation of the label in radians. This rotation is applied in counter-clockwise direction and a
rotation of 0 indicates regular horizontally painted text. The origin of the rotation is the upper left
corner of the label, which is returned by this method through the
aPointSFCT
parameter as a side effect.
-
setShiftLabelPosition
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
orwest
, this shift is applied in horizontal direction; if the position isnorth
orsouth
, this shift is applied in vertical direction. In case ofnorth east
,south east
,south west
ornorth west
, this shift is applied in both directions. If the location of the label iscenter
, the shift is ignored.The default for this value is
8
pixels.- Parameters:
aShift
- the distance, expressed in pixels, that the label must be removed from the domain object.- See Also:
-
getShiftLabelPosition
public int getShiftLabelPosition()Returns how many pixels the label must be removed from the anchor point of the domain object.- Returns:
- the distance, expressed in pixels, that the label must be removed from the domain object.
- See Also:
-
setGXYInteractiveLabelProvider
@Deprecated public void setGXYInteractiveLabelProvider(ALcdGXYInteractiveLabelProvider aGXYInteractiveLabelProvider) Deprecated.this is controller logic. UseTLcdGXYInteractiveLabelsController
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
Note that to fully enable the functionality,IllegalStateException
.setProvideInteractiveLabelOnMouseOver
must be set totrue
.- Parameters:
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 benull
.- Throws:
IllegalStateException
- When the interactive label provider was already set.IllegalArgumentException
- When the interactive label provider wasnull
.- See Also:
-
getGXYInteractiveLabelProvider
Returns the interactive label provider.- Returns:
- The interactive label provider.
- See Also:
-
getComponentForGXYView
Gets the component that represents the given
ILcdGXYView
. By default this is the view itself casted tojava.awt.Component
. This information is used for handling mouse events.Override this method if your
ILcdGXYView
implementation does not extend fromjava.awt.Component
.- Parameters:
aGXYView
- The view for which aComponent
must be retrieved.- Returns:
- The
java.awt.Component
which corresponds to the givenILcdGXYView
- Throws:
IllegalArgumentException
- By default whenaGXYView
is not ajava.awt.Component
- See Also:
-
canAddComponentToGXYView
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 givenILcdGXYView
is an instance ofjava.awt.Container
without a layout set on it.Override this method if your
ILcdGXYView
implementation is not ajava.awt.Container
or if you add components to another container than the specifiedILcdGXYView
.- Parameters:
aGXYView
- TheILcdGXYView
for which to check if a component can be added.- Returns:
true
if a component can be added,false
otherwise.- See Also:
-
addComponentToGXYView
Adds the specified interactive label to the user interface. By default this method casts the given
ILcdGXYView
tojava.awt.Container
and adds the component to the view.Override this method if your implementation of
ILcdGXYView
does not extend fromjava.awt.Container
or if you want to add the interactive label to anotherjava.awt.Container
because, for instance, you already need to add other components to the specifiedILcdGXYView
.If you override this method, you also need to override
canAddComponentToGXYView
andremoveComponentFromGXYView
as these methods are closely related to each other.This method will not be called if
canAddComponentToGXYView
returnsfalse
.- Parameters:
aGXYView
- The view to which the interactive label should be added.aComponent
- The interactive label that should be added to the user interface.- Throws:
IllegalArgumentException
- By default ifaGXYView
is not an instance ofjava.awt.Container
or if the layout ofaGXYView
is not null.- See Also:
-
removeComponentFromGXYView
Removes the specified
java.awt.Component
from the user interface. By default this method casts the specifiedILcdGXYView
tojava.awt.Container
and removes the component from that container.Override this method if you have overridden
addComponentToGXYView
.- Parameters:
aGXYView
- The view from which the interactive label should be removed.aComponent
- The interactive label that should be removed from the user interface- Throws:
IllegalArgumentException
- By default if the view does not extend fromjava.awt.Container
-
startLabelInteraction
public void startLabelInteraction(Object aDomainObject, int aLabelIndex, int aSubLabelIndex, ILcdGXYContext aGXYContext) Configure an interactive label for the specified label and show it in the GUI.- Parameters:
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 ofILcdGXYContext
containing the layer and the view for which the label should be made interactive
-
canStopLabelInteraction
public 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
.- Returns:
true
if the label interaction can be stopped,false
otherwise.
-
stopLabelInteraction
public boolean stopLabelInteraction()Stops the interactive label, if there is one. The interactive label will commit any outstanding changes.
- Returns:
true
if the interactive label could be stopped or if there was no interactive label,false
otherwise.- See Also:
-
cancelLabelInteraction
public void cancelLabelInteraction()Cancels the interactive label, if there is one. This prevents the interactive label from committing any changes. -
getDomainObjectForInteractiveLabel
Returns the domain object for the interactive label, ornull
if there is no interactive label.- Returns:
- The domain object for the interactive label, or
null
if there is no interactive label.
-
setProvideInteractiveLabelOnMouseOver
@Deprecated public void setProvideInteractiveLabelOnMouseOver(boolean aProvideInteractiveLabelOnMouseOver) Deprecated.this is controller logic. UseTLcdGXYInteractiveLabelsController
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 certainILcdGXYController
is active.- Parameters:
aProvideInteractiveLabelOnMouseOver
-true
to activate theALcdGXYInteractiveLabelProvider
,false
otherwise.- See Also:
-
labelAnchorPointSFCT
public void labelAnchorPointSFCT(Graphics aGraphics, int aMode, ILcdGXYContext aGXYContext, Point aPointSFCT) throws TLcdNoBoundsException Description copied from interface:ILcdGXYLabelPainter2
Sets
aPointSFCT
to the anchor point of the label specified bysetObject
,setLabelIndex
andsetSubLabelIndex
.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 thelabel
and itslocation
.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.
- Specified by:
labelAnchorPointSFCT
in interfaceILcdGXYLabelPainter2
- Parameters:
aGraphics
- TheGraphics
instance on which the label is painted.aMode
- The mode to consider. This can be a bitwise combination of several constants. SeeILcdGXYLabelPainter2.paintLabel(java.awt.Graphics, int, com.luciad.view.gxy.ILcdGXYContext)
for more information.aGXYContext
- TheILcdGXYContext
that can be used to retrieve extra information.aPointSFCT
- The point which will be updated to reflect the location of the anchor point.- Throws:
TLcdNoBoundsException
- if the Object doesn't have any valid anchor point, e.g. if it is always invisible in the current projection.- See Also:
-
editLabel
Description copied from interface:ILcdGXYLabelEditor
Adapts the set
TLcdLabelLocation
according to the information present in aGXYContext. If the method returnstrue
, theTLcdLabelLocation
was modified, iffalse
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 andaGXYContext
. These should all be set before calling this method. Note that ifaMode
is one of the creating modes, the (sub) label indices are irrelevant.- Specified by:
editLabel
in interfaceILcdGXYLabelEditor
- Parameters:
aGraphics
- TheGraphics
on which the label is painted.aMode
- the mode to consider when editing aObject: aMode shall be a combination ofILcdGXYLabelEditor.TRANSLATED
,ILcdGXYLabelEditor.RESHAPED
,ILcdGXYLabelEditor.START_CREATION
,ILcdGXYLabelEditor.CREATING
,ILcdGXYLabelEditor.END_CREATION
.
aGXYContext
- contains the information to consider when editing the set Object.- Returns:
- true if the label of the set Object has changed, false otherwise.
- See Also:
-
labelSnapTarget
Description copied from class:ALcdGXYLabelPainter
Returns anObject
that can be used as snapping target when graphically editing anotherObject
or label than the one this ILcdGXYLabelPainter2 represents. The returnedObject
can be theObject
this ILcdGXYLabelPainter2 represents or any other (e.g. anILcdPoint
if getObject() is anILcdPointList
).This default implementation always returns
null
. Override this method if you want to support snapping.- Specified by:
labelSnapTarget
in interfaceILcdGXYLabelPainter2
- Overrides:
labelSnapTarget
in classALcdGXYLabelPainter
- Parameters:
aGraphics
- the Graphics on which is worked.aGXYContext
- the ILcdGXYContext of the snapping.- Returns:
- an
Object
that can be used as snapping target when graphically editing anotherObject
or label than the one this ILcdGXYLabelPainter2 represents (returned by getObject()). This object can benull
.
-
getGXYLabelPainter
Description copied from interface:ILcdGXYLabelPainterProvider
Finds anILcdGXYLabelPainter
that can be used to label the object passed.The label painter provider is responsible for setting the object to the label painter before returning the label painter. An implementation should therefore have the following structure:
public ILcdGXYLabelPainter getGXYLabelPainter(Object aObject) { ILcdGXYLabelPainter labelPainter = ... // find the label painter for the object if (labelPainter != null) { labelPainter.setObject(aObject); } return labelPainter; }
- Specified by:
getGXYLabelPainter
in interfaceILcdGXYLabelPainterProvider
- Parameters:
aObject
- the object to find a label painter for- Returns:
- a label painter that can be used to label the object; or null if no label painter could be found for the given object, or the object could not be set on the retrieved label painter.
-
getGXYLabelEditor
Description copied from interface:ILcdGXYLabelEditorProvider
Returns a valid
ILcdGXYLabelEditor
for editing the labels of aObject. The returnedILcdGXYLabelEditor
must haveaObject
set on it. The TLcdLabelLocation must not yet be set on it.- Specified by:
getGXYLabelEditor
in interfaceILcdGXYLabelEditorProvider
- Parameters:
aObject
- the Object for which to obtain aILcdGXYLabelEditor
.- Returns:
- a valid
ILcdGXYLabelEditor
for editing the labels ofaObject
withaObject
set on it. - See Also:
-
setGXYLabelStamp
Sets the
ALcdGXYLabelStamp
that this painter should use to paint the labels. This stamp must be set to a non-null
value before this label painter can be used on a layer.- Parameters:
aGXYLabelStamp
- TheALcdGXYLabelStamp
that this painter should use to paint the labels.
-
getGXYLabelStamp
Returns theALcdGXYLabelStamp
that is used by this painter to paint the labels.- Returns:
- The
ALcdGXYLabelStamp
that is used by this painter to paint the labels. - See Also:
-
firePropertyChangeEvent
Description copied from class:ALcdGXYLabelPainter
Notifies the registeredPropertyChangeListener
s of the specified event.- Overrides:
firePropertyChangeEvent
in classALcdGXYLabelPainter
- Parameters:
aPropertyChangeEvent
- The event describing the property change of which the registered listeners should be notified.- See Also:
-
getDisplayName
Description copied from class:ALcdGXYLabelPainter
This default implementation returns the display name set withsetDisplayName
, ortoString()
if this was set tonull
.- Specified by:
getDisplayName
in interfaceILcdGXYLabelEditor
- Specified by:
getDisplayName
in interfaceILcdGXYLabelPainter2
- Overrides:
getDisplayName
in classALcdGXYLabelPainter
- Returns:
- the display name of this
ILcdGXYLabelPainter2
-
getLabelCursor
Description copied from class:ALcdGXYLabelPainter
Returns aCursor
to indicate the type of editingaMode
andaGXYContext
.This default implementation always returns
null
. Override this method if you want to display custom cursors.- Specified by:
getLabelCursor
in interfaceILcdGXYLabelPainter2
- Overrides:
getLabelCursor
in classALcdGXYLabelPainter
- Parameters:
aGraphics
- TheGraphics
instance on which the label is painted.aMode
- The mode to consider. SeeILcdGXYLabelPainter2.paintLabel(java.awt.Graphics, int, ILcdGXYContext)
for more information.aGXYContext
- TheILcdGXYContext
containing extra information, such as the layer, the view and the mouse position.- Returns:
- a
Cursor
to indicate the type of editingaMode
andaGXYContext
. Returnsnull
if no particularCursor
is required.
-
acceptSnapTargetForLabel
Description copied from interface:ILcdGXYLabelEditor
Returns whether the label specified by
setObject
,setLabelIndex
andsetSubLabelIndex
accepts the snap target in the givenILcdGXYContext
.The snap target is the
Object
returned byaGXYContext.getSnapTarget()
, and is on theILcdGXYLayer
returned byaGXYContext.getSnapTargetLayer()
.- Specified by:
acceptSnapTargetForLabel
in interfaceILcdGXYLabelEditor
- Parameters:
aGraphics
- TheGraphics
on which the label is painted.aGXYContext
- TheILcdGXYContext
containing the snapping information.- Returns:
true
if the label accepts the snap target,false
otherwise.- See Also:
-
anchorPointSFCT
protected void anchorPointSFCT(Graphics aGraphics, int aMode, ILcdGXYContext aContext, Point aPointSFCT) throws TLcdNoBoundsException Retrieves an anchor point that is used to determine where the pin of the label (specified bysetObject
,setLabelIndex
andsetSubLabelIndex
) 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 correspondingILcdGXYPainter
for the Object to be painted (seeaGXYContext.getGXYLayer().getGXYPainter( aObject )
). When the setTLcdLabelLocation
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.
- Parameters:
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.- Throws:
TLcdNoBoundsException
- if the Object doesn't have any valid anchor point, e.g. if it is always invisible in the current projection.
-
setMakeLabelsStickyOnEdit
public 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. This means the labels will no longer be automatically moved by the decluttering algorithm.- Parameters:
aMakeLabelsStickyOnEdit
-true
if you want the labels to be sticky after they are edited,false
otherwise.- See Also:
-
isMakeLabelsStickyOnEdit
public boolean isMakeLabelsStickyOnEdit()Returns whether the labels this editor edits are made sticky.- Returns:
true
if this editor sets the labels it edits to be sticky,false
otherwise. The default value isfalse
.- See Also:
-
getLabelCreationClickCount
public int getLabelCreationClickCount()Description copied from interface:ILcdGXYLabelEditor
Returns the number of points required to initialize the label of the setObject
.- Specified by:
getLabelCreationClickCount
in interfaceILcdGXYLabelEditor
- Returns:
- the number of points required to initialize the label of the set
Object
or -1 if this is undefined like for a polyline or a polygon. 0 means graphical creation of labels is not supported.
-
getPinColor
Returns the color in which the pin is drawn.- Returns:
- The color in which the pin is drawn.
- See Also:
-
setPinColor
Sets the color in which the pin should be drawn.- Parameters:
aPinColor
- The color in which the pin should be drawn.- See Also:
-
getSelectedPinColor
Returns the color in which the pin should be drawn of the label of a selected object.- Returns:
- The color in which the pin should be drawn of the label of a selected object.
-
setSelectedPinColor
Sets the color in which the pin of the label of a selected label should be drawn.- Parameters:
aSelectedPinColor
- The color in which the pin of the label of a selected label should be drawn.- See Also:
-
isHaloEnabled
public boolean isHaloEnabled()Returns true if the halo effect is on for the labels, false otherwise.- Returns:
- true if the halo effect is on, false otherwise
- See Also:
-
setHaloEnabled
public void setHaloEnabled(boolean aHaloEnabled) Switches the halo effect for the labels on or off.- Parameters:
aHaloEnabled
- true if halos should be added, false otherwise- See Also:
-
isHaloPinEnabled
public boolean isHaloPinEnabled()Returns true if the halo effect also includes the pin.- Returns:
- true if the halo effect includes the pin, false otherwise
- See Also:
-
setHaloPinEnabled
public void setHaloPinEnabled(boolean aHaloPinEnabled) Sets if the halo effect should be applied to the pin. This only has effect when the pin is enabled.- Parameters:
aHaloPinEnabled
- true if the halo effect includes the pin, false otherwise- See Also:
-
getHaloThickness
public int getHaloThickness()Returns the current halo thickness.- Returns:
- the current halo thickness
- See Also:
-
setHaloThickness
public void setHaloThickness(int aThickness) Sets the thickness (in pixels) of the halo to be added around labels.- Parameters:
aThickness
- the new halo thickness- See Also:
-
getHaloColor
Returns the current halo color.- Returns:
- the current halo color
- See Also:
-
setHaloColor
Sets the color of the halo to be added around labels.- Parameters:
aColor
- the new halo color- See Also:
-
setHaloAlgorithm
Sets the algorithm to be used for rendering halo's. The choice of the halo algorithm may have a major impact on the overall performance of this painter. SeeTLcdHaloAlgorithm
for more information on the available algorithms.- Parameters:
aHaloAlgorithm
- the algorithm to be used for rendering halo's.- See Also:
-
getHaloAlgorithm
Returns the algorithm that is used for rendering halo's.- Returns:
- the algorithm that is used for rendering halo's.
- See Also:
-
getHaloPinColor
Returns the current halo pin color.- Returns:
- the current halo pin color
- See Also:
-
setHaloPinColor
Sets the color of the halo to be added around pins.- Parameters:
aColor
- the new halo color- See Also:
-
isUseImageCache
public boolean isUseImageCache()Returnstrue
when image caching for labels with a halo is enabled,false
otherwise.- Returns:
true
when label image caching is enabled,false
otherwise- See Also:
-
setUseImageCache
public void setUseImageCache(boolean aUseCache) Sets whether or not labels with halos should be cached as images. Creating a halo for a label is an expensive operation, so enabling image caching can considerably improve performance.- Parameters:
aUseCache
- specifies whether image caching should be enabled- See Also:
-
clearImageCache
public void clearImageCache()Clears the entire label image cache. To remove a single label from the cache, useclearImageCache(Object)
.- See Also:
-
clearImageCache
Clears the label image cache for the given object. The next time this object is painted, a new image will be created and cached for it. To remove all cached images in one go, useclearImageCache()
.- Parameters:
aObject
- the object for which the cache to be cleared.- See Also:
-
pinPointSFCT
protected boolean pinPointSFCT(Graphics aGraphics, int aMode, ILcdGXYContext aGXYContext, Point aAnchorPoint, Rectangle aLabelBounds, double aRotation, Point aPinPointSFCT) Determines where the pin attaches to the label. This implementation attaches the pin on the label bounds, with the pin going towards the center of the label bounds.- Parameters:
aGraphics
- TheGraphics
instance on which the pin will be painted.aMode
- The mode in which the pin will be painted. SeeILcdGXYLabelPainter2.paintLabel(java.awt.Graphics, int, ILcdGXYContext)
for more information.aGXYContext
- The instance containing the context in which the pin will be painted.aAnchorPoint
- The point in AWT coordinates where the pin attaches to the object representation (see #anchorPointSFCT)aLabelBounds
- The bounds of the label in AWT coordinates.aRotation
- The rotation of the label in radians, positive going from the x to the y axisaPinPointSFCT
- The point in AWT coordinates where the pin attaches to the label- Returns:
- Whether or not the pin needs to be drawn.
- See Also:
-
paintPin
protected void paintPin(Graphics aGraphics, int aMode, int aStartPointX, int aStartPointY, int aEndPointX, int aEndPointY) Draws a label pin on the given graphics between the given lines. Overwrite this method if you want to change the look of the pin, for example by manipulating the graphics passed.- Parameters:
aGraphics
- the graphics to paint the pin on.aMode
- the mode this objects label is painted in (e.g. ILcdGXYLabelPainter.SELECTED).aStartPointX
- the x coordinate of the start point of the pin.aStartPointY
- the y coordinate of the start point of the pin.aEndPointX
- the x coordinate of the end point of the pin.aEndPointY
- the y coordinate of the end point of the pin.- See Also:
-
setWithPin
public void setWithPin(boolean aWithPin) The propertywithPin
determines whether a pin should be drawn from the object to the label. The pin is attached to the object at theanchor point
and to the label stamp at thepin point
.- Parameters:
aWithPin
- true to paint a pin connecting the label and the object.- See Also:
-
isWithPin
public boolean isWithPin()Returns whether a pin is drawn from the object to the label.- Returns:
true
if a pin is drawn from the object to the label- See Also:
-
setWithAnchorPoint
public void setWithAnchorPoint(boolean aWithAnchorPoint) Determines whether to draw an anchor point atanchorPointSFCT
.- Parameters:
aWithAnchorPoint
- true to paint an anchor point- See Also:
-
isWithAnchorPoint
public boolean isWithAnchorPoint()Returns whether to draw an anchor point atanchorPointSFCT
.- Returns:
true
if an anchor point is painted,false
otherwise- See Also:
-
setClassTraceOn
public static void setClassTraceOn(boolean aClassTraceOn) Deprecated.This method has been deprecated. It is recommended to use the standard Java logging framework directly.Enables tracing for all instances of this class. If the argument istrue
then all log messages are recorded, otherwise only the informative, warning and error messages are recorded.- Parameters:
aClassTraceOn
- if true then all log messages are recorded, otherwise only the informative, warning and error messages are recorded.
-
setClassExpression(String)