ilog.views.graphic
Class IlvReliefLabel

java.lang.Object
  ilog.views.IlvGraphic
      ilog.views.graphic.IlvRectangle
          ilog.views.graphic.IlvReliefRectangle
              ilog.views.graphic.IlvReliefLabel

All Implemented Interfaces:

IlvFontInterface, IlvLabelInterface, IlvPersistentObject, Transferable, Serializable

public class IlvReliefLabel
extends IlvReliefRectangle
implements IlvFontInterface, IlvLabelInterface

IlvReliefLabel represents a labeled rectangle in relief with customizable fill and text colors.

The default values for an IlvReliefLabel instance are as follows:

• Foreground: Color.black
• Background: Color.black
• Width and Size: IlvRect(0, 0, 100, 100)
• Relief thickness: 2
• Font: IlvToolkit.defaultFont

The default foreground and background colors are black. You must change one of these colors for the label to be visible.

Note: calls to the following methods result in a RuntimeException being thrown:

• setCorners(int)
• setFillOn(boolean)
• setRadius(int)
• setStrokeOn(boolean)

Example

The following code example shows how to use an IlvReliefLabel in a simple Java application:

   IlvManager manager = new IlvManager();
   IlvReliefLabel myDefaultRect = new IlvReliefLabel();
   myDefaultRect.setLabel("Default Relief Label");
    
   IlvReliefLabel myCustomRect = new IlvReliefLabel(
                                  new IlvRect(120,100,80,20), 
                                  "Custom Relief Label", 
                                  6);
   myCustomRect.setForeground(Color.blue);
   myCustomRect.setBackground(Color.yellow);
   
   manager.addObject( myDefaultRect, true);
   manager.addObject( myCustomRect, true);
 

The following image shows the graphic objects created in the code example:

About Graphic Objects

IlvReliefLabel is a custom graphic object, that is, a subclass of IlvGraphic. Graphic objects are controlled using an IlvManager instance and displayed using one or more IlvManagerView instances in a Java Swing application. For information about generic features for graphic objects, see IlvGraphic.

See Also:

IlvRect, IlvManager, IlvManagerView, Serialized Form

Field Summary

Fields inherited from class ilog.views.graphic.IlvRectangle

BOTTOM_LEFT, BOTTOM_RIGHT, drawrect, TOP_LEFT, TOP_RIGHT

Constructor Summary

IlvReliefLabel()
Creates a new IlvReliefLabel with default size of (0, 0, 100, 100) and an empty label.

IlvReliefLabel(IlvInputStream stream)
Reads the object from an IlvInputStream.

IlvReliefLabel(IlvPoint at, String label, int thickness)
Creates a new IlvReliefLabel.

IlvReliefLabel(IlvRect rect, String label)
Creates a new IlvReliefLabel.

IlvReliefLabel(IlvRect rect, String label, int thickness)
Creates a new IlvReliefLabel.

IlvReliefLabel(IlvReliefLabel source)
Creates a new IlvReliefLabel by copying an existing one.

Method Summary

IlvGraphic	copy() Copies the object.
protected void	drawContent(Graphics dst, IlvRect rect, IlvTransformer t) Draws the inner part of the object.
void	drawLabel(Graphics dst, IlvRect rect, IlvTransformer t) Draws the label inside the relief rectangle.
void	fitToLabel() Recomputes the size of the object according to the current label and thickness.
Font	getFont() Returns the font of the object.
String	getLabel() Returns the label of the object.
IlvRect	getLabelBBox(IlvTransformer t) Returns the bounding area where the label is displayed.
boolean	isAntialiasing() Returns true if the anti-aliasing mode of the label is on.
void	setAntialiasing(boolean set) Changes the anti-aliasing mode of the label.
void	setFont(Font font) Changes the font of the object.
void	setLabel(String label) Changes the label of the object.
boolean	supportMultiline() Returns false since this object does not support multiline text.
String	toString() Returns a string representation of the graphic object.
void	write(IlvOutputStream stream) Writes the object to an IlvOutputStream.

Methods inherited from class ilog.views.graphic.IlvReliefRectangle

draw, getThickness, setCorners, setFillOn, setRadius, setStrokeOn, setThickness

Methods inherited from class ilog.views.graphic.IlvRectangle

applyTransform, boundingBox, contains, getBackground, getCorners, getDefinitionRect, getForeground, getIntersectionWithOutline, getRadius, isCornersZoomable, isFillOn, isStrokeOn, moveResize, setBackground, setCornersZoomable, setDefinitionRect, setForeground, translate

Methods inherited from class ilog.views.IlvGraphic

addActionListener, addNamedPropertyListener, boundingBox, getAndAssociateObjectInteractor, getCenter, getDefaultInteractor, getGraphicBag, GetGraphicObject, getName, getNamedProperty, getObjectInteractor, getPopupMenu, getPopupMenu, getPopupMenuName, getProperty, getToolTipText, getToolTipText, getTopLevelGraphicBag, getTransferData, getTransferDataFlavors, hasProperty, inside, intersects, isDataFlavorSupported, isEditable, isInApplyToObject, isMovable, isPersistent, isSelectable, isVisible, makeSelection, move, move, notifyObjectInteractorToManager, processActionEvent, reDraw, removeActionListener, removeNamedProperty, removeNamedPropertyListener, removeProperty, replaceProperty, resize, rotate, scale, setEditable, setGraphicBag, setInApplyToObject, setMovable, setName, setNamedProperty, setNameImpl, setObjectInteractor, setPopupMenu, setPopupMenuName, setProperty, setSelectable, setToolTipText, setVisible, zoomable

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvReliefLabel

