mxPanningHandler

Event handler that pans and creates popupmenus.  To use the left mousebutton for panning without interfering with cell moving and resizing, use <isUseLeftButton> and <isIgnoreCell>.  For grid size steps while panning, use useGrid.  This handler is built-into <mxGraph.panningHandler> and enabled using mxGraph.setPanning.

Summary
mxPanningHandlerEvent handler that pans and creates popupmenus.
Functions
mxPanningHandlerConstructs an event handler that creates a mxPopupMenu and pans the graph.
Events
mxEvent.PAN_STARTFires when the panning handler changes its <active> state to true.
mxEvent.PANFires while handle is processing events.
mxEvent.PAN_ENDFires when the panning handler changes its <active> state to false.
Variables
graphReference to the enclosing mxGraph.
triggerXX-coordinate of the mouse down event.
triggerYX-coordinate of the mouse down event.
usePopupTriggerSpecifies if the <isPopupTrigger> should also be used for panning.
useLeftButtonForPanningSpecifies if panning should be active for the left mouse button.
selectOnPopupSpecifies if cells should be selected if a popupmenu is displayed for them.
clearSelectionOnBackgroundSpecifies if cells should be deselected if a popupmenu is displayed for the diagram background.
ignoreCellSpecifies if panning should be active even if there is a cell under the mousepointer.
previewEnabledSpecifies if the panning should be previewed.
useGridSpecifies if the panning steps should be aligned to the grid size.
panningEnabledSpecifies if panning should be enabled.
Functions
isPanningEnabledReturns panningEnabled.
setPanningEnabledSets panningEnabled.
initInitializes the shapes required for this vertex handler.
isPanningTriggerReturns true if the given event is a panning trigger for the optional given cell.
mouseDownHandles the event by initiating the panning.
consumePanningTriggerConsumes the given mxMouseEvent if it was a panning trigger in mouseDown.
mouseMoveHandles the event by updating the panning on the graph.
mouseUpHandles the event by setting the translation on the view or showing the popupmenu.
scaleGraphHandles pinch events on touch devices.
getCellForPopupEventHook to return the cell for the mouse up popup trigger handling.
panGraphPans graph by the given amount.
destroyDestroys the handler and all its resources and DOM nodes.

Functions

mxPanningHandler

Constructs an event handler that creates a mxPopupMenu and pans the graph.

Events

mxEvent.PAN_START

Fires when the panning handler changes its <active> state to true.  The <code>event</code> property contains the corresponding mxMouseEvent.

mxEvent.PAN

Fires while handle is processing events.  The <code>event</code> property contains the corresponding mxMouseEvent.

mxEvent.PAN_END

Fires when the panning handler changes its <active> state to false.  The <code>event</code> property contains the corresponding mxMouseEvent.

Variables

graph

mxPanningHandler.prototype.graph

Reference to the enclosing mxGraph.

triggerX

mxPanningHandler.prototype.triggerX

X-coordinate of the mouse down event.

triggerY

mxPanningHandler.prototype.triggerY

X-coordinate of the mouse down event.

usePopupTrigger

mxPanningHandler.prototype.usePopupTrigger

Specifies if the <isPopupTrigger> should also be used for panning.  To avoid conflicts, the panning is only activated if the mouse was moved more than mxGraph.tolerance, otherwise, a single click is assumed and the popupmenu is displayed.  Default is true.

useLeftButtonForPanning

mxPanningHandler.prototype.useLeftButtonForPanning

Specifies if panning should be active for the left mouse button.  Setting this to true may conflict with mxRubberband.  Default is false.

selectOnPopup

mxPanningHandler.prototype.selectOnPopup

Specifies if cells should be selected if a popupmenu is displayed for them.  Default is true.

clearSelectionOnBackground

mxPanningHandler.prototype.clearSelectionOnBackground

Specifies if cells should be deselected if a popupmenu is displayed for the diagram background.  Default is true.

ignoreCell

mxPanningHandler.prototype.ignoreCell

Specifies if panning should be active even if there is a cell under the mousepointer.  Default is false.

previewEnabled

mxPanningHandler.prototype.previewEnabled

Specifies if the panning should be previewed.  Default is true.

useGrid

mxPanningHandler.prototype.useGrid

Specifies if the panning steps should be aligned to the grid size.  Default is false.

panningEnabled

mxPanningHandler.prototype.panningEnabled

Specifies if panning should be enabled.  Default is true.

Functions

isPanningEnabled

mxPanningHandler.prototype.isPanningEnabled = function()

Returns panningEnabled.

setPanningEnabled

mxPanningHandler.prototype.setPanningEnabled = function(value)

Sets panningEnabled.

init

mxPanningHandler.prototype.init = function()

Initializes the shapes required for this vertex handler.

isPanningTrigger

mxPanningHandler.prototype.isPanningTrigger = function(me)

