ilog.views

Class IlvSelection

java.lang.Object

ilog.views.IlvGraphic

ilog.views.IlvSelection

All Implemented Interfaces:

IlvPersistentObject, IlvBlinkingObject, IlvBaseTextDirectionInterface, Transferable, Serializable

Direct Known Subclasses:

IlvHandlesSelection, IlvHyperEdgePinConnectorSelection, IlvMapSelection

public abstract class IlvSelection
extends IlvGraphic

An abstract class that describes the selection on another object. When a graphic object is selected in the manager, a selection object sub class of this abstract class is associated with the graphic object. This selection object is drawn on the top of the selected object to show its selected state. You do not create selection objects by a new. The selection object is created when the object is selected by the manager. The graphic object creates is own selection object by calling the makeSelection method.

Version:

1.0 12/30/96

See Also:

IlvManager.setSelected(ilog.views.IlvGraphic, boolean, boolean), IlvGraphic.makeSelection(), Serialized Form

Constructor Summary

Constructors

Constructor and Description
IlvSelection(IlvGraphic obj) Creates a new selection object.

Method Summary

Modifier and Type	Method and Description
void	applyTransform(IlvTransformer t) Empty implementation of IlvGraphic.applyTransform.
IlvGraphic	copy() Empty implementation of IlvGraphic.copy.
String	getDefaultInteractor() Returns the default interactor class name.
IlvGraphic	getObject() Returns the corresponding selected object.
boolean	isOptimizedDrawingEnabled() This method allows or disables an optimization for drawing a selection object and its selected object.
boolean	isVisible() Returns true if the object is visible.
void	onEnter(IlvObjectInteractorContext context) Called when the selection is entered.
void	onExit(IlvObjectInteractorContext context) Called when the selection is exited.
static void	SetDefaultInteractor(String interactor) This method allows to change the default interactor of this class.

Methods inherited from class ilog.views.IlvGraphic

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

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvSelection

public IlvSelection(IlvGraphic obj)

Creates a new selection object.

Parameters:

obj - the selected object

Method Detail

copy

public IlvGraphic copy()

Empty implementation of IlvGraphic.copy.

Specified by:

copy in class IlvGraphic

Returns:

null

See Also:

IlvGraphic

getObject

public final IlvGraphic getObject()

Returns the corresponding selected object.

applyTransform

public void applyTransform(IlvTransformer t)

Empty implementation of IlvGraphic.applyTransform.

Specified by:

applyTransform in class IlvGraphic

Parameters:

t - The transformation to be applied.

See Also:

IlvGraphic

isOptimizedDrawingEnabled

public boolean isOptimizedDrawingEnabled()

This method allows or disables an optimization for drawing a selection object and its selected object. This method can return true if the selection object covers completely the selected objects. In other words if the bounding box of this selection object is the same or bigger than the bounding box of the corresponding selected object. Note that the default value is false.

Since:

JViews 5.0

isVisible

public boolean isVisible()

Returns true if the object is visible.

Overrides:

isVisible in class IlvGraphic

Returns:

true if this graphic object is visible.

See Also:

IlvGraphic.setVisible(boolean), IlvGraphic.setSelectable(boolean), IlvGraphic.setMovable(boolean), IlvGraphic.setEditable(boolean)

onEnter

public void onEnter(IlvObjectInteractorContext context)

Called when the selection is entered. The selection is entered if the select interactor moves the mouse over the selection so that mouse events are dispatched to the object interactor of this selection.

Subclasses can override this method to perform specific tasks when the selection is entered. The default implementation calls IlvObjectInteractor.onEnter(ilog.views.IlvGraphic, ilog.views.IlvObjectInteractorContext) on the associated object interactor.

Parameters:

context - The context for the object interactor.

Since:

JViews 8.0

onExit

public void onExit(IlvObjectInteractorContext context)

Called when the selection is exited. The selection is exited if the select interactor moves the mouse to a blanc area of the view, or to another selection so that mouse events are no longer dispatched to the object interactor of this selection.

Subclasses can override this method to perform specific tasks when the selection is entered. The default implementation calls IlvObjectInteractor.onExit(ilog.views.IlvGraphic, ilog.views.IlvObjectInteractorContext) on the associated object interactor.

Parameters:

context - The context for the object interactor.

Since:

JViews 8.0

getDefaultInteractor

public String getDefaultInteractor()

Returns the default interactor class name. If SetDefaultInteractor has not been called it will return IlvReshapeSelection.

The default interactor is used as object interactor (see IlvGraphic.getObjectInteractor()) if no other object interactor was set on the object and the select interactor calls IlvGraphic.getAndAssociateObjectInteractor() to associate an object interactor with the selection. The object interactor associated with a selection is reponsible for interactions on the selected object, for instance, reshaping the object.

Overrides:

getDefaultInteractor in class IlvGraphic

See Also:

IlvReshapeSelection, SetDefaultInteractor(java.lang.String)

SetDefaultInteractor

public static void SetDefaultInteractor(String interactor)

This method allows to change the default interactor of this class. It is useful to change the interactor used for editing objects. Setting it to null will recover the initial interactor. This method allows to change the default interactor this class and all subclasses that do not override getDefaultInteractor() without subclassing this class.

Parameters:

interactor - the new interactor

See Also:

getDefaultInteractor()