IlvLinkBundle (Perforce JViews 10.0 API)

java.lang.Object
- ilog.views.IlvGraphic
- - ilog.views.IlvLinkImage
  - - ilog.views.graphic.IlvPolylineLinkImage
    - - ilog.views.graphic.linkbundle.IlvLinkBundle

All Implemented Interfaces:

IlvGraphicBag, IlvObjectWithSelection, IlvPolyPointsInterface, IlvPersistentObject, IlvBlinkingObject, IlvBaseTextDirectionInterface, Transferable, Serializable

Direct Known Subclasses:

IlvSDMLinkBundle
```
public class IlvLinkBundle
extends IlvPolylineLinkImage
implements IlvGraphicBag, IlvObjectWithSelection
```
The IlvLinkBundle class provides a link object that stores and represents a bundle of individual links ("sublinks").
This link class can be used to force the display of a collection of links between two nodes in a fixed order and with a specified distance between them. A link bundle groups a number of links that are laid out in the order in which they are added to the link bundle. The spacing between the links is known as the link offset (see setOffset(double). This value is specific to each link bundle: in the same grapher, different bundles can have different offsets.
The extremities of a link bundle and of the sublinks it gathers must match in the sense that, for each sublink, the origin and the destination nodes of the link must either:
- be equal to the origin and to the destination nodes of the link bundle, or
- correspond to the to and from ends of the set.
When a link is added to a link bundle, its origin and destination nodes are forced to those of the link bundle if they do not match. Finally, when the origin or destination nodes of a link bundle is changed, the corresponding origin or destination node of the sublinks are changed accordingly.
The sublinks can be of any class. Notice however that the link bundle must be allowed to move the points of the link (connection points and intermediate points if any). Hence, links of type IlvOneLinkImage, IlvDoubleLinkImage, IlvOneSplineLinkImage and IlvDoubleSplineLinkImage are usually not appropriate, because they don't allow the intermediate points to be moved freely.
To obtain a consistent layout, it is not recommended to mix in the same bundle spline links (IlvSplineLinkImage) with polyline links (IlvPolylineLinkImage and subclasses). Either use only polyline links, or use only spline links for both the sublinks and for the overview link. An overview link of type IlvSplineLinkImage should be set on the link bundle when the sublinks are splines.
Also, a link connector class allowing the connection points to be moved freely must be installed either
- On the origin and destination nodes of the link bundle. This is the simplest way, that can be used if you don't need different types of link connectors on other links incident to the origin and destination nodes.
- On the sublinks and overview link themselves. This solution can be used if you need different types of link connectors on the origin/destination nodes than for the links of the link bundle.
For details on how to attach a link connector to nodes or links, see the documentation of IlvLinkConnector. The recommended link connector is IlvClippingLinkConnector.
Similar to submanagers and subgraphs, the link bundle has two states:
- expanded state: the individual sublinks of the bundle are drawn. An optional background frame is drawn (see getFrame()).
- collapsed state: only the "overview" link (see getOverviewLink()) is drawn, instead of the individual sublinks. If no overview link is specified, the bundle is rendered by the super class of IlvLinkBundle, that is IlvPolylineLinkImage.
The link bundle gives the sublinks a polyline shape when no overview link is specified. If an overview link is specified, the shape of the sublinks depends on the type of the specified overview link: spline shape for IlvSplineLinkImage and subclasses, otherwise polyline shape.
The following code sample shows an example of how to build a link bundle:
```
 // Create the origin and destination nodes of the link
 IlvGraphic origin = new IlvReliefRectangle(new IlvRect(50, 50, 40, 40));
 IlvGraphic dest = new IlvReliefRectangle(new IlvRect(350, 50, 40, 40));

 // Create the sublinks
 IlvLinkImage sublink1 = new IlvPolylineLinkImage(origin, dest, false, null);
 // If appropriate, some sublinks can have the reversed orientation:
 IlvLinkImage sublink2 = new IlvPolylineLinkImage(dest, origin, false, null);

 // Ensure that the connection points of all links can be freely moved
 // and are clipped on the border of their adjacent nodes. For instance:
 new IlvClippingLinkConnector(origin);
 new IlvClippingLinkConnector(dest);

 // Alternatively, if a different type of link connector is needed on links that
 // are not sublinks in bundles, the IlvClippingLinkConnector can be installed
 // directly on the sublinks of the bundle, while a different type of link
 // connector can exist on the nodes:
 //
 // new IlvClippingLinkConnector(sublink1, true);  // origin of sublink1
 // new IlvClippingLinkConnector(sublink1, false); // destination of sublink1
 // new IlvClippingLinkConnector(sublink2, true);  // origin of sublink2
 // new IlvClippingLinkConnector(sublink2, false); // destination of sublink2
 //
 // Note that it is not necessary and it is not recommended to install a 
 // clipping connector on both the node and the sublinks.
 
 // Create the link bundle
 IlvLinkBundle linkBundle = new IlvLinkBundle(origin, dest, false);

 // Add the sublinks to the link bundle
 linkBundle.addSublink(sublink1);
 linkBundle.addSublink(sublink2);

 // Alternatively, and more efficiently, the sublinks can be specified
 // at once using the method addSublinks(IlvLinkImage[] sublinks).

 // Optional: specify the overview link
 linkBundle.setOverviewLink(new IlvPolylineLinkImage(origin, dest, false,  null);

 // Add the nodes and links to the grapher
 grapher.addNode(origin, false);
 grapher.addNode(dest, false);
 grapher.addLink(linkBundle, false);
 
```
On links of the type IlvEnhancedPolylineLinkImage and subclasses, a complementary bundling mechanism (with some restrictions) can be activated using IlvEnhancedPolylineLinkImage.setMultiLinkBundled(boolean). See also IlvBundleLinkShapePolicy.
Since:

JViews 8.0

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description
`IlvLinkBundle()` Creates a new empty `IlvLinkBundle` instance.
`IlvLinkBundle(IlvGraphic from, IlvGraphic to, boolean oriented)` Creates a new `IlvLinkBundle` instance with no intermediate points and no overview link.
`IlvLinkBundle(IlvGraphic from, IlvGraphic to, boolean oriented, IlvPoint[] points)` Creates a new `IlvLinkBundle` instance with no overview link.
`IlvLinkBundle(IlvGraphic from, IlvGraphic to, boolean oriented, IlvPoint[] points, IlvLinkImage overviewLink)` Creates a new `IlvLinkBundle` instance.
`IlvLinkBundle(IlvInputStream stream)` Reads the object from an `IlvInputStream`.
`IlvLinkBundle(IlvLinkBundle source)` Creates an `IlvLinkBundle` by copying an existing one.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addLinkBundleSelectionChangedListener(LinkBundleSelectionChangedListener listener)` Adds the specified listener to receive events from the link bundle when the selection of sublinks changes.
`void`	`addObject(IlvGraphic obj, boolean redraw)` You should not call this method.
`void`	`addSublink(IlvLinkImage sublink)` Adds a sublink at the end of the link bundle.
`void`	`addSublink(int index, IlvLinkImage sublink)` Adds a sublink at the specified index in the link bundle.
`boolean`	`allowsPointInsertion()` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`boolean`	`allowsPointMove(int index)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`boolean`	`allowsPointRemoval()` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`void`	`applyToObject(IlvGraphic obj, IlvApplyObject f, Object arg, boolean redraw)` Applies a method to an object of this bag, that is to a sublink of this link bundle.
`IlvRect`	`boundingBox(IlvTransformer t)` Returns the bounding rectangle of the link bundle.
`boolean`	`contains(IlvPoint p, IlvPoint tp, IlvTransformer t)` Tests if a point lies within the outline of the link.
`boolean`	`containsFrame(IlvPoint p, IlvPoint tp, IlvTransformer t)` Tests if the specified point lie within the link bundle frame.
`IlvGraphic`	`copy()` Copies the object.
`void`	`deSelectAll()` Deselects all the sublinks in the link bundle.
`void`	`deSelectAll(boolean traverse)` Deselects all the sublinks in the link bundle.
`void`	`deSelectAll(boolean traverse, boolean redraw)` Deselects all the sublinks in the link bundle.
`void`	`draw(Graphics dst, IlvTransformer t)` Draws the link bundle.
`void`	`ensureClippingLinkConnector(boolean traverse, boolean redraw)` Ensures that a clip link connector is installed at the link bundle and all sublinks.
`IlvGraphicVector`	`getAllSelectableObjects(IlvPoint p, IlvManagerView view, IlvTransformer t, boolean traverse, boolean includeParentsIfInnerFound)` Returns all selectable object at the given point.
`IlvObjectWithSelection`	`getCollapseExpandObject(IlvPoint p, IlvManagerView view, IlvTransformer t, boolean traverse)` Returns the first object that should change its collapsed state when clicking at the input point.
`void`	`getConnectionPoints(IlvPoint src, IlvPoint dst, IlvTransformer t)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`IlvPoint`	`getConnectionReferencePoint(boolean origin, IlvTransformer t)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`int`	`getEndCap()` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`Color`	`getForeground()` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`IlvLinkBundleFrame`	`getFrame()` Returns the frame of the link bundle or `null`.
`int`	`getLineJoin()` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`float[]`	`getLineStyle()` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`double`	`getLineWidth()` Returns the line width of the object.
`double`	`getLineWidth(IlvTransformer t)` Returns the line width that is actually displayed when the link bundle is drawn with the specified transformer.
`double`	`getLineWidth(IlvTransformer t, boolean includingFrameMargin)` Returns the line width that is actually displayed when the link bundle is drawn with the specified transformer.
`IlvGraphicEnumeration`	`getLinkBundles()` Returns an enumeration of all the link bundles that have been added as sublinks in this link bundle.
`int`	`getLinkBundlesCount()` Returns the number of link bundles that have been added in this link bundle.
`IlvPoint[]`	`getLinkPoints(IlvTransformer t)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`double`	`getMaximumLineWidth()` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`IlvGraphic`	`getObject(String name)` Returns the sublink or overview link with the specified name, or `null` if there is no sublink with this name and the overview link does not have this name.
`String`	`getObjectName(IlvGraphic obj)` Returns the name of the specified graphic object.
`IlvGraphicEnumeration`	`getObjects()` You should not call this method.
`double`	`getOffset()` Returns the offset between the individual links of the bundle.
`double`	`getOverviewLineWidth()` Returns the line width of the bundle when it is in collapsed state.
`IlvLinkImage`	`getOverviewLink()` Returns the overview link.
`IlvPoint`	`getPointAt(int index, IlvTransformer t)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`int`	`getPointsCardinal()` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`JPopupMenu`	`getPopupMenu(IlvPoint p, IlvTransformer t, IlvManagerView view, IlvPopupMenuManager popupManager)` Returns the Swing pop-up menu to display when the pop-up is triggered.
`IlvLinkBundle`	`getRootLinkBundle()` Returns the root link bundle.
`IlvManager`	`getRootManager()` Returns the manager which contains the root link bundle, or `null` if the root link bundle is `null` or is not contained in a manager.
`IlvGraphic`	`getSelectableObject(IlvPoint p, IlvManagerView view, IlvTransformer t, boolean traverse)` Returns the first selectable object at the given point.
`IlvGraphicEnumeration`	`getSelectedObjects()` Returns an enumeration of all the selected sublinks of this link bundle.
`int`	`getSelectedObjectsCount()` Returns the number of selected sublinks of this link bundle.
`IlvGraphicEnumeration`	`getSelectedSublinks()` Returns an enumeration of all the selected sublinks of this link bundle.
`IlvGraphicEnumeration`	`getSelectedSublinks(boolean traverse)` Returns an enumeration of all the selected sublinks in this link bundle.
`int`	`getSelectedSublinksCount()` Returns the number of selected sublinks of this link bundle.
`int`	`getSelectedSublinksCount(boolean traverse)` Returns the number of selected sublinks.
`IlvSelection`	`getSelection(IlvLinkImage sublink)` Returns the selection object (instance of `IlvSelection`) associated with the specified sublink, or `null` if the sublink is not selected.
`IlvSelection`	`getSelection(IlvPoint tp, IlvTransformer t)` Returns the selection object (instance of `IlvSelection`) located at the specified transformed point.
`IlvSelection`	`getSelection(IlvPoint tp, IlvTransformer t, boolean traverse)` Returns the selection object (instance of `IlvSelection`) located at the specified transformed point.
`IlvSelectionFactory`	`getSelectionFactory()` Returns the selection factory installed in the grapher that contains the root link bundle of this link bundle, or `null` if no factory is installed or the link bundle is not added to a grapher.
`IlvLinkImage`	`getSublink(IlvPoint tp, IlvTransformer t)` Returns the sublink located at the specified transformed point, or `null` if any.
`IlvLinkImage`	`getSublink(IlvPoint tp, IlvTransformer t, boolean traverse)` Returns the sublink located at the specified transformed point, or `null` if any.
`IlvLinkImage`	`getSublink(int index)` Returns the sublink of this bundle at the given position.
`IlvLinkImage[]`	`getSublinks()` Returns the sublinks of this object.
`int`	`getSublinksCount()` Returns the number of sublinks of this link bundle.
`IlvGraphicEnumeration`	`getSublinksEnum()` Returns an enumeration of the sublinks of this link bundle.
`String`	`getToolTipText()` Returns the tooltip text set by `setToolTipText(java.lang.String)`.
`String`	`getToolTipText(IlvPoint p, IlvTransformer t)` Returns the tooltip text to display when the mouse pointer is at a specified location inside the link bundle.
`Object`	`getTreeLock()` Returns the object used to synchronize the content of the link bundle for multi-threaded environment.
`void`	`insertPoint(int index, double x, double y, IlvTransformer t)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`void`	`invalidateLayout()` Invalidates the internal layout of this link bundle.
`boolean`	`isCollapsed()` Returns the collapsed/expanded status of the link bundle.
`boolean`	`isCollapsible()` Returns whether the object can be collapsed or expanded.
`boolean`	`isLayoutValid()` Determines whether the internal layout of this link bundle is valid.
`boolean`	`isOriented()` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`boolean`	`isSelected(IlvGraphic object)` Returns `true` if the specified object is selected.
`boolean`	`isSelected(IlvLinkImage sublink)` Returns `true` if the specified sublink is selected.
`boolean`	`isSelectionAdjusting()` Returns whether we are currently selecting or deselecting a series of sublinks.
`boolean`	`isSingleConnectionPoint()` Returns `true` if the single connection point mode is enabled, and returns `false` otherwise.
`IlvSelection`	`makeSelection()` Creates a selection object for this object.
`void`	`moveObject(IlvGraphic obj, double x, double y, boolean redraw)` Changes the location of a graphic object.
`void`	`movePoint(int index, double x, double y, IlvTransformer t)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`boolean`	`pointsInBBox()` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`void`	`reDrawObj(IlvGraphic obj)` Redraws a graphic object contained in the set.
`void`	`reDrawRegion(IlvRegion region)` Redraws a region of the link bundle.
`void`	`removeLinkBundleSelectionChangedListener(LinkBundleSelectionChangedListener listener)` Removes the specified selection listener so that it no longer receives events from the link bundle when the selection of sublinks changes.
`void`	`removeObject(IlvGraphic obj, boolean redraw)` You should not call this method.
`void`	`removePoint(int index, IlvTransformer t)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`void`	`removeSublink(IlvLinkImage sublink)` Removes a sublink from the link bundle.
`void`	`reshapeObject(IlvGraphic obj, IlvRect newrect, boolean redraw)` Changes the size of a graphic object located in the link bundle.
`void`	`selectAll()` Selects all the visible sublinks in this link bundle.
`void`	`selectAll(boolean traverse)` Selects all the visible sublinks in the link bundle.
`void`	`selectAll(boolean traverse, boolean redraw)` Selects all the visible sublinks in this link bundle.
`protected void`	`selectionChanged(IlvLinkImage sublink)` Called when a selection changes in the link bundle.
`void`	`setCollapsed(boolean collapsed)` Collapses or expands the link bundle.
`void`	`setEndCap(int endCap)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`void`	`setForeground(Color c)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`void`	`setFrame(IlvLinkBundleFrame frame)` Sets the frame of the link bundle.
`void`	`setGraphicBag(IlvGraphicBag bag)` Changes the bag that contains the link bundle.
`void`	`setIntermediateLinkPoints(IlvPoint[] points, int index, int length)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`void`	`setLineJoin(int lineJoin)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`void`	`setLineStyle(float[] lineStyle)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`void`	`setLineWidth(double lineWidth)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`void`	`setMaximumLineWidth(double maximumLineWidth)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`boolean`	`setObjectName(IlvGraphic obj, String name)` Changes the name of a sublink or overview link of this link bundle.
`void`	`setOffset(double offset)` Sets the offset between the individual links of the bundle.
`void`	`setOriented(boolean oriented)` This method delegates to the link supplied with the method `setOverviewLink(ilog.views.IlvLinkImage)`.
`void`	`setOverviewLink(IlvLinkImage link)` Sets the link responsible for the rendering of the link bundle in collapsed state (see `isCollapsed()`).
`void`	`setSelected(IlvGraphic sublink, boolean select, boolean redraw)` Selects or deselects the specified sublink.
`void`	`setSelected(IlvGraphic obj, IlvPoint p, IlvManagerView view)` Selects the specified sublink.
`void`	`setSelected(IlvLinkImage sublink, boolean select)` Selects or deselects the specified sublink.
`void`	`setSelectionAdjusting(boolean set)` Starts a series of selection events.
`void`	`setSelectionEventSource(Object source)` Changes the source for selection events.
`void`	`setSingleConnectionPoint(boolean single)` Enables the single connection point mode.
`void`	`setSublink(int index, IlvLinkImage sublink)` Sets the given sublink at the supplied position.
`void`	`setSublinks(IlvLinkImage[] sublinks)` Sets a new collection of sublinks for this link bundle.
`void`	`setToolTipText(String text)` Sets the text to display in the tooltip of this link bundle.
`void`	`write(IlvOutputStream stream)` Writes the object to an `IlvOutputStream`.
`boolean`	`zoomable()` Returns `false`, since this graphic object is not zoomable.

Methods inherited from class ilog.views.graphic.IlvPolylineLinkImage
applyTransform

Methods inherited from class ilog.views.IlvLinkImage
arrowBBox, arrowContains, drawArrow, finalize, getArrowSize, getFrom, getFromBoundingBox, getFromTransformer, getLinkConnectorConnectionPoint, getLinkPoints, getLocalTransformerOf, getOpposite, getTo, getToBoundingBox, getToTransformer, getVisibleFrom, getVisibleTo, isPersistent, isSpline, setFrom, setLinkPoints, setTo

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

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

Methods inherited from interface ilog.views.IlvGraphicBag
getGraphicBag

- Constructor Detail
  - IlvLinkBundle
```
public IlvLinkBundle()
```
    Creates a new empty IlvLinkBundle instance. This default bean constructor exists only for internal use. Do not call it.
  - IlvLinkBundle
```
public IlvLinkBundle(IlvGraphic from,
                     IlvGraphic to,
                     boolean oriented)
```
    Creates a new IlvLinkBundle instance with no intermediate points and no overview link.
    
    Parameters:
    
    from - The origin node of the bundle.
    
    to - The destination node of the bundle.
    
    oriented - If true, an arrow is drawn at the destination point.
  - IlvLinkBundle
```
public IlvLinkBundle(IlvGraphic from,
                     IlvGraphic to,
                     boolean oriented,
                     IlvPoint[] points)
```
    Creates a new IlvLinkBundle instance with no overview link.
    
    Parameters:
    
    from - The origin node of the bundle.
    
    to - The destination node of the bundle.
    
    oriented - If true, an arrow is drawn at the destination point.
    
    points - The intermediate points of the polylink. If the array is null or its length is 0, the link is created without intermediate points.
  - IlvLinkBundle
```
public IlvLinkBundle(IlvGraphic from,
                     IlvGraphic to,
                     boolean oriented,
                     IlvPoint[] points,
                     IlvLinkImage overviewLink)
```
    Creates a new IlvLinkBundle instance.
    
    Parameters:
    
    from - The origin node of the bundle.
    
    to - The destination node of the bundle.
    
    oriented - If true, an arrow is drawn at the destination point.
    
    points - The intermediate points of the polylink. If the array is null or its length is 0, the link is created without intermediate points.
    
    overviewLink - The overview link (see setOverviewLink(ilog.views.IlvLinkImage)).
  - IlvLinkBundle
```
public IlvLinkBundle(IlvInputStream stream)
              throws IlvReadFileException
```
    Reads the object from an IlvInputStream.
    
    Parameters:
    
    stream - The input stream.
    
    Throws:
    
    IlvReadFileException - if the format is not correct.
  - IlvLinkBundle
```
public IlvLinkBundle(IlvLinkBundle source)
```
    Creates an IlvLinkBundle by copying an existing one.
    
    Parameters:
    
    source - The origin of the copy.
- Method Detail
  - copy
```
public IlvGraphic copy()
```
    Copies the object.
    
    Overrides:
    
    copy in class IlvPolylineLinkImage
    
    Returns:
    
    A copy of this IlvGraphic instance.
    
    See Also:
    
    IlvGraphic
  - getLinkBundles
```
public final IlvGraphicEnumeration getLinkBundles()
```
    Returns an enumeration of all the link bundles that have been added as sublinks in this link bundle.
    
    Returns:
    
    An enumeration of the IlvLinkBundle objects added in this link bundle.
  - getLinkBundlesCount
```
public final int getLinkBundlesCount()
```
    Returns the number of link bundles that have been added in this link bundle.
  - setGraphicBag
```
public void setGraphicBag(IlvGraphicBag bag)
```
    Changes the bag that contains the link bundle. For example, this method is used when the link bundle is added to, or removed from, an IlvGraphicBag such as an IlvGrapher. It is also used when the link bundle is added to, or removed from, the sublinks of another link bundle.
    You should not call this method directly unless you are creating a new type of bag. This method checks that the link bundle is added in a bag that is either an IlvGrapher or an IlvLinkBundle. Other bags are not allowed.
    
    Overrides:
    
    setGraphicBag in class IlvGraphic
    
    Parameters:
    
    bag - The graphic bag.
    
    See Also:
    
    IlvGraphic
  - getTreeLock
```
public final Object getTreeLock()
```
    Returns the object used to synchronize the content of the link bundle for multi-threaded environment.
  - getRootLinkBundle
```
public final IlvLinkBundle getRootLinkBundle()
```
    Returns the root link bundle. If a link bundle is not a sublink of another link bundle, this method returns null. Otherwise, it returns the link bundle which is on top of the containment hierarchy.
  - getRootManager
```
public final IlvManager getRootManager()
```
    Returns the manager which contains the root link bundle, or null if the root link bundle is null or is not contained in a manager.
  - setOverviewLink
```
public final void setOverviewLink(IlvLinkImage link)
```
    Sets the link responsible for the rendering of the link bundle in collapsed state (see isCollapsed()).
    By default, there is no overview link and the method getOverviewLink() returns null. In this case, the rendering of the link bundle in collapsed state is done by the link bundle class itself.
    When a link bundle has an overview link, any modification of the points of the link bundle is replicated by the link bundle on the overview link. Hence, the connection points and the intermediate points of the link bundle are always the same as those of the overview link.
    To remove the overview link that has been previously specified, you can call this method with a null argument.
    The following properties of the supplied link (if not null):
    are overridden by the corresponding properties of this IlvLinkBundle instance.
    Note that a call to this method can modify the bounding box of the link bundle. For this reason, if the link bundle is contained inside an IlvGraphicBag, this method can be called only using the method IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) of the graphic bag.
    See Also:
    
    setCollapsed(boolean), getOverviewLink()
  - getOverviewLink
