ilog.views

Class IlvReshapeSelection

java.lang.Object

ilog.views.IlvObjectInteractor

ilog.views.IlvReshapeSelection

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

IlvLaneRenderer.ResizeLaneSelection, IlvTextEditor

public class IlvReshapeSelection
extends IlvObjectInteractor

An object interactor that reshapes an instance of IlvDrawSelection.

Since JViews 8.0, this interactor can reshape graphic object that implement IlvDefinitionRectInterface.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
IlvReshapeSelection() Creates an IlvReshapeSelection.

Method Summary

Modifier and Type	Method and Description
protected void	drawGhost(IlvDrawSelection obj, Graphics g, IlvObjectInteractorContext context) Draws a rectangle while reshaping.
protected void	drawGhost(IlvObjectInteractorContext context) Deprecated. Beginning with Perforce JViews 5.0, use the method drawGhost(IlvDrawSelection, Graphics, IlvObjectInteractorContext) instead.
protected IlvRect	getBoundingBox(IlvGraphic obj, IlvTransformer t) Returns the rectangle that defines the bounds of the graphic object.
Cursor	getCursor(int direction) Returns the cursor used for editing.
static int	getPreserveAspectModifier() Returns the modifier for preserving aspect ratio during reshape.
static int	getPreserveAspectModifierEx() Returns the extended modifier for preserving aspect ratio during reshape.
protected boolean	handleButtonDown(IlvDrawSelection sel, MouseEvent event, IlvObjectInteractorContext context) Processes the button down events.
protected boolean	handleButtonDragged(IlvDrawSelection sel, MouseEvent event, IlvObjectInteractorContext context) Processes the button dragged events.
protected boolean	handleButtonUp(IlvDrawSelection sel, MouseEvent event, IlvObjectInteractorContext context) Processes the button up events.
void	handleExpose(IlvGraphic obj, Graphics g, IlvObjectInteractorContext context) Called when the view that draws the polypoints object is drawn.
boolean	isOpaqueMode() Returns an indication of whether the interactor is in Opaque mode or not.
static boolean	isPredictionCursorMode() Returns whether the interactor uses the prediction cursor mode.
protected boolean	isPreserveAspectModifierDown(InputEvent event) Tests if the mouse event modifier for preserving aspect ratio during reshape is currently down.
void	onEnter(IlvGraphic sel, IlvObjectInteractorContext context) Called when the selection is entered.
void	onExit(IlvGraphic sel, IlvObjectInteractorContext context) Called when the selection is exited.
boolean	processEvent(IlvGraphic obj, AWTEvent event, IlvObjectInteractorContext context) Processes the events.
protected void	reshapeObject(IlvGraphic graphic, IlvRect rect) Called to let the interactor reshape an object.
void	setOpaqueMode(boolean set) Sets the interactor in Opaque mode.
static void	setPredictionCursorMode(boolean flag) Sets the prediction cursor mode.
static void	setPreserveAspectModifier(int modifier) Sets the modifier for preserving aspect ratio during reshape.

Methods inherited from class ilog.views.IlvObjectInteractor

Get, Put

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvReshapeSelection

public IlvReshapeSelection()

Creates an IlvReshapeSelection.

Method Detail

getCursor

public Cursor getCursor(int direction)

Returns the cursor used for editing.

Parameters:

direction - The reshaping direction.

reshapeObject

protected void reshapeObject(IlvGraphic graphic,
                             IlvRect rect)

Called to let the interactor reshape an object.

Parameters:

graphic - The IlvGraphic to reshape.

rect - The new rectangle defining the object.

handleButtonDown

protected boolean handleButtonDown(IlvDrawSelection sel,
                                   MouseEvent event,
                                   IlvObjectInteractorContext context)

Processes the button down events.

Returns:

true if the event has been processed, false otherwise.

getBoundingBox

protected IlvRect getBoundingBox(IlvGraphic obj,
                                 IlvTransformer t)

Returns the rectangle that defines the bounds of the graphic object. The default implementation uses the method IlvGraphic.boundingBox(IlvTransformer).

Since:

JViews 5.0

setOpaqueMode

public void setOpaqueMode(boolean set)

Sets the interactor in Opaque mode. The interactor has two modes: the Opaque mode and the Ghost mode. In Opaque mode, the size of the object that the user resizes is changed for each drag event. In Ghost mode, the size of the object is changed only when the user releases the mouse button.

The default mode is the Ghost mode.

Since:

JViews 5.0

See Also:

isOpaqueMode(), IlvSelectInteractor.setOpaqueResize(boolean)

isOpaqueMode

public boolean isOpaqueMode()

Returns an indication of whether the interactor is in Opaque mode or not.

Since:

JViews 5.0

See Also:

setOpaqueMode(boolean), IlvSelectInteractor.setOpaqueResize(boolean)

handleButtonDragged

protected boolean handleButtonDragged(IlvDrawSelection sel,
                                      MouseEvent event,
                                      IlvObjectInteractorContext context)

Processes the button dragged events.

Returns:

true if the event has been processed, false otherwise.

handleButtonUp

protected boolean handleButtonUp(IlvDrawSelection sel,
                                 MouseEvent event,
                                 IlvObjectInteractorContext context)

Processes the button up events.

processEvent

public boolean processEvent(IlvGraphic obj,
                            AWTEvent event,
                            IlvObjectInteractorContext context)

Processes the events.

Specified by:

processEvent in class IlvObjectInteractor

Parameters:

obj - The graphic object.

event - The event to process.

context - The context in which the event occurred.

Returns:

true if the event was handled by this processEvent invocation, false otherwise.

handleExpose