Returns true if the given event is a panning trigger for the optional given cell.  This returns true if control-shift is pressed or if usePopupTrigger is true and the event is a popup trigger.

mouseDown

mxPanningHandler.prototype.mouseDown = function(sender,
me)

Handles the event by initiating the panning.  By consuming the event all subsequent events of the gesture are redirected to this handler.

consumePanningTrigger

mxPanningHandler.prototype.consumePanningTrigger = function(me)

Consumes the given mxMouseEvent if it was a panning trigger in mouseDown.  The default is to invoke mxMouseEvent.consume.  Note that this will block any further event processing.  If you haven’t disabled built-in context menus and require immediate selection of the cell on mouseDown in Safari and/or on the Mac, then use the following code:

mxPanningHandler.prototype.consumePanningTrigger = function(me)
{
  if (me.evt.preventDefault)
  {
    me.evt.preventDefault();
  }

  // Stops event processing in IE
  me.evt.returnValue = false;

  // Sets local consumed state
  if (!mxClient.IS_SF && !mxClient.IS_MAC)
  {
    me.consumed = true;
  }
};

mouseMove

mxPanningHandler.prototype.mouseMove = function(sender,
me)

Handles the event by updating the panning on the graph.

mouseUp

mxPanningHandler.prototype.mouseUp = function(sender,
me)

Handles the event by setting the translation on the view or showing the popupmenu.

scaleGraph

mxPanningHandler.prototype.scaleGraph = function(scale,
preview)

Handles pinch events on touch devices.

getCellForPopupEvent

mxPanningHandler.prototype.getCellForPopupEvent = function(me)

Hook to return the cell for the mouse up popup trigger handling.

panGraph

mxPanningHandler.prototype.panGraph = function(dx,
dy)

Pans graph by the given amount.

destroy

mxPanningHandler.prototype.destroy = function()

Destroys the handler and all its resources and DOM nodes.

Event handler that pans and creates popupmenus.
mxPanningHandler.prototype.graph
Reference to the enclosing mxGraph.
Extends mxEventSource to implement a graph component for the browser.
mxPanningHandler.prototype.triggerX
X-coordinate of the mouse down event.
mxPanningHandler.prototype.triggerY
X-coordinate of the mouse down event.
mxPanningHandler.prototype.usePopupTrigger
Specifies if the isPopupTrigger should also be used for panning.
mxPanningHandler.prototype.useLeftButtonForPanning
Specifies if panning should be active for the left mouse button.
mxPanningHandler.prototype.selectOnPopup
Specifies if cells should be selected if a popupmenu is displayed for them.
mxPanningHandler.prototype.clearSelectionOnBackground
Specifies if cells should be deselected if a popupmenu is displayed for the diagram background.
mxPanningHandler.prototype.ignoreCell
Specifies if panning should be active even if there is a cell under the mousepointer.
mxPanningHandler.prototype.previewEnabled
Specifies if the panning should be previewed.
mxPanningHandler.prototype.useGrid
Specifies if the panning steps should be aligned to the grid size.
mxPanningHandler.prototype.panningEnabled
Specifies if panning should be enabled.
mxPanningHandler.prototype.isPanningEnabled = function()
Returns panningEnabled.
mxPanningHandler.prototype.setPanningEnabled = function(value)
Sets panningEnabled.
mxPanningHandler.prototype.init = function()
Initializes the shapes required for this vertex handler.
mxPanningHandler.prototype.isPanningTrigger = function(me)
Returns true if the given event is a panning trigger for the optional given cell.
mxPanningHandler.prototype.mouseDown = function(sender,
me)
Handles the event by initiating the panning.
mxPanningHandler.prototype.consumePanningTrigger = function(me)
Consumes the given mxMouseEvent if it was a panning trigger in mouseDown.
Base class for all mouse events in mxGraph.
mxPanningHandler.prototype.mouseMove = function(sender,
me)
Handles the event by updating the panning on the graph.
mxPanningHandler.prototype.mouseUp = function(sender,
me)
Handles the event by setting the translation on the view or showing the popupmenu.
mxPanningHandler.prototype.scaleGraph = function(scale,
preview)
Handles pinch events on touch devices.
mxPanningHandler.prototype.getCellForPopupEvent = function(me)
Hook to return the cell for the mouse up popup trigger handling.
mxPanningHandler.prototype.panGraph = function(dx,
dy)
Pans graph by the given amount.
mxPanningHandler.prototype.destroy = function()
Destroys the handler and all its resources and DOM nodes.
mxGraph.prototype.setPanning = function(enabled)
Specifies if panning should be enabled.
mxGraph.prototype.tolerance
Tolerance for a move to be handled as a single click.
Event handler that selects rectangular regions.
mxMouseEvent.prototype.consume = function(preventDefault)
Sets consumed to true and invokes preventDefault on the native event if such a method is defined.
Close