Module org.jhotdraw8.draw

Package org.jhotdraw8.draw.handle

Class AbstractConnectorHandle

java.lang.Object

org.jhotdraw8.draw.handle.AbstractHandle

org.jhotdraw8.draw.handle.AbstractConnectorHandle

All Implemented Interfaces:

Handle

Direct Known Subclasses:

LabelConnectorHandle, LineConnectorHandle

public abstract class AbstractConnectorHandle
extends AbstractHandle

Handle for the start or end point of a connection figure.

Pressing the alt or the control key while dragging the handle prevents connecting the point.

Author:

Werner Randelshofer

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	AbstractConnectorHandle.ConnectorAndConnectedFigure	Record for a connector and its connected figure.

Field Summary

Fields

Modifier and Type	Field	Description
protected final @NonNull MapAccessor<Connector>	connectorKey
protected @Nullable javafx.geometry.Point2D	connectorLocation
protected javafx.geometry.Point2D	pickLocation
protected final NonNullMapAccessor<CssPoint2D>	pointKey
protected final @NonNull MapAccessor<Figure>	targetKey

Fields inherited from class org.jhotdraw8.draw.handle.AbstractHandle

owner

Constructor Summary

Constructors

Constructor	Description
AbstractConnectorHandle(@NonNull ConnectingFigure figure, NonNullMapAccessor<CssPoint2D> pointKey, @NonNull MapAccessor<Connector> connectorKey, @NonNull MapAccessor<Figure> targetKey)

Method Summary

Modifier and Type	Method	Description
boolean	contains(DrawingView dv, double x, double y, double tolerance)	Whether the user picked the handle.
protected @Nullable AbstractConnectorHandle.ConnectorAndConnectedFigure	find(@NonNull CssPoint2D pointInWorld, @NonNull ConnectingFigure o, @NonNull ConnectableFigure cff, @NonNull javafx.scene.input.MouseEvent mouseEvent, double tolerance)
javafx.scene.Cursor	getCursor()	The cursor that should be shown when the mouse hovers over a selectable handle.
javafx.geometry.Point2D	getLocationInView()
@NonNull ConnectingFigure	getOwner()	Returns the figure to which the handle is associated.
boolean	isEditable()	Returns true if this handle is editable.
boolean	isSelectable()	Whether the handle is selectable.
void	onMouseDragged(@NonNull javafx.scene.input.MouseEvent event, @NonNull DrawingView view)
void	onMousePressed(@NonNull javafx.scene.input.MouseEvent event, @NonNull DrawingView view)
void	onMouseReleased(@NonNull javafx.scene.input.MouseEvent event, @NonNull DrawingView view)
protected void	onPopupTriggered(javafx.scene.input.MouseEvent event, DrawingView view)	This method is called when the popup menu is triggered.
void	setEditable(boolean editable)

Methods inherited from class org.jhotdraw8.draw.handle.AbstractHandle

dispose, isCompatible

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jhotdraw8.draw.handle.Handle

getNode, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, updateNode

Field Details

connectorKey

protected final @NonNull MapAccessor<Connector> connectorKey

pointKey

protected final NonNullMapAccessor<CssPoint2D> pointKey

targetKey

protected final @NonNull MapAccessor<Figure> targetKey

connectorLocation

protected @Nullable javafx.geometry.Point2D connectorLocation

pickLocation

protected javafx.geometry.Point2D pickLocation

Constructor Details

AbstractConnectorHandle

public AbstractConnectorHandle(@NonNull ConnectingFigure figure,
 NonNullMapAccessor<CssPoint2D> pointKey,
 @NonNull MapAccessor<Connector> connectorKey,
 @NonNull MapAccessor<Figure> targetKey)

Method Details

contains

public boolean contains(DrawingView dv,
 double x,
 double y,
 double tolerance)

Description copied from interface: Handle

Whether the user picked the handle.

Parameters:

dv - the drawing view

x - the point

y - the point

tolerance - the tolerance (radius around the point)

Returns:

true if we picked the handle

getCursor

public javafx.scene.Cursor getCursor()

Description copied from interface: Handle

The cursor that should be shown when the mouse hovers over a selectable handle. Non-selectable handles should return null.

Returns:

the cursor

getLocationInView

public javafx.geometry.Point2D getLocationInView()

getOwner

public @NonNull ConnectingFigure getOwner()

Description copied from interface: Handle

Returns the figure to which the handle is associated.

Specified by:

getOwner in interface Handle

Overrides:

getOwner in class AbstractHandle

Returns:

a figure

isEditable

public boolean isEditable()

Description copied from interface: Handle

Returns true if this handle is editable.

Returns:

the default implementation returns true if the owner is editable

setEditable

public void setEditable(boolean editable)

isSelectable

public boolean isSelectable()

Description copied from interface: Handle

Whether the handle is selectable.

Returns:

true if selectable

onMouseDragged

public void onMouseDragged(@NonNull javafx.scene.input.MouseEvent event,
 @NonNull DrawingView view)

find

protected @Nullable AbstractConnectorHandle.ConnectorAndConnectedFigure find(@NonNull CssPoint2D pointInWorld,
 @NonNull ConnectingFigure o,
 @NonNull ConnectableFigure cff,
 @NonNull javafx.scene.input.MouseEvent mouseEvent,
 double tolerance)

onMousePressed

public void onMousePressed(@NonNull javafx.scene.input.MouseEvent event,
 @NonNull DrawingView view)

onPopupTriggered

protected void onPopupTriggered(javafx.scene.input.MouseEvent event,
 DrawingView view)

This method is called when the popup menu is triggered. This implementation does nothing.

Parameters:

event - the mouse event

view - the drawing view

onMouseReleased

public void onMouseReleased(@NonNull javafx.scene.input.MouseEvent event,
 @NonNull DrawingView view)