public IlvReliefLabel()

Creates a new IlvReliefLabel with default size of (0, 0, 100, 100) and an empty label.

Since:

JViews 6.0

See Also:

IlvReliefLabel(IlvRect, String)

IlvReliefLabel

public IlvReliefLabel(IlvRect rect,
                      String label)

Creates a new IlvReliefLabel.

Parameters:

rect - The definition rectangle of the object.

label - The label.

IlvReliefLabel

public IlvReliefLabel(IlvRect rect,
                      String label,
                      int thickness)

Creates a new IlvReliefLabel.

Parameters:

rect - The definition rectangle of the object.

label - The label.

thickness - The thickness of the relief.

IlvReliefLabel

public IlvReliefLabel(IlvPoint at,
                      String label,
                      int thickness)

Creates a new IlvReliefLabel. The size of the object is determined by the label.

Parameters:

at - The upper-left point of the object.

label - The label.

thickness - The thickness of the relief.

IlvReliefLabel

public IlvReliefLabel(IlvReliefLabel source)

Creates a new IlvReliefLabel by copying an existing one.

Parameters:

source - The origin object for the copy.

IlvReliefLabel

public IlvReliefLabel(IlvInputStream stream)
               throws IlvReadFileException

Reads the object from an IlvInputStream.

Parameters:

stream - The input stream.

Throws:

IlvReadFileException - if the format is not correct.

Method Detail

setLabel

public final void setLabel(String label)

Changes the label of the object. Note that this method does not recompute the definition rectangle.

Specified by:

setLabel in interface IlvLabelInterface

Parameters:

label - The new label.

See Also:

fitToLabel()

fitToLabel

public void fitToLabel()

Recomputes the size of the object according to the current label and thickness.

The width of the definition rectangle is set to the width of the current label plus 4 times the current thickness. The height of the definition rectangle is set to the height of the current label plus 4 times the current thickness. The upper-left corner of the definition rectangle is not moved.

If the current label is null, the width and height of the definition rectangle are set to the value 10.

Note that if the object is contained inside a manager, you should call this method using the method IlvManager.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean).

Since:

JViews 3.5

See Also:

getLabel(), IlvReliefRectangle.getThickness()

getLabel

public final String getLabel()

Returns the label of the object.

Specified by:

getLabel in interface IlvLabelInterface

supportMultiline

public boolean supportMultiline()

Returns false since this object does not support multiline text.

Specified by:

supportMultiline in interface IlvLabelInterface

getLabelBBox

public IlvRect getLabelBBox(IlvTransformer t)

Returns the bounding area where the label is displayed.

Specified by:

getLabelBBox in interface IlvLabelInterface

Parameters:

t - The transformer used to draw the object.

setFont

public final void setFont(Font font)

Changes the font of the object.

Specified by:

setFont in interface IlvFontInterface

Parameters:

font - The new font.

getFont

public final Font getFont()

Returns the font of the object.

Specified by:

getFont in interface IlvFontInterface

isAntialiasing

public final boolean isAntialiasing()

Returns true if the anti-aliasing mode of the label is on.

setAntialiasing

public final void setAntialiasing(boolean set)

Changes the anti-aliasing mode of the label.

copy

public IlvGraphic copy()

Copies the object. This method copies the object by calling the copy constructor.

Overrides:

copy in class IlvReliefRectangle

Returns:

A copy of the object.

See Also:

IlvGraphic

drawContent

protected void drawContent(Graphics dst,
                           IlvRect rect,
                           IlvTransformer t)

Draws the inner part of the object. It overrides the method drawContent of IlvReliefRectangle to draw the label of the object.

Overrides:

drawContent in class IlvReliefRectangle

Parameters:

dst - The Graphics to perform the drawing.

rect - The rectangle defining the inner part of the relief rectangle (that is, the bounding box with the relief shadow removed). Note that this rectangle is already transformed by the transformer used to draw the object.

t - The transformer used to draw the object.

drawLabel

public void drawLabel(Graphics dst,
                      IlvRect rect,
                      IlvTransformer t)

Draws the label inside the relief rectangle.

Parameters:

dst - The destination Graphics.

rect - The rectangle defining the inner part of the relief rectangle (that is, the bounding box with the relief shadow removed). Note that this rectangle is already transformed by the transformer used to draw the object.

t - The transformation used to draw the object.

write

public void write(IlvOutputStream stream)
           throws IOException

Writes the object to an IlvOutputStream. You should not call this method directly; instead, you should use the write methods of the manager.

Specified by:

write in interface IlvPersistentObject

Overrides:

write in class IlvReliefRectangle

Parameters:

stream - The output stream.

Throws:

IOException - thrown when an exception occurs during the write operation for this object.

toString

public String toString()

Returns a string representation of the graphic object. The method returns a string that is the concatenation of the string returned by IlvGraphic.toString() with the label (see getLabel()).

Overrides:

toString in class IlvGraphic

Since:

JViews 3.5

See Also:

IlvGraphic.getName()