```
public final IlvLinkImage getOverviewLink()
```
    Returns the overview link.
    
    See Also:
    
    setOverviewLink(ilog.views.IlvLinkImage)
  - addObject
```
public void addObject(IlvGraphic obj,
                      boolean redraw)
```
    You should not call this method. To add sublinks, use the method addSublink(IlvLinkImage). To specify the overview link, use the method setOverviewLink(ilog.views.IlvLinkImage).
    
    Specified by:
    
    addObject in interface IlvGraphicBag
    
    Parameters:
    
    obj - The graphic object.
    
    redraw - If true the object is redrawn.
  - removeObject
```
public void removeObject(IlvGraphic obj,
                         boolean redraw)
```
    You should not call this method. To remove a sublink, use the method removeSublink(ilog.views.IlvLinkImage).
    
    Specified by:
    
    removeObject in interface IlvGraphicBag
    
    Parameters:
    
    obj - The graphic object.
    
    redraw - If true the object is redrawn.
  - addSublink
```
public void addSublink(IlvLinkImage sublink)
```
    Adds a sublink at the end of the link bundle. Note that a sublink can be contained in only one link bundle, and the sublink cannot be contained by a grapher and a IlvLinkBundle at the same time.
    The sublinks can be of any class. Notice however that the link bundle must be allowed to move the points of the link (connection points and intermediate points if any). Hence, links of type IlvOneLinkImage, IlvDoubleLinkImage, IlvOneSplineLinkImage and IlvDoubleSplineLinkImage are usually not appropriate, because they don't allow the intermediate points to be moved freely.
    To obtain a consistent layout, it is not recommended to mix in the same bundle spline links (IlvSplineLinkImage) with polyline links (IlvSplineLinkImage etc.). Either use only polyline links, or use only spline links for both the sublinks and for the overview link. An overview link of type IlvSplineLinkImage should be set on the link bundle when the sublinks are splines.
    Also, a link connector class allowing the connection points to be moved freely must be installed either
    - On the origin and destination nodes of the link bundle. This is the simplest way, that can be used if you don't need different types of link connectors on other links incident to the origin and destination nodes.
    - On the sublinks and overview link themselves. This solution can be used if you need different types of link connectors on the origin/destination nodes than for the links of the link bundle.
    For details on how to attach a link connector to nodes or links, see the documentation of IlvLinkConnector. The recommended link connector is IlvClippingLinkConnector.
    Note that a call to this method can modify the bounding box of the link bundle. For this reason, if the link bundle is contained inside an IlvGraphicBag, this method can be called only using the method IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) of the graphic bag.
    Parameters:
    
    sublink - The sublink to be added. The value null is not allowed.
  - addSublink