public void handleExpose(IlvGraphic obj,
                         Graphics g,
                         IlvObjectInteractorContext context)

Called when the view that draws the polypoints object is drawn. It actually calls the method drawGhost(IlvDrawSelection, Graphics, IlvObjectInteractorContext) if the interactor is in ghost mode, and does nothing otherwise.

Overrides:

handleExpose in class IlvObjectInteractor

Parameters:

obj - The graphic object to which the object interactor is associated.

g - The Graphics where obj is drawn.

context - The interactor context.

Since:

JViews 5.0

See Also:

drawGhost(IlvDrawSelection, Graphics, IlvObjectInteractorContext)

drawGhost

@Deprecated
protected void drawGhost(IlvObjectInteractorContext context)

Deprecated. Beginning with Perforce JViews 5.0, use the method drawGhost(IlvDrawSelection, Graphics, IlvObjectInteractorContext) instead.

Draws a rectangle while reshaping.

drawGhost

protected void drawGhost(IlvDrawSelection obj,
                         Graphics g,
                         IlvObjectInteractorContext context)

Draws a rectangle while reshaping. This method does nothing if the interactor is in opaque mode.

Parameters:

obj - The graphic object to which the object interactor is associated.

g - The Graphics where obj is drawn.

context - The interactor context.

Since:

JViews 5.0

See Also:

isOpaqueMode()

onEnter

public void onEnter(IlvGraphic sel,
                    IlvObjectInteractorContext context)

Called when the selection is entered. This is used if the object interactor is associated with a selection object (see IlvSelection.onEnter(ilog.views.IlvObjectInteractorContext)). 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.

Overrides:

onEnter in class IlvObjectInteractor

Parameters:

sel - The selection object.

context - The context for the object interactor.

Since:

JViews 8.0

See Also:

IlvSelection.onEnter(ilog.views.IlvObjectInteractorContext)

onExit

public void onExit(IlvGraphic sel,
                   IlvObjectInteractorContext context)

Called when the selection is exited. This is used if the object interactor is associated with a selection object (see IlvSelection.onExit(ilog.views.IlvObjectInteractorContext)). The selection is exited if the select interactor moves the mouse to a blank area of the view, or to another selection so that mouse events are no longer dispatched to the object interactor of this selection.

Overrides:

onExit in class IlvObjectInteractor

Parameters:

sel - The selection object.

context - The context for the object interactor.

Since:

JViews 8.0

See Also:

IlvSelection.onExit(ilog.views.IlvObjectInteractorContext)

setPreserveAspectModifier

public static void setPreserveAspectModifier(int modifier)

Sets the modifier for preserving aspect ratio during reshape. If the modifier key is pressed when clicking on a handle to reshape the object, the aspect ratio of the object is preserved. The default modifier is InputEvent.CTRL_MASK. This method can be used to set normal modifiers and extended modifiers (see java.awt.event.InputEvent.getModifiersEx() since JDK 1.4).

Note: In the mask, InputEvent.ALT_DOWN_MASK should be used instead of InputEvent.ALT_MASK, and InputEvent.META_DOWN_MASK should be used instead of InputEvent.META_MASK, because the values of ALT_MASK/BUTTON2_MASK and META_MASK/BUTTON3_MASK overlap.

Since:

JViews 8.5

See Also:

getPreserveAspectModifier(), getPreserveAspectModifierEx(), isPreserveAspectModifierDown(java.awt.event.InputEvent)

getPreserveAspectModifier

public static int getPreserveAspectModifier()

Returns the modifier for preserving aspect ratio during reshape. The default modifier is InputEvent.CTRL_MASK.

Since:

JViews 8.5

See Also:

setPreserveAspectModifier(int), isPreserveAspectModifierDown(java.awt.event.InputEvent)

getPreserveAspectModifierEx

public static int getPreserveAspectModifierEx()

Returns the extended modifier for preserving aspect ratio during reshape. The default modifier is InputEvent.CTRL_DOWN_MASK. See java.awt.event.InputEvent.getModifiersEx() since JDK 1.4 for information about extended modifiers. This mask is computed from setPreserveAspectModifier(int).

Since:

JViews 8.5

See Also:

setPreserveAspectModifier(int), isPreserveAspectModifierDown(java.awt.event.InputEvent)

isPreserveAspectModifierDown

protected boolean isPreserveAspectModifierDown(InputEvent event)

Tests if the mouse event modifier for preserving aspect ratio during reshape is currently down. The method compares the current modifiers of the event with the modifier returned by the method getPreserveAspectModifierEx(). If the modifier key is pressed when clicking on a handle to reshape the object, the aspect ratio of the object is preserved. The default modifier is InputEvent.CTRL_DOWN_MASK.

Since:

JViews 8.5

See Also:

setPreserveAspectModifier(int)

setPredictionCursorMode

public static void setPredictionCursorMode(boolean flag)

Sets the prediction cursor mode. In prediction cursor mode, the interactor tries to predict what operation happens next and displays the corresponding cursor. For instance, the interactor shows the top-left arrow cursor in prediction mode when the mouse is over the top-left corner handle even though the mouse is not dragged, because the operation could be a dragging to resize with the top-left corner. In non-prediction mode, the interactor shows the crosshair cursor when the mouse is over any handle, to indicate that the handle is active, but will only switch to the arrow cursors when the dragging really happens. The prediction mode is disabled by default.

Since:

JViews 8.5

See Also:

isPredictionCursorMode()

isPredictionCursorMode

public static boolean isPredictionCursorMode()

Returns whether the interactor uses the prediction cursor mode.

Since:

JViews 8.5

See Also:

setPredictionCursorMode(boolean)