quicktime.app.actions
Class Dragger

java.lang.Object
  |
  +--quicktime.app.actions.MouseResponder
        |
        +--quicktime.app.actions.Dragger

Deprecated. since QTJava 4.0

public class Dragger

extends MouseResponder

The Dragger is a particular type of MouseResponder that performs the action of moving the Dragger's target (a Transformable object) according to the drag movements of the mouse.

Dragger's can be constrained to keep their target object completely within their enclosing space, or allow the target to be dragged out of that space to a default minimum view of 1 row or column of pixels of the target.

When a constraining condition is reached the Dragger will invoke the trigger method of an attached Actionable object.

NOTE: This class is no longer used and has been replaced by the new event model When converting your code, use a DragAction object in quicktime.app.event

Example:

Dragger dragger = new Dragger (MouseResponder.kAnyModifiersMask);
 GroupController controller1 = new GroupController (dragger, true);
 drawer.addController (controller1);

This code is replaced with:

QTMouseTargetController qtmc = new QTMouseTargetController(true);
 qtmc.addQTMouseListener(new DragAction (new TranslateMatrix()));
 drawer.addController (qtmc);

See Also:

QTMouseController

Field Summary

protected Actionable	actor Deprecated. since QTJava 6.1
static int	kConstrainAll Deprecated. Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1
static int	kConstrainBottom Deprecated. Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1
static int	kConstrainHorizontal Deprecated. Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1
static int	kConstrainLeft Deprecated. Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1
static int	kConstrainNone Deprecated. Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1
static int	kConstrainRight Deprecated. Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1
static int	kConstrainTop Deprecated. Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1
static int	kConstrainVertical Deprecated. Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1
protected QTDrawable	space Deprecated. This is the QTDrawable space within which the Dragger's target is enclosed and contained* @deprecated since QTJava 6.1
protected Transformable	target Deprecated. This is the Transformable target of the Dragger action * @deprecated since QTJava 6.1
protected int	xBufferIfUnConstrained Deprecated. The number of pixels on the horizontal axis that an object can be dragged beyond the bounds if the dragging action is unconstrained.
protected int	yBufferIfUnConstrained Deprecated. The number of pixels on the vertical axis that an object can be dragged beyond the bounds if the dragging action is unconstrained.

Fields inherited from class quicktime.app.actions.MouseResponder

kAnyModifiers, kAnyModifiersMask, kAnyMouseEvent, kAnyOneOfModifiers, kClickEvents, kDragEvents, kEnterEvents, kExitEvents, kModifiersDisregarded, kModifiersExactMatch, kMouseEvents, kMouseMotionEvents, kMouseOrMouseMotionEvents, kMoveEvents, kNoModifiers, kNoModifiersMask, kPressReleaseEvents, kQTMouseMotionEvents, kRolloverEvents, kSpecifiedModifiersOrNone, kTargetMoveEvents, modifierKeyMask, modifierTestConditions

Constructor Summary

Dragger(int modifierKeyMask)
Deprecated. since QTJava 6.1

Dragger(int modifierKeyMask, int modifierTestConditions)
Deprecated. since QTJava 6.1

Dragger(int modifierKeyMask, int modifierTestConditions, int additionalEvents)
Deprecated. since QTJava 6.1

Method Summary

Actionable	getActionable() Deprecated. since QTJava 6.1
int	getConstrained() Deprecated. Returns the current constraint setting * @deprecated since QTJava 6.1
boolean	isAppropriate(java.lang.Object object) Deprecated. since QTJava 6.1
void	mouseDragged(java.awt.event.MouseEvent event) Deprecated. since QTJava 6.1
void	mousePressed(java.awt.event.MouseEvent event) Deprecated. since QTJava 6.1
protected void	removeTarget() Deprecated. since QTJava 6.1
void	setActionable(Actionable actor) Deprecated. since QTJava 6.1
void	setConstrained(int flag) Deprecated. since QTJava 6.1
protected void	setTarget(java.lang.Object t) Deprecated. since QTJava 6.1
protected void	setTargetSpace(java.lang.Object o) Deprecated. since QTJava 6.1

Methods inherited from class quicktime.app.actions.MouseResponder

activationEventType, deactivate, getMouseController, isActive, isInterested, isInterested, mouseClicked, mouseEntered, mouseEnteredTarget, mouseExited, mouseExitedTarget, mouseMoved, mouseReleased

Methods inherited from class java.lang.Object

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

Field Detail

kConstrainNone

public static final int kConstrainNone

Deprecated.

Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1

See Also:

Constant Field Values

kConstrainLeft

public static final int kConstrainLeft

Deprecated.

Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1

See Also:

Constant Field Values

kConstrainRight

public static final int kConstrainRight

Deprecated.

Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1

See Also:

Constant Field Values

kConstrainTop

public static final int kConstrainTop

Deprecated.

Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1

See Also:

Constant Field Values

kConstrainBottom

public static final int kConstrainBottom

Deprecated.

Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1

See Also:

Constant Field Values

kConstrainHorizontal

public static final int kConstrainHorizontal

Deprecated.

Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1

See Also:

Constant Field Values

kConstrainVertical

public static final int kConstrainVertical

Deprecated.

Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1

See Also:

Constant Field Values

kConstrainAll

public static final int kConstrainAll

Deprecated.

Use these as constraint flags to restrict dragging operations* @deprecated since QTJava 6.1

See Also:

Constant Field Values

actor

protected Actionable actor

Deprecated. since QTJava 6.1

The actor that will be invoked (if set) when the dragger reaches a constraining condition

target

protected Transformable target

Deprecated.

This is the Transformable target of the Dragger action * @deprecated since QTJava 6.1

space

protected QTDrawable space

Deprecated.

This is the QTDrawable space within which the Dragger's target is enclosed and contained* @deprecated since QTJava 6.1

xBufferIfUnConstrained

protected int xBufferIfUnConstrained

Deprecated.

The number of pixels on the horizontal axis that an object can be dragged beyond the bounds if the dragging action is unconstrained. The default is one * @deprecated since QTJava 6.1

yBufferIfUnConstrained

protected int yBufferIfUnConstrained

Deprecated.

The number of pixels on the vertical axis that an object can be dragged beyond the bounds if the dragging action is unconstrained. The default is one * @deprecated since QTJava 6.1

Constructor Detail

Dragger

public Dragger(int modifierKeyMask)

Deprecated. since QTJava 6.1

Create a Dragger object

Parameters:

modifierKeyMask - - if specified will determine which modifier keys must be depressed for the action to be invoked. The modifierTestConditions is set in this case to MouseResonder.kModifiersExactMatch

Dragger

public Dragger(int modifierKeyMask,
               int modifierTestConditions)

Deprecated. since QTJava 6.1

Create a Dragger object with specified modifier keys and test conditions under which those modifier keys are matched.

Parameters:

modifierKeyMask - - if specified will determine which modifier keys must be depressed for the action to be invoked.

modifierTestConditions - the test conditions under which the modifier mask is tested

Dragger

public Dragger(int modifierKeyMask,
               int modifierTestConditions,
               int additionalEvents)

Deprecated. since QTJava 6.1

Set some parameters that will create DragActions.

Parameters:

modifierKeyMask - - if specified will determine which modifier keys must be depressed for the action to be invoked.

modifierTestConditions - the test conditions under which the modifier mask is tested

additionalEvents - additional mouse events the responder will respond to

Method Detail

setTargetSpace

protected void setTargetSpace(java.lang.Object o)

Deprecated. since QTJava 6.1

This method sets the containing Space of a target of a MouseResponder. For a Dragger this space must be a QTDrawable.

Specified by:

setTargetSpace in class MouseResponder

Parameters:

o - the containing space of the potential targets of the Dragger.

setActionable

public void setActionable(Actionable actor)

Deprecated. since QTJava 6.1

This method sets the actionable object of the action.

getActionable

public Actionable getActionable()

Deprecated. since QTJava 6.1

This method retreives the current actor that is attached to the action

isAppropriate

public boolean isAppropriate(java.lang.Object object)

Deprecated. since QTJava 6.1

The Dragger knows how to drag objects of type Transformable around. Thus this method returns true if the incoming object implements the Transformable interface.

Specified by:

isAppropriate in class MouseResponder

Parameters:

object - the object to test

Returns:

a boolean

setTarget

protected void setTarget(java.lang.Object t)

Deprecated. since QTJava 6.1

Sets the target of the Dragger. Generally this will be some kind of Transformable object that the user has clicked on and the MouseController has extracted. This becomes the active Target of the Dragger for the duration of the mouseDrag event.

Specified by:

setTarget in class MouseResponder

Parameters:

t - the Transformable target

removeTarget

protected void removeTarget()

Deprecated. since QTJava 6.1

When the MouseController detects that the drag operation is completed it notifies the Dragger to remove its target as the user no longer is dragging.

Specified by:

removeTarget in class MouseResponder

setConstrained

public void setConstrained(int flag)

Deprecated. since QTJava 6.1

Using the constrain constants dragging can be constrained in any direction.

Parameters:

flag - constraint flag

getConstrained

public int getConstrained()

Deprecated.

Returns the current constraint setting * @deprecated since QTJava 6.1

mousePressed

public void mousePressed(java.awt.event.MouseEvent event)

Deprecated. since QTJava 6.1

This method is called by the MouseController when the mouse is first pressed down on a valid Transformable object within the space it is controlling. For efficiency it is assumed that the overall characteristics of the enclosing space will not be changing during the duration of the drag event - ie. the Matrix of the enclosing space is not changing during a mouse drag. However the Target's matrix can and will change as a result of the drag operation.

Overrides:

mousePressed in class MouseResponder

Parameters:

event - the mouse down event that may begin the drag action

mouseDragged

public void mouseDragged(java.awt.event.MouseEvent event)

Deprecated. since QTJava 6.1

This method will allow the user to drag the transformable object around. This method also does constraints testing based on the current state of the constraints.

Overrides:

mouseDragged in class MouseResponder

Parameters:

event - the mouse drag event that triggered the drag action.