```
public void addSublink(int index,
                       IlvLinkImage sublink)
```
    Adds a sublink at the specified index in the link bundle. This method inserts the specified sublink at the specified position in the array of sublinks. It shifts the sublink currently at that position (if any) and any subsequent sublink to the right (adds one to their indices).
    Note that a sublink can be contained in only one link bundle, and the sublink cannot be contained by a grapher and a IlvLinkBundle at the same time.
    The sublinks can be of any class. Notice however that the link bundle must be allowed to move the points of the link (connection points and intermediate points if any). Hence, links of type IlvOneLinkImage, IlvDoubleLinkImage, IlvOneSplineLinkImage and IlvDoubleSplineLinkImage are usually not appropriate, because they don't allow the intermediate points to be moved freely.
    To obtain a consistent layout, it is not recommended to mix in the same bundle spline links (IlvSplineLinkImage) with polyline links (IlvSplineLinkImage etc.). Either use only polyline links, or use only spline links for both the sublinks and for the overview link. An overview link of type IlvSplineLinkImage should be set on the link bundle when the sublinks are splines.
    Also, a link connector class allowing the connection points to be moved freely must be installed either
    - On the origin and destination nodes of the link bundle. This is the simplest way, that can be used if you don't need different types of link connectors on other links incident to the origin and destination nodes.
    - On the sublinks and overview link themselves. This solution can be used if you need different types of link connectors on the origin/destination nodes than for the links of the link bundle.
    For details on how to attach a link connector to nodes or links, see the documentation of (@link IlvLinkConnector}. The recommended link connector is IlvClippingLinkConnector.
    Note that a call to this method can modify the bounding box of the link bundle. For this reason, if the link bundle is contained inside an IlvGraphicBag, this method can be called only using the method IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) of the graphic bag.
    Parameters:
    
    index - The index at which the specified sublink is to be inserted. If the index is equal to getSublinksCount(), the specified sublink is added to the end.
    
    sublink - The sublink. The value null is not allowed.
    
    Throws:
    
    IndexOutOfBoundsException - if index is out of range (index< 0 || index >= getSublinksCount()).
  - removeSublink
```
public void removeSublink(IlvLinkImage sublink)
```
    Removes a sublink from the link bundle.
    Note that a call to this method can modify the bounding box of the link bundle. For this reason, if the link bundle is contained inside an IlvGraphicBag, this method can be called only using the method IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) of the graphic bag.
    
    Parameters:
    
    sublink - The sublink.
  - getSublink
```
public IlvLinkImage getSublink(IlvPoint tp,
                               IlvTransformer t)
```
    Returns the sublink located at the specified transformed point, or null if any.
    
    Parameters:
    
    tp - The point transformed by t.
    
    t - The transformer used to draw the object.
    
    See Also:
    
    getSublink(IlvPoint, IlvTransformer, boolean)
  - getSublink
```
public IlvLinkImage getSublink(IlvPoint tp,
                               IlvTransformer t,
                               boolean traverse)
```
    Returns the sublink located at the specified transformed point, or null if any. This method will traverse the link bundles that have been added as sublinks in this link bundle if the traverse parameter is set to true.
    
    Parameters:
    
    tp - The point transformed by t.
    
    t - The transformer used to draw the object.
    
    traverse - If true, this method will recursively traverse the link bundles added as sublinks of this link bundle to find the sublink located at the specified point.
    
    See Also:
    
    getSublink(IlvPoint, IlvTransformer), getSelection(IlvPoint, IlvTransformer), getSelection(IlvPoint, IlvTransformer, boolean), getLinkBundles()
  - getCollapseExpandObject
```
public IlvObjectWithSelection getCollapseExpandObject(IlvPoint p,
                                                      IlvManagerView view,
                                                      IlvTransformer t,
                                                      boolean traverse)
```
    Returns the first object that should change its collapsed state when clicking at the input point. It checks whether the input point is inside the collapse/expand icon of a link bundle. It returns null if no object is found.
    
    Specified by:
    
    getCollapseExpandObject in interface IlvObjectWithSelection
    
    Parameters:
    
    p - The point in the view coordinate system.
    
    view - The view. Can be null.
    
    t - The transformer to draw this link bundle.
    
    traverse - If true, the method will also search recursively the subobjects contained in subobjects of this object, unless they are collapsed.
    
    Returns:
    
    The graphic object that can be collapsed or expanded located at the input point.
    
    Since:
    
    JViews 8.8
  - getSelectableObject
```
public IlvGraphic getSelectableObject(IlvPoint p,
                                      IlvManagerView view,
                                      IlvTransformer t,
                                      boolean traverse)
```
    Returns the first selectable object at the given point.
    
    Specified by:
    
    getSelectableObject in interface IlvObjectWithSelection
    
    Parameters:
    
    p - The point in the view coordinates system.
    
    view - The view. Can be null.
    
    t - The transformer to draw this link bundle.
    
    traverse - If true, the method will also search recursively the subobjects contained in subobjects of this object, unless they are collapsed.
    
    Returns:
    
    The graphic object located at the input point.
    
    Since:
    
    JViews 8.8
  - getAllSelectableObjects
```
public IlvGraphicVector getAllSelectableObjects(IlvPoint p,
                                                IlvManagerView view,
                                                IlvTransformer t,
                                                boolean traverse,
                                                boolean includeParentsIfInnerFound)
```
    Returns all selectable object at the given point.
    
    Specified by:
    
    getAllSelectableObjects in interface IlvObjectWithSelection
    
    Parameters:
    
    p - The point in the view coordinates system.
    
    view - The view. Can be null.
    
    t - The transformer to draw this link bundle.
    
    traverse - If true, the method will also search recursively the subobjects contained in subobjects of this object, unless they are collapsed.
    
    includeParentsIfInnerFound - If false, the result will contain an object of type IlvObjectWithSelection * located at the input point only if it does not contain any subobjects * of the object. If true, the result will contain an object * of type IlvObjectWithSelection at the input point even if * it also contains subobjects of the object.
    
    Returns:
    
    The graphic objects located at the input point.
    
    Since:
    
    JViews 8.8
  - getSelection
```
public IlvSelection getSelection(IlvPoint tp,
                                 IlvTransformer t)
```
    Returns the selection object (instance of IlvSelection) located at the specified transformed point.
    
    Parameters:
    
    tp - The transformed point.
    
    t - The transformer used for drawing the object.
    
    See Also:
    
    getSelection(IlvPoint, IlvTransformer, boolean), getSublink(IlvPoint, IlvTransformer), getSublink(IlvPoint, IlvTransformer, boolean), setSelected(ilog.views.IlvLinkImage, boolean)
  - getSelection
```
public IlvSelection getSelection(IlvPoint tp,
                                 IlvTransformer t,
                                 boolean traverse)
```
    Returns the selection object (instance of IlvSelection) located at the specified transformed point. If the traverse parameter is set to true, this method will traverse the link bundles added in this link bundle.
    
    Parameters:
    
    tp - The transformed point.
    
    t - The transformer used for drawing the object.
    
    traverse - If true, the method will recursively traverse the link bundles added in this link bundle to find the selection object located at the specified point.
    
    See Also:
    
    getSublink(IlvPoint, IlvTransformer), getSublink(IlvPoint, IlvTransformer, boolean), setSelected(ilog.views.IlvLinkImage, boolean), getLinkBundles()
  - getObject
```
public IlvGraphic getObject(String name)
```
    Returns the sublink or overview link with the specified name, or null if there is no sublink with this name and the overview link does not have this name.
    
    Specified by:
    
    getObject in interface IlvGraphicBag
    
    Parameters:
    
    name - The name.
    
    See Also:
    
    getObjectName(ilog.views.IlvGraphic), setObjectName(ilog.views.IlvGraphic, java.lang.String)
  - setObjectName
```
public boolean setObjectName(IlvGraphic obj,
                             String name)
```
    Changes the name of a sublink or overview link of this link bundle. Note that the link bundle makes sure that there are never two objects with the same name, so this method may return false if an object already has the specified name. In this case the name is not changed.
    
    Specified by:
    
    setObjectName in interface IlvGraphicBag
    
    Parameters:
    
    obj - The graphic object. This object must be already added to this link bundle (as a sublink or as its overview link); otherwise, an IllegalArgumentException is thrown.
    
    name - The desired name.
    
    Returns:
    
    false if the name could not be changed.
    
    See Also:
    
    getObjectName(ilog.views.IlvGraphic), getObject(java.lang.String)
  - getObjectName
```
public String getObjectName(IlvGraphic obj)
```
    Returns the name of the specified graphic object. If no name was given to the object using setObjectName, then this method returns null.
    
    Parameters:
    
    obj - The graphic object.
    
    See Also:
    
    setObjectName(ilog.views.IlvGraphic, java.lang.String), getObject(String)
  - getPopupMenu
```
public JPopupMenu getPopupMenu(IlvPoint p,
                               IlvTransformer t,
                               IlvManagerView view,
                               IlvPopupMenuManager popupManager)
```
    Returns the Swing pop-up menu to display when the pop-up is triggered. This happens when the mouse pointer is at a specified location inside the graphic object.
    
    Overrides:
    
    getPopupMenu in class IlvGraphic
    
    Parameters:
    
    p - The location of the mouse in view coordinates.
    
    t - The transformer that converts the manager coordinates of this object into the coordinate system of the manager view in which the pop-up menu will be displayed (the view coordinates).
    
    view - The manager view that triggered the pop-up menu.
    
    popupManager - The pop-up menu manager.
    
    Returns:
    
    The Swing pop-up menu, which can be null.
    
    Since:
    
    JViews 8.8
    
    See Also:
    
    IlvGraphic, IlvPopupMenuManager.registerView(ilog.views.IlvManagerView), IlvGraphic.getPopupMenu()
  - setToolTipText
```
public void setToolTipText(String text)
```
    Sets the text to display in the tooltip of this link bundle. Notice that, if the mouse is over a sublink that has a tooltip, its tooltip is shown. The tooltip of the link bundle itself is shown if the mouse is over the link bundle but not over a sublink, or the sublink doesn't have a tootip.
    Tooltips for Perforce JViews graphic objects will work only if your manager view is contained in a hierarchy of Swing components. In addition, you must enable the tooltip mechanism for the manager view by calling the static method IlvToolTipManager.registerView(IlvManagerView).
    
    Overrides:
    
    setToolTipText in class IlvGraphic
    
    Parameters:
    
    text - The tooltip string to display. If text is null, the tooltip is turned off for this link bundle.
    
    See Also:
    
    IlvToolTipManager, getToolTipText(), getToolTipText(IlvPoint, IlvTransformer)
  - getToolTipText
```
public String getToolTipText()
```
    Returns the tooltip text set by setToolTipText(java.lang.String).
    
    Overrides:
    
    getToolTipText in class IlvGraphic
    
    Returns:
    
    The tooltip string, which can be null.
    
    See Also:
    
    getToolTipText(IlvPoint, IlvTransformer)
  - getToolTipText
```
public String getToolTipText(IlvPoint p,
                             IlvTransformer t)
```
    Returns the tooltip text to display when the mouse pointer is at a specified location inside the link bundle. If the link bundle is in expanded state (see setCollapsed(boolean), the method returns the tooltip of a sublink over which the point is located, if any. Otherwise, it returns the tooltip of the link bundle itself.
    You can override this method to display different tooltip texts over different parts of your link bundle object.
    If this method returns null, no tooltip is shown for this link bundle.
    Note that you must enable the tooltip mechanism for the manager view by calling the static method IlvToolTipManager.registerView(IlvManagerView).
    
    Overrides:
    
    getToolTipText in class IlvGraphic
    
    Parameters:
    
    p - The location of the mouse (in view coordinates).
    
    t - The transformer of the manager view in which the tooltip is about to be displayed.
    
    Returns:
    
    The tooltip at point p for transformation t, or null if no tooltip should be displayed.
    
    See Also:
    
    getToolTipText()
  - setSelected
```
public void setSelected(IlvLinkImage sublink,
                        boolean select)
```
    Selects or deselects the specified sublink.
    When a sublink is selected, another graphic object is created to show that this object is selected. This new graphic object is called the selection object and is an instance of the class IlvSelection.
    If a selection factory is installed on the grapher that contains the bundle (see setSelectionFactory), this factory is responsible for creating the selection object. The same holds for nested bundles: a bundle used as sublink inside another bundle uses the factory of the grapher that contains the root bundle.
    Otherwise, the method makeSelection of the class IlvGraphic is called.
    This method also fires a LinkBundleSelectionChangedEvent event by calling the method selectionChanged.
    Note that selecting or deselecting a sublink can change the bounding box of the link bundle and if the link bundle is contained inside an IlvGraphicBag, this method can be called only using the method IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) of the graphic bag. If you need to select only one link at a time, you can more conveniently use the method setSelected(IlvGraphic, boolean, boolean) which calls IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) automatically.
    
    Parameters:
    
    sublink - The graphic object to select or deselect.
    
    select - If true the object will be selected, and deselected otherwise.
    
    See Also:
    
    isSelected(ilog.views.IlvLinkImage), getSelection(IlvLinkImage), selectAll(), selectAll(boolean), deSelectAll(), getSelectedSublinks(), getSelectedSublinksCount(), addLinkBundleSelectionChangedListener(ilog.views.graphic.linkbundle.event.LinkBundleSelectionChangedListener), removeLinkBundleSelectionChangedListener(ilog.views.graphic.linkbundle.event.LinkBundleSelectionChangedListener)
  - setSelected
```
public void setSelected(IlvGraphic sublink,
                        boolean select,
                        boolean redraw)
```
    Selects or deselects the specified sublink. This convenience method uses IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) to call setSelected(IlvLinkImage, boolean).
    
    Specified by:
    
    setSelected in interface IlvObjectWithSelection
    
    Parameters:
    
    sublink - The graphic object to select or deselect.
    
    select - If true the object will be selected, and deselected otherwise.
    
    redraw - Whether the object must be redrawn.
    
    Since:
    
    JViews 8.8
    
    See Also:
    
    setSelected(IlvLinkImage, boolean)
  - setSelected
```
public void setSelected(IlvGraphic obj,
                        IlvPoint p,
                        IlvManagerView view)
```
    Selects the specified sublink. This method is called from the select interactor when selecting the object under the point in the view. Normally you should not call this method.
    The default implementation calls setSelected(obj, true, true). Subclasses can override this method to select subparts of the input object located on the input point.
    
    Specified by:
    
    setSelected in interface IlvObjectWithSelection
    
    Parameters:
    
    obj - The object to be selected.
    
    p - The point in the manager view where the mouse click occurred.
    
    view - The view currently handled by the select interactor.
    
    Since:
    
    JViews 8.8
    
    See Also:
    
    setSelected(IlvGraphic, boolean, boolean)
  - selectionChanged
```
protected void selectionChanged(IlvLinkImage sublink)
```
    Called when a selection changes in the link bundle. It notifies the selection listeners.
    
    Parameters:
    
    sublink - The selected or deselected sublink.
    
    See Also:
    
    setSelected(ilog.views.IlvLinkImage, boolean), addLinkBundleSelectionChangedListener(ilog.views.graphic.linkbundle.event.LinkBundleSelectionChangedListener), removeLinkBundleSelectionChangedListener(ilog.views.graphic.linkbundle.event.LinkBundleSelectionChangedListener)
  - selectAll
```
public void selectAll()
```
    Selects all the visible sublinks in this link bundle.
    Note that selecting or deselecting a sublink can change the bounding box of the link bundle and if the link bundle is contained inside an IlvGraphicBag, this method can be called only using the method IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) of the graphic bag. You can more conveniently use the method selectAll(boolean, boolean) which calls IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) automatically.
    
    See Also:
    
    isSelected(ilog.views.IlvLinkImage), setSelected(ilog.views.IlvLinkImage, boolean), getSelection(IlvLinkImage), deSelectAll(), selectAll(boolean), selectAll(boolean, boolean), getSelectedSublinks()
  - selectAll
```
public void selectAll(boolean traverse)
```
    Selects all the visible sublinks in the link bundle. This method can also select the sublinks in the link bundles added as sublinks of this link bundle.
    Note that selecting or deselecting a sublink can change the bounding box of the link bundle and if the link bundle is contained inside an IlvGraphicBag, this method can be called only using the method IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) of the graphic bag. You can more conveniently use the method selectAll(boolean, boolean) which calls IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) automatically.
    
    Parameters:
    
    traverse - If true, the method will also select recursively the sublinks in the link bundles added as sublinks of this link bundle./
    
    See Also:
    
    isSelected(ilog.views.IlvLinkImage), setSelected(ilog.views.IlvLinkImage, boolean), getSelection(IlvLinkImage), deSelectAll(), selectAll(), selectAll(boolean, boolean), getSelectedSublinks(boolean), getLinkBundles()
  - selectAll
```
public void selectAll(boolean traverse,
                      boolean redraw)
```
    Selects all the visible sublinks in this link bundle. This method can also select the sublinks in the link bundles added as sublinks of this link bundle. This convenience method uses IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) to call selectAll(boolean).
    
    Specified by:
    
    selectAll in interface IlvObjectWithSelection
    
    Parameters:
    
    traverse - If true, the method will also select recursively the sublinks in the link bundles added as sublinks of this link bundle./
    
    redraw - Whether the object must be redrawn.
    
    Since:
    
    JViews 8.8
    
    See Also:
    
    selectAll(boolean)
  - deSelectAll
```
public void deSelectAll()
```
    Deselects all the sublinks in the link bundle.
    Note that selecting or deselecting a sublink can change the bounding box of the link bundle and if the link bundle is contained inside an IlvGraphicBag, this method can be called only using the method IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) of the graphic bag. You can more conveniently use the method deSelectAll(boolean, boolean) which calls IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) automatically.
    
    See Also:
    
    isSelected(ilog.views.IlvLinkImage), setSelected(ilog.views.IlvLinkImage, boolean), getSelection(IlvLinkImage), deSelectAll(boolean), deSelectAll(boolean, boolean), selectAll(), selectAll(boolean), getSelectedSublinks()
  - deSelectAll
```
public void deSelectAll(boolean traverse)
```
    Deselects all the sublinks in the link bundle. This method can also deselect the sublinks contained in link bundles added in this link bundle if the traverse parameter is set to true.
    Note that selecting or deselecting a sublink can change the bounding box of the link bundle and if the link bundle is contained inside an IlvGraphicBag, this method can be called only using the method IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) of the graphic bag. You can more conveniently use the method deSelectAll(boolean, boolean) which calls IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) automatically.
    
    Parameters:
    
    traverse - If true, the method will also deselect recursively the link bundles added in this link bundle.
    
    See Also:
    
    isSelected(ilog.views.IlvLinkImage), setSelected(ilog.views.IlvLinkImage, boolean), getSelection(IlvLinkImage), deSelectAll(), deSelectAll(boolean, boolean), selectAll(), selectAll(boolean), getSelectedSublinks(boolean), getLinkBundles()
  - deSelectAll
```
public void deSelectAll(boolean traverse,
                        boolean redraw)
```
    Deselects all the sublinks in the link bundle. This method can also deselect the sublinks contained in link bundles added in this link bundle if the traverse parameter is set to true. This convenience method uses IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) to call deSelectAll(boolean).
    
    Specified by:
    
    deSelectAll in interface IlvObjectWithSelection
    
    Parameters:
    
    traverse - If true, the method will also deselect recursively the link bundles added in this link bundle.
    
    redraw - Whether the object must be redrawn.
    
    Since:
    
    JViews 8.8
    
    See Also:
    
    deSelectAll(boolean)
  - getSelectionFactory
```
public IlvSelectionFactory getSelectionFactory()
```
    Returns the selection factory installed in the grapher that contains the root link bundle of this link bundle, or null if no factory is installed or the link bundle is not added to a grapher.
  - setSelectionEventSource
```
public void setSelectionEventSource(Object source)
```
    Changes the source for selection events. This method is part of JViews internals. You should not use it.
    
    Specified by:
    
    setSelectionEventSource in interface IlvObjectWithSelection
  - setSelectionAdjusting
```
public void setSelectionAdjusting(boolean set)
```
    Starts a series of selection events. You can call this method with the parameter set to true when you want upcoming selection or deselection of sublinks to be considered as a single selection event. In this case, events of the class LinkBundleSelectionChangedEvent sent by the method setSelected will return true to a call of LinkBundleSelectionChangedEvent.isAdjusting(), meaning that they are part of a series of events. When you have finished selecting or deselecting the series of sublinks, you must call the method with the parameter set to false.
    
    Specified by:
    
    setSelectionAdjusting in interface IlvObjectWithSelection
    
    See Also:
    
    LinkBundleSelectionChangedEvent.isAdjusting(), LinkBundleSelectionChangedEvent.isAdjustmentEnd()
  - isSelectionAdjusting
```
public boolean isSelectionAdjusting()
```
    Returns whether we are currently selecting or deselecting a series of sublinks.
    
    Specified by:
    
    isSelectionAdjusting in interface IlvObjectWithSelection
    
    See Also:
    
    setSelectionAdjusting(boolean)
  - addLinkBundleSelectionChangedListener
```
public void addLinkBundleSelectionChangedListener(LinkBundleSelectionChangedListener listener)
```
    Adds the specified listener to receive events from the link bundle when the selection of sublinks changes.
    
    Parameters:
    
    listener - The listener.
    
    See Also:
    
    removeLinkBundleSelectionChangedListener(ilog.views.graphic.linkbundle.event.LinkBundleSelectionChangedListener), setSelected(ilog.views.IlvLinkImage, boolean), selectionChanged(IlvLinkImage)
  - removeLinkBundleSelectionChangedListener
```
public void removeLinkBundleSelectionChangedListener(LinkBundleSelectionChangedListener listener)
```
    Removes the specified selection listener so that it no longer receives events from the link bundle when the selection of sublinks changes.
    
    Parameters:
    
    listener - The listener.
    
    See Also:
    
    addLinkBundleSelectionChangedListener(ilog.views.graphic.linkbundle.event.LinkBundleSelectionChangedListener), setSelected(ilog.views.IlvLinkImage, boolean), selectionChanged(IlvLinkImage)
  - getSelectedSublinks
```
public final IlvGraphicEnumeration getSelectedSublinks()
```
    Returns an enumeration of all the selected sublinks of this link bundle. Be cautioned that you should not select, deselect, remove, or add any sublink while using the returned enumeration.
    
    See Also:
    
    isSelected(ilog.views.IlvLinkImage), setSelected(ilog.views.IlvLinkImage, boolean), getSelection(IlvLinkImage), deSelectAll(boolean), selectAll(), selectAll(boolean), getSelectedSublinks(), getSelectedSublinksCount()
  - getSelectedObjects
```
public final IlvGraphicEnumeration getSelectedObjects()
```
    Returns an enumeration of all the selected sublinks of this link bundle. This is just an alias for getSelectedSublinks().
    
    Specified by:
    
    getSelectedObjects in interface IlvObjectWithSelection
    
    Since:
    
    JViews 8.8
  - getSelectedSublinks
```
public final IlvGraphicEnumeration getSelectedSublinks(boolean traverse)
```
    Returns an enumeration of all the selected sublinks in this link bundle. The method will also return recursively the selected sublinks of link bundles added in this link bundle if the parameter traverse is set to true.
    
    Parameters:
    
    traverse - If true, the method will also return the selected sublinks of link bundles added in this link bundle recursively. Be cautioned that you should not select, deselect, remove, or add any sublink while using the returned enumeration.
    
    See Also:
    
    isSelected(ilog.views.IlvLinkImage), setSelected(ilog.views.IlvLinkImage, boolean), getSelection(IlvLinkImage), selectAll(), selectAll(boolean), getSelectedSublinks(), getSelectedSublinksCount(boolean), getLinkBundles()
  - getSelectedSublinksCount
```
public final int getSelectedSublinksCount()
```
    Returns the number of selected sublinks of this link bundle.
    
    See Also:
    
    getSelectedSublinksCount(boolean), isSelected(ilog.views.IlvLinkImage), setSelected(ilog.views.IlvLinkImage, boolean), getSelection(IlvLinkImage), deSelectAll(), selectAll(), selectAll(boolean), getSelectedSublinks()
  - getSelectedObjectsCount
```
public final int getSelectedObjectsCount()
```
    Returns the number of selected sublinks of this link bundle. This is just an alias for getSelectedSublinksCount().
    
    Specified by:
    
    getSelectedObjectsCount in interface IlvObjectWithSelection
    
    Since:
    
    JViews 8.8
  - getSelectedSublinksCount
```
public final int getSelectedSublinksCount(boolean traverse)
```
    Returns the number of selected sublinks. This method can return the total number of selected sublinks in this link bundle and in the link bundles added in this link bundle recursively if the parameter traverse is set to true.
    
    Parameters:
    
    traverse - If true, the method will count the selected sublinks of link bundles added in this link bundle recursively.
    
    See Also:
    
    isSelected(ilog.views.IlvLinkImage), setSelected(ilog.views.IlvLinkImage, boolean), getSelection(IlvLinkImage), deSelectAll(), selectAll(), selectAll(boolean), getSelectedSublinks(boolean), getLinkBundles()
  - isSelected
```
public boolean isSelected(IlvLinkImage sublink)
```
    Returns true if the specified sublink is selected.
    
    Parameters:
    
    sublink - The sublink.
    
    See Also:
    
    setSelected(ilog.views.IlvLinkImage, boolean), getSelection(IlvLinkImage)
  - isSelected
```
public boolean isSelected(IlvGraphic object)
```
    Returns true if the specified object is selected. This is the same as isSelected(IlvLinkImage).
    
    Specified by:
    
    isSelected in interface IlvObjectWithSelection
    
    Parameters:
    
    object - The sublink.
    
    Since:
    
    JViews 8.8
    
    See Also:
    
    setSelected(ilog.views.IlvLinkImage, boolean)
  - getSelection
```
public final IlvSelection getSelection(IlvLinkImage sublink)
```
    Returns the selection object (instance of IlvSelection) associated with the specified sublink, or null if the sublink is not selected.
    
    Parameters:
    
    sublink - The sublink.
    
    See Also:
    
    setSelected(ilog.views.IlvLinkImage, boolean)
  - setOffset
```
public void setOffset(double offset)
```
    Sets the offset between the individual links of the bundle.
    
    Parameters:
    
    offset - The offset value
    
    See Also:
    
    getOffset()
  - getOffset
```
public double getOffset()
```
    Returns the offset between the individual links of the bundle.
    
    Returns:
    
    The offset value.
    
    See Also:
    
    setOffset(double)
  - setSingleConnectionPoint
```
public void setSingleConnectionPoint(boolean single)
```
    Enables the single connection point mode. In this mode, all the links of a bundle start at a unique start point, and end at a unique end point. The default value is false.
    
    See Also:
    
    isSingleConnectionPoint()
  - isSingleConnectionPoint
```
public boolean isSingleConnectionPoint()
```
    Returns true if the single connection point mode is enabled, and returns false otherwise.
    
    See Also:
    
    setSingleConnectionPoint(boolean)
  - setCollapsed
```
public void setCollapsed(boolean collapsed)
```
    Collapses or expands the link bundle.
    
    Specified by:
    
    setCollapsed in interface IlvObjectWithSelection
    
    Parameters:
    
    collapsed - When set to true, the link bundle is collapsed. Otherwise, the link bundle is expanded.
    
    See Also:
    
    isCollapsed()
  - isCollapsed
```
public boolean isCollapsed()
```
    Returns the collapsed/expanded status of the link bundle.
    
    Specified by:
    
    isCollapsed in interface IlvObjectWithSelection
    
    See Also:
    
    setCollapsed(boolean)
  - isCollapsible
```
public final boolean isCollapsible()
```
    Returns whether the object can be collapsed or expanded. Link bundles are always collapsible.
    
    Specified by:
    
    isCollapsible in interface IlvObjectWithSelection
    
    Since:
    
    JViews 8.8
  - draw
```
public void draw(Graphics dst,
                 IlvTransformer t)
```
    Draws the link bundle.
    
    Overrides:
    
    draw in class IlvLinkImage
    
    Parameters:
    
    dst - The destination Graphics.
    
    t - The transformation used to draw the object.
    
    See Also:
    
    IlvGraphic.callDraw(Graphics,IlvTransformer), IlvGraphic.boundingBox(IlvTransformer), IlvGraphic.zoomable(), IlvGraphic
  - boundingBox
```
public IlvRect boundingBox(IlvTransformer t)
```
    Returns the bounding rectangle of the link bundle.
    
    Specified by:
    
    boundingBox in interface IlvPolyPointsInterface
    
    Overrides:
    
    boundingBox in class IlvLinkImage
    
    Parameters:
    
    t - The transformer used to draw the link bundle.
    
    See Also:
    
    IlvGraphic.draw(java.awt.Graphics, ilog.views.IlvTransformer), IlvGraphic.zoomable(), IlvGraphic
  - isLayoutValid
```
public final boolean isLayoutValid()
```
    Determines whether the internal layout of this link bundle is valid.
    
    See Also:
    
    invalidateLayout()
  - invalidateLayout
```
public final void invalidateLayout()
```
    Invalidates the internal layout of this link bundle.
    
    See Also:
    
    isLayoutValid()
  - getFrame
```
public IlvLinkBundleFrame getFrame()
```
    Returns the frame of the link bundle or null.
    
    See Also:
    
    setFrame(ilog.views.graphic.linkbundle.IlvLinkBundleFrame)
  - setFrame
```
public void setFrame(IlvLinkBundleFrame frame)
```
    Sets the frame of the link bundle. The frame is responsible for drawing the background and a border around the link bundle.
    The frame is drawn when the link bundle is used as a sublink inside a grapher or inside another link bundle (nested link bundles).
    Note that changing the frame may change the bounding box of the link bundle. If the link bundle is already added in an graphic bag, you must use the applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) method to change the frame. This is also true when changing a property of a frame that is already attached to a link bundle.
    By default, there is no frame (the method getFrame() returns null. A default implementation of IlvLinkBundleFrame is provided: IlvDefaultLinkBundleFrame.
    Note that this method can be called with a null argument in order to go back to the default behavior (no frame).
    
    Parameters:
    
    frame - The new frame or null..
    
    See Also:
    
    getFrame(), IlvDefaultLinkBundleFrame
  - contains
```
public boolean contains(IlvPoint p,
                        IlvPoint tp,
                        IlvTransformer t)
```
    Tests if a point lies within the outline of the link.
    
    Overrides:
    
    contains in class IlvLinkImage
    
    Parameters:
    
    p - The point to be tested.
    
    tp - The point p transformed by the transformer t.
    
    t - The transformer used for drawing the object.
    
    Returns:
    
    true if the point lies inside this graphic object.
    
    See Also:
    
    IlvGraphic
  - containsFrame
```
public boolean containsFrame(IlvPoint p,
                             IlvPoint tp,
                             IlvTransformer t)
```
    Tests if the specified point lie within the link bundle frame.
    If the bundle is collapsed, the method contains(IlvPoint, IlvPoint, IlvTransformer) is called. Otherwise, the method IlvLinkBundleFrame.contains(ilog.views.graphic.linkbundle.IlvLinkBundle, ilog.views.IlvPoint, ilog.views.IlvPoint, ilog.views.IlvTransformer) is called.
    
    Parameters:
    
    p - The point to be tested.
    
    tp - The point p transformed by the transformer t.
    
    t - The transformation used to draw the object.
    
    See Also:
    
    IlvLinkBundleFrame
  - setSublinks
```
public void setSublinks(IlvLinkImage[] sublinks)
```
    Sets a new collection of sublinks for this link bundle.
    The sublinks can be of any class. Notice however that the link bundle must be allowed to move the points of the link (connection points and intermediate points if any). Hence, links of type IlvOneLinkImage, IlvDoubleLinkImage, IlvOneSplineLinkImage and IlvDoubleSplineLinkImage are usually not appropriate, because they don't allow the intermediate points to be moved freely.
    To obtain a consistent layout, it is not recommended to mix in the same bundle spline links (IlvSplineLinkImage) with polyline links (IlvSplineLinkImage etc.). Either use only polyline links, or use only spline links for both the sublinks and for the overview link. An overview link of type IlvSplineLinkImage should be set on the link bundle when the sublinks are splines.
    Also, a link connector class allowing the connection points to be moved freely must be installed either
    - On the origin and destination nodes of the link bundle. This is the simplest way, that can be used if you don't need different types of link connectors on other links incident to the origin and destination nodes.
    - On the sublinks and overview link themselves. This solution can be used if you need different types of link connectors on the origin/destination nodes than for the links of the link bundle.
    For details on how to attach a link connector to nodes or links, see the documentation of IlvLinkConnector. The recommended link connector is IlvClippingLinkConnector.
    Note that a call to this method can modify the bounding box of this link bundle. For this reason, if the link bundle is contained inside an IlvGraphicBag, this method can be called only using the method IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) of the graphic bag.
    Parameters:
    
    sublinks - Array of sublinks to be added. The value null or an empty array removes all the sublinks.
  - getObjects
```
public final IlvGraphicEnumeration getObjects()
```
    You should not call this method. Use the methods getSublinks() or getSublinksEnum() instead.
    
    Specified by:
    
    getObjects in interface IlvGraphicBag
    
    Returns:
    
    An enumeration of IlvGraphic objects, or null.
  - getSublinks
```
public final IlvLinkImage[] getSublinks()
```
    Returns the sublinks of this object. The returned value is null if there is no sublinks.
    Notice that a new array is constructed each time the method is called. Hence, to add, remove or replace sublinks, you must use the appropriate methods, not to directly modify the returned array.
  - getSublinksEnum
```
public final IlvGraphicEnumeration getSublinksEnum()
```
    Returns an enumeration of the sublinks of this link bundle.
    
    Returns:
    
    An enumeration of the sublinks added in this link bundle. All elements are of type IlvLinkImage or subclasses.
  - getSublinksCount
```
public final int getSublinksCount()
```
    Returns the number of sublinks of this link bundle.
  - setSublink
```
public void setSublink(int index,
                       IlvLinkImage sublink)
```
    Sets the given sublink at the supplied position.
    Note that a call to this method can modify the bounding box of the link bundle. For this reason, if the link bundle is contained in an IlvGraphicBag, this method can be called only using the method IlvGraphicBag.applyToObject(ilog.views.IlvGraphic, ilog.views.IlvApplyObject, java.lang.Object, boolean) of the graphic bag.
    
    Parameters:
    
    index - The position of the sublink to be set. If index is equal to getSublinksCount(), the sublink is added at the end of the current array of sublinks. If index is in the range (index>= 0 || index < getSublinksCount()), the sublink is replaces the existing sublink at this index.
    sublink - The sublink to be added. The value null is not allowed. Throws: IndexOutOfBoundsException - if index is out of range (index< 0 || index > getSublinksCount()).
  getSublink public IlvLinkImage getSublink(int index) Returns the sublink of this bundle at the given position. Parameters: index - The index of the sublink. Throws: IndexOutOfBoundsException - if index is out of range (index< 0 || index >= getSublinksCount()). getPointsCardinal public int getPointsCardinal() This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Specified by: getPointsCardinal in interface IlvPolyPointsInterface Overrides: getPointsCardinal in class IlvPolylineLinkImage See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.getPointsCardinal() allowsPointInsertion public boolean allowsPointInsertion() This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Specified by: allowsPointInsertion in interface IlvPolyPointsInterface Overrides: allowsPointInsertion in class IlvPolylineLinkImage Returns: Always true. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.allowsPointInsertion() allowsPointRemoval public boolean allowsPointRemoval() This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Specified by: allowsPointRemoval in interface IlvPolyPointsInterface Overrides: allowsPointRemoval in class IlvPolylineLinkImage Returns: true if at least one intermediate point exists and false otherwise. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.allowsPointRemoval() allowsPointMove public boolean allowsPointMove(int index) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Specified by: allowsPointMove in interface IlvPolyPointsInterface Overrides: allowsPointMove in class IlvLinkImage Parameters: index - The index of the point. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.allowsPointMove(int) insertPoint public void insertPoint(int index, double x, double y, IlvTransformer t) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Specified by: insertPoint in interface IlvPolyPointsInterface Overrides: insertPoint in class IlvPolylineLinkImage Parameters: index - The index at which the new point will be inserted. x - The x coordinate of the new point (in manager coordinates). y - The y coordinate of the new point (in manager coordinates). t - The transformer used to draw the link. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.insertPoint(int, double, double, ilog.views.IlvTransformer) removePoint public void removePoint(int index, IlvTransformer t) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Specified by: removePoint in interface IlvPolyPointsInterface Overrides: removePoint in class IlvPolylineLinkImage Parameters: index - The index of the point to be removed. t - The transformer used to draw the link. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.removePoint(int, ilog.views.IlvTransformer) getPointAt public IlvPoint getPointAt(int index, IlvTransformer t) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Specified by: getPointAt in interface IlvPolyPointsInterface Overrides: getPointAt in class IlvPolylineLinkImage Parameters: index - The index of the point. t - The transformer through which the object is drawn. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.getPointAt(int, ilog.views.IlvTransformer) movePoint public void movePoint(int index, double x, double y, IlvTransformer t) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Specified by: movePoint in interface IlvPolyPointsInterface Overrides: movePoint in class IlvPolylineLinkImage Parameters: index - The index of the point to be moved. x - The new x coordinate (in manager coordinates). y - The new y coordinate (in manager coordinates). t - The transformer through which the object is drawn. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.movePoint(int, double, double, ilog.views.IlvTransformer) setIntermediateLinkPoints public void setIntermediateLinkPoints(IlvPoint[] points, int index, int length) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: setIntermediateLinkPoints in class IlvPolylineLinkImage Parameters: points - An array of points. index - The index of the point that will be the first intermediate point. length - The number of intermediate points taken in the points array. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.setIntermediateLinkPoints(ilog.views.IlvPoint[], int, int) pointsInBBox public boolean pointsInBBox() This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Specified by: pointsInBBox in interface IlvPolyPointsInterface Overrides: pointsInBBox in class IlvLinkImage See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.pointsInBBox() getConnectionReferencePoint public IlvPoint getConnectionReferencePoint(boolean origin, IlvTransformer t) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: getConnectionReferencePoint in class IlvLinkImage Parameters: origin - If true, the connection point of the origin node is searched for. If origin is false, then the connection point of the destination node is searched for. t - The transformer used to draw the link. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.getConnectionReferencePoint(boolean, ilog.views.IlvTransformer) getConnectionPoints public void getConnectionPoints(IlvPoint src, IlvPoint dst, IlvTransformer t) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: getConnectionPoints in class IlvLinkImage Parameters: src - A point for storing the origin. dst - A point for storing the destination. t - The transformer used to draw the link. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.getConnectionPoints(ilog.views.IlvPoint, ilog.views.IlvPoint, ilog.views.IlvTransformer) isOriented public boolean isOriented() This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: isOriented in class IlvLinkImage See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.isOriented() setOriented public void setOriented(boolean oriented) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: setOriented in class IlvLinkImage See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.setOriented(boolean) setForeground public void setForeground(Color c) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: setForeground in class IlvLinkImage Parameters: c - The new color. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.setForeground(java.awt.Color) getForeground public Color getForeground() This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: getForeground in class IlvLinkImage See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.getForeground() getLineWidth public double getLineWidth() Returns the line width of the object. If the link bundle is in collapsed state, this method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage), if any, or to the method of the superclass otherwise. If the link bundle is in expanded state, if computes the sum of the line widths of the individual links (see getSublinks()) adding the offsets (see getOffset()). Overrides: getLineWidth in class IlvLinkImage See Also: getOverviewLink(), getSublinks() getLineWidth public double getLineWidth(IlvTransformer t) Returns the line width that is actually displayed when the link bundle is drawn with the specified transformer. If the link bundle is in collapsed state, this method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage), if any, or to the method of the superclass otherwise. If the link bundle is in expanded state, if computes the sum of the line widths of the individual links (see getSublinks()) adding the offsets (see getOffset()). Overrides: getLineWidth in class IlvLinkImage Parameters: t - The transformer used to draw the link bundle. See Also: getOverviewLink(), getSublinks() getLineWidth public double getLineWidth(IlvTransformer t, boolean includingFrameMargin) Returns the line width that is actually displayed when the link bundle is drawn with the specified transformer. If the argument includingFrameMargin is true, the margin of the bundle frame (if any) is included. If the link bundle is in collapsed state, this method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage), if any, or to the method of the superclass otherwise. If the link bundle is in expanded state, if computes the sum of the line widths of the individual links (see getSublinks()) adding the offsets (see getOffset()). Parameters: t - The transformer used to draw the link bundle. includingFrameMargin - If true, the returned width includes the margin of the bundle frame (if any). See Also: getOverviewLink(), getSublinks() setLineWidth public void setLineWidth(double lineWidth) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: setLineWidth in class IlvLinkImage Parameters: lineWidth - The new line width. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.setLineWidth(double) getOverviewLineWidth public double getOverviewLineWidth() Returns the line width of the bundle when it is in collapsed state. Since: JViews 8.8 See Also: getLineWidth() getEndCap public int getEndCap() This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: getEndCap in class IlvLinkImage See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.getEndCap() setEndCap public void setEndCap(int endCap) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: setEndCap in class IlvLinkImage Parameters: endCap - The new decoration style. The values are defined in the class IlvStroke. The default value is CAP_SQUARE. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.setEndCap(int) getLineJoin public int getLineJoin() This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: getLineJoin in class IlvLinkImage See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.getLineJoin() setLineJoin public void setLineJoin(int lineJoin) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: setLineJoin in class IlvLinkImage Parameters: lineJoin - The new decoration style. The values are defined in the class IlvStroke. The default value is JOIN_MITER. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.setLineJoin(int) getMaximumLineWidth public double getMaximumLineWidth() This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: getMaximumLineWidth in class IlvLinkImage See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.getMaximumLineWidth() setMaximumLineWidth public void setMaximumLineWidth(double maximumLineWidth) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: setMaximumLineWidth in class IlvLinkImage Parameters: maximumLineWidth - The maximum line width, or 0 to indicate no limit. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.setMaximumLineWidth(double) getLineStyle public float[] getLineStyle() This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: getLineStyle in class IlvLinkImage See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.getLineStyle() setLineStyle public void setLineStyle(float[] lineStyle) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: setLineStyle in class IlvLinkImage Parameters: lineStyle - The new line style. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.setLineStyle(float[]) getLinkPoints public IlvPoint[] getLinkPoints(IlvTransformer t) This method delegates to the link supplied with the method setOverviewLink(ilog.views.IlvLinkImage). If no overview link is specified, the method of the superclass is called. Overrides: getLinkPoints in class IlvPolylineLinkImage Parameters: t - The transformer through which the object is drawn. See Also: setOverviewLink(ilog.views.IlvLinkImage), getOverviewLink(), IlvLinkImage.getLinkPoints(ilog.views.IlvTransformer) applyToObject public void applyToObject(IlvGraphic obj, IlvApplyObject f, Object arg, boolean redraw) Applies a method to an object of this bag, that is to a sublink of this link bundle. Specified by: applyToObject in interface IlvGraphicBag Parameters: obj - The graphic object. f - The method to apply. arg - The arguments passed to f. redraw - If true, the object is redrawn. reshapeObject public void reshapeObject(IlvGraphic obj, IlvRect newrect, boolean redraw) Changes the size of a graphic object located in the link bundle. Specified by: reshapeObject in interface IlvGraphicBag Parameters: obj - The graphic object. newrect - The new desired bounding rectangle. redraw - If true, the object is redrawn. moveObject public void moveObject(IlvGraphic obj, double x, double y, boolean redraw) Changes the location of a graphic object. Specified by: moveObject in interface IlvGraphicBag Parameters: obj - The graphic object. x - The new desired x. y - The new desired y. redraw - If true, the object is redrawn. reDrawRegion public void reDrawRegion(IlvRegion region) Redraws a region of the link bundle. Specified by: reDrawRegion in interface IlvGraphicBag Parameters: region - The region to redraw in the coordinate system of the link bundle. reDrawObj public void reDrawObj(IlvGraphic obj) Redraws a graphic object contained in the set. Specified by: reDrawObj in interface IlvGraphicBag Parameters: obj - The graphic 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 IlvPolylineLinkImage Parameters: stream - The output stream. Throws: IOException - thrown when an exception occurs during the write operation for this object. makeSelection public IlvSelection makeSelection() Creates a selection object for this object. The default implementation creates an instance of IlvLinkBundleSelection. Overrides: makeSelection in class IlvLinkImage See Also: IlvLinkImageSelection zoomable public boolean zoomable() Returns false, since this graphic object is not zoomable. Overrides: zoomable in class IlvLinkImage See Also: IlvGraphic.zoomable(), IlvLinkConnector.zoomable() ensureClippingLinkConnector public void ensureClippingLinkConnector(boolean traverse, boolean redraw) Ensures that a clip link connector is installed at the link bundle and all sublinks. Parameters: traverse - Whether this method is recursively called for all sublinks that are link bundles. redraw - Whether the object must be redrawn. Since: JViews 8.8

Class IlvLinkBundle

Constructor Summary

Method Summary

Methods inherited from class ilog.views.graphic.IlvPolylineLinkImage

Methods inherited from class ilog.views.IlvLinkImage

Methods inherited from class ilog.views.IlvGraphic

Methods inherited from class java.lang.Object

Methods inherited from interface ilog.views.IlvGraphicBag

Constructor Detail

IlvLinkBundle

IlvLinkBundle

IlvLinkBundle

IlvLinkBundle

IlvLinkBundle

IlvLinkBundle

Method Detail

copy

getLinkBundles

getLinkBundlesCount

setGraphicBag

getTreeLock

getRootLinkBundle

getRootManager

setOverviewLink

getOverviewLink

addObject

removeObject

addSublink

addSublink

removeSublink

getSublink

getSublink

getCollapseExpandObject

getSelectableObject

getAllSelectableObjects

getSelection

getSelection

getObject

setObjectName

getObjectName

getPopupMenu

setToolTipText

getToolTipText

getToolTipText

setSelected

setSelected

setSelected

selectionChanged

selectAll

selectAll

selectAll

deSelectAll

deSelectAll

deSelectAll

getSelectionFactory

setSelectionEventSource

setSelectionAdjusting

isSelectionAdjusting

addLinkBundleSelectionChangedListener

removeLinkBundleSelectionChangedListener

getSelectedSublinks

getSelectedObjects

getSelectedSublinks

getSelectedSublinksCount

getSelectedObjectsCount

getSelectedSublinksCount

isSelected

isSelected

getSelection

setOffset

getOffset

setSingleConnectionPoint

isSingleConnectionPoint

setCollapsed

isCollapsed

isCollapsible

draw

boundingBox

isLayoutValid

invalidateLayout