IlvBracket (Perforce JViews 10.0 API)

java.lang.Object
- ilog.views.IlvGraphic
- - ilog.views.graphic.composite.decoration.IlvBracket

All Implemented Interfaces:

IlvPersistentObject, IlvBlinkingObject, IlvBaseTextDirectionInterface, Transferable, Serializable
```
public class IlvBracket
extends IlvGraphic
```
An IlvBracket draws a square bracket oriented to either the left or right. This class is designed to be used with an IlvCompositeGraphic instance.
Overview

The size of an IlvBracket instance is defined by the width and height properties of its defining rectangle. If the fixed width of this IlvBracket instance is greater than 0, the width between the horizontal borders is the value returned by getFixedWidth(). If the fixed width equals 0, the width between the horizontal borders is the width of the definition rectangle multiplied by the ratio.

The default values for an IlvBracket instance are as follows:
- Orientation: IlvDirection.Left
- Foreground: Color.black
- Background: Color.white
- Fill: false
- Stroke: BasicStroke(1)
- Width: 100
- Width Ratio: 0.25
- Fixed Width: 100
- Height: 100
Example

The following code example shows how to use IlvBracket in a simple Java application:
```
 IlvGrapher grapher = new IlvGrapher();
 // Creates the composite graphic with an IlvCenteredLayout layout
 IlvCompositeGraphic composite = new IlvCompositeGraphic();
 IlvCenteredLayout cl = new IlvCenteredLayout();
 cl.setInsets(new Insets(10,10,10,10));
 composite.setLayout(cl);

 // Creates an IlvBracket and adds it to the composite graphic
 IlvBracket bracket = new IlvBracket();
 bracket.setFillOn(false);
 bracket.setStroke(new BasicStroke(2));
 bracket.setBackground(Color.lightGray);
 bracket.setWidthRatio(0.5);
 composite.setChildren(0,bracket);

 // Creates the label and adds it to the composite graphic
 IlvZoomableLabel text = new IlvZoomableLabel(new IlvPoint(),"This is a Left Bracket");
 composite.setChildren(1,text);

 // Adds the composite into the grapher.
 grapher.addNode(composite,false);
 
```
The following image shows the graphic objects created in the code example:

About Graphic Objects

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

JViews 6.0

See Also:

setWidth(double), setHeight(double), setWidthRatio(double), setFixedWidth(double), IlvCompositeGraphic, IlvCenteredLayout, IlvManager, IlvManagerView, IlvGrapher, Serialized Form

Constructor Summary

Constructors
Constructor and Description
`IlvBracket()` Creates an `IlvBracket` with the default values.
`IlvBracket(IlvBracket source)` Creates a new `IlvBracket` by copying an existing one.
`IlvBracket(IlvInputStream stream)` Reads the object from an `IlvInputStream`.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`applyTransform(IlvTransformer t)` Applies a transformation to the shape of this object.
`IlvRect`	`boundingBox(IlvTransformer t)` Returns the bounding rectangle of this object.
`IlvGraphic`	`copy()` Copies this object.
`void`	`draw(Graphics dst, IlvTransformer t)` Draws this object.
`Color`	`getBackground()` Returns the background color of the `IlvRectangle`.
`double`	`getFixedWidth()` Returns the width used to draw the two horizontal borders of this object.
`Color`	`getForeground()` Returns the foreground color of the `IlvRectangle`.
`double`	`getHeight()` Returns the height of the definition rectangle.
`int`	`getOrientation()` Returns the orientation of the bracket.
`Stroke`	`getStroke()` Returns the stroke used to draw this bracket
`double`	`getWidth()` Returns the width of the definition rectangle.
`double`	`getWidthRatio()` Returns the ratio
`boolean`	`isFillOn()` Returns `true` if the inside of the bracket will be filled.
`void`	`setBackground(Color color)` Changes the background color of the `IlvRectangle`.
`void`	`setFillOn(boolean fillOn)` If `true`, specifies that the inside of the bracket will be filled.
`void`	`setFixedWidth(double width)` Sets the width used to draw the two horizontal borders of this object.
`void`	`setForeground(Color color)` Changes the foreground color of the `IlvRectangle`.
`void`	`setHeight(double height)` Sets the height of the definition rectangle.
`void`	`setOrientation(int orientation)` Sets the orientation of the bracket.
`void`	`setStroke(Stroke stroke)` Sets the stroke used to draw this bracket
`void`	`setWidth(double width)` Sets the width of the definition rectangle.
`void`	`setWidthRatio(double ratio)` Sets the ratio used to compute the width of the two horizontal borders of this object.
`void`	`write(IlvOutputStream stream)` Writes the object to an `IlvOutputStream`.

Methods inherited from class ilog.views.IlvGraphic
addActionListener, addNamedPropertyListener, allViewsRemoved, baseTextDirectionChanged, blinkingStateOn, boundingBox, callDraw, componentOrientationChanged, contains, getAndAssociateObjectInteractor, getBaseTextDirection, getBlinkingAction, getBlinkingObjectOwner, getBlinkingOffPeriod, getBlinkingOnPeriod, getCenter, getComponentOrientation, getDefaultInteractor, getGraphicBag, GetGraphicObject, getIntersectionWithOutline, getLocale, getName, getNamedProperty, getObjectInteractor, getPopupMenu, getPopupMenu, getPopupMenuName, getProperty, getResolvedBaseTextDirection, getToolTipBaseTextDirection, getToolTipText, getToolTipText, getTopLevelGraphicBag, getTransferData, getTransferDataFlavors, getULocale, getZOrderIndex, hasProperty, inside, intersects, invalidateBBoxCache, invalidateBidiCache, isBaseTextDirectionSensitive, isComponentOrientationSensitive, isDataFlavorSupported, isEditable, isInApplyToObject, isLocaleSensitive, isMovable, isPersistent, isSelectable, isVisible, localeChanged, makeSelection, move, move, moveResize, needsViewNotification, notifyObjectInteractorToManager, processActionEvent, reDraw, registerBlinkingResource, removeActionListener, removeNamedProperty, removeNamedPropertyListener, removeProperty, replaceProperty, resize, rotate, scale, setBaseTextDirection, setBaseTextDirectionDuringConstruction, setBlinkingAction, setBlinkingOffPeriod, setBlinkingOnPeriod, setEditable, setGraphicBag, setInApplyToObject, setMovable, setName, setNamedProperty, setNameImpl, setObjectInteractor, setPopupMenu, setPopupMenuName, setProperty, setSelectable, setStrokeOn, setToolTipBaseTextDirection, setToolTipText, setVisible, setZOrderIndex, toString, translate, updateNeedsViewNotification, usesBidiMarkers, viewAddedOrRemoved, zoomable

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - IlvBracket
```
public IlvBracket()
```
    Creates an IlvBracket with the default values.
  - IlvBracket
```
public IlvBracket(IlvBracket source)
```
    Creates a new IlvBracket by copying an existing one.
  - IlvBracket
```
public IlvBracket(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
  - copy
```
public IlvGraphic copy()
```
    Copies this object.
    
    Specified by:
    
    copy in class IlvGraphic
    
    Returns:
    
    A copy of this object.
    
    See Also:
    
    IlvGraphic
  - applyTransform
```
public void applyTransform(IlvTransformer t)
```
    Applies a transformation to the shape of this object.
    Note that the method must never be called with a null argument.
    
    Specified by:
    
    applyTransform in class IlvGraphic
    
    Parameters:
    
    t - The transformer to be applied.
    
    See Also:
    
    IlvGraphic
  - boundingBox
```
public IlvRect boundingBox(IlvTransformer t)
```
    Returns the bounding rectangle of this object.
    
    Specified by:
    
    boundingBox in class IlvGraphic
    
    Parameters:
    
    t - The transformer used to draw the object. If the transformer is null, the bounding box for the identity transformer is returned.
    
    See Also:
    
    IlvGraphic.draw(java.awt.Graphics, ilog.views.IlvTransformer), IlvGraphic.zoomable(), IlvGraphic
  - draw
```
public void draw(Graphics dst,
                 IlvTransformer t)
```
    Draws this object.
    
    Specified by:
    
    draw in class IlvGraphic
    
    Parameters:
    
    dst - The destination Graphics.
    
    t - The transformation used to draw the object.
    
    See Also:
    
    boundingBox(ilog.views.IlvTransformer), IlvGraphic.zoomable()
  - setForeground
```
public void setForeground(Color color)
```
    Changes the foreground color of the IlvRectangle. It is the color used to draw the outline of the rectangle. This property supports IlvBlinkingColor.
    
    Overrides:
    
    setForeground in class IlvGraphic
    
    Parameters:
    
    color - The new foreground color.
    
    See Also:
    
    IlvGraphic.draw(Graphics, IlvTransformer), IlvGraphic.setBackground(Color), IlvGraphic.setFillOn(boolean), IlvGraphic.setStrokeOn(boolean), IlvGraphic
  - getForeground
```
public Color getForeground()
```
    Returns the foreground color of the IlvRectangle. It is the color used to draw the outline of the rectangle.
    
    Returns:
    
    The foreground color.
  - setBackground
```
public void setBackground(Color color)
```
    Changes the background color of the IlvRectangle. It is the color used to fill the rectangle. This property supports IlvBlinkingColor.
    
    Overrides:
    
    setBackground in class IlvGraphic
    
    Parameters:
    
    color - The new background color.
    
    See Also:
    
    IlvGraphic.draw(Graphics, IlvTransformer), IlvGraphic.setForeground(Color), IlvGraphic.setFillOn(boolean), IlvGraphic.setStrokeOn(boolean), IlvGraphic
  - getBackground
```
public Color getBackground()
```
    Returns the background color of the IlvRectangle. It is the color used to fill the rectangle.
    
    Returns:
    
    The background color.
  - setWidth
```
public void setWidth(double width)
```
    Sets the width of the definition rectangle.
    
    See Also:
    
    setWidthRatio(double)
  - getWidth
```
public double getWidth()
```
    Returns the width of the definition rectangle.
  - setHeight
```
public void setHeight(double height)
```
    Sets the height of the definition rectangle.
  - getHeight
```
public double getHeight()
```
    Returns the height of the definition rectangle.
  - setWidthRatio
```
public void setWidthRatio(double ratio)
```
    Sets the ratio used to compute the width of the two horizontal borders of this object. The width of the two horizontal borders is with multiplied by ratio. This property is ignored if getFixedWidth() returns a value greater than 0.
    
    Parameters:
    
    ratio - the ratio must be between 0 1
    
    See Also:
    
    setFixedWidth(double)
  - getWidthRatio
```
public double getWidthRatio()
```
    Returns the ratio
  - setFixedWidth
```
public void setFixedWidth(double width)
```
    Sets the width used to draw the two horizontal borders of this object.
    
    Parameters:
    
    width - The width used to draw the two horizontal borders of this object.
  - getFixedWidth
```
public double getFixedWidth()
```
    Returns the width used to draw the two horizontal borders of this object.
  - getOrientation
```
public int getOrientation()
```
    Returns the orientation of the bracket. The possible values are:
    - IlvDirection.Left
    - IlvDirection.Right
  - setOrientation
```
public void setOrientation(int orientation)
```
    Sets the orientation of the bracket. The possible values are:
    - IlvDirection.Left - Left orientation.
    - IlvDirection.Right - Right orientation.
    Parameters:
    
    orientation - The orientation.
  - setFillOn
```
public void setFillOn(boolean fillOn)
```
    If true, specifies that the inside of the bracket will be filled.
    
    Overrides:
    
    setFillOn in class IlvGraphic
    
    Parameters:
    
    fillOn - Set to true to enable the fill style for this graphic object.
    
    See Also:
    
    isFillOn()
  - isFillOn
```
public boolean isFillOn()
```
    Returns true if the inside of the bracket will be filled.
    
    See Also:
    
    setFillOn(boolean)
  - setStroke
```
public void setStroke(Stroke stroke)
```
    Sets the stroke used to draw this bracket
  - getStroke
```
public Stroke getStroke()
```
    Returns the stroke used to draw this bracket
  - 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 IlvGraphic
    
    Parameters:
    
    stream - The output stream.
    
    Throws:
    
    IOException - thrown when an exception occurs during the write operation for this object.

Class IlvBracket

Overview

Example

About Graphic Objects

Constructor Summary

Method Summary

Methods inherited from class ilog.views.IlvGraphic

Methods inherited from class java.lang.Object

Constructor Detail

IlvBracket

IlvBracket

IlvBracket

Method Detail

copy

applyTransform

boundingBox

draw

setForeground

getForeground

setBackground

getBackground

setWidth

getWidth

setHeight

getHeight

setWidthRatio

getWidthRatio

setFixedWidth

getFixedWidth

getOrientation

setOrientation

setFillOn

isFillOn

setStroke

getStroke

write