Class Spacer

Object
   |
   +--Widget
         |
         +--Spacer

class Spacer

extends Widget

Raises:

beforedragstart

whenever a draggable widget is about to be dragged. Listeners receive an instance of DragEvent. Setting the continueDrag property of the DragEvent to false will prevent the drag operation from starting. (See DragEvent.continueDrag.)

beforedragmove

whenever the user moves the mouse during a drag operation, but before the dragged-widget's position is updated. Listeners are passed an instance of DragEvent. Once this event has been raised, the dragged-widget's position is updated to match the widget property of the DragEvent that was passed to the beforedragmove listeners. Therefor, modifying the widget property will affect the new position of the dragged widget. Listeners can thus constrain the region inside which the dragged-widget can be dragged. (See DragEvent.widget.)

afterdragmove

whenever the user moves the mouse during a drag operation, but after the dragged-widget's position has been updated. Listeners are passed the same instance of DragEvent that was passed to the matching beforedragmove event. Modifying the members of the DragEvent during an afterdragmove event has no effect.

afterdragstop

whenever a drag operation terminates normally on a draggable widget (ie. the user 'dropped' the widget). Listeners are passed an instance of DragEvent. The mouse property of the DragEvent reflects the co-ordinates of the mouse at the time of the drop, and the widget property represents the co-ordinates of the dragged-widget at the time of the drop. (See DragEvent.mouse and DragEvent.widget.)

afterdragcancel

whenever a drag operation is cancelled by the user (probably by pressing the escape key). Listeners are passed an instance of DragEvent. In the case of an afterdragcancel event, the mouse property of the DragEvent reflects the co-ordinates that the mouse would have been at had it been a mouse event that caused the drag operation to be cancelled. Also, the widget property is the co-ordinates where the dragged-widget has been placed because of the cancellation. Together, this means that the same listener could be attached to both afterdragstop and afterdragcancel because the members of the DragEvent are consistent between the two events. (See DragEvent.mouse and DragEvent.widget.)

Constructor Detail

Spacer

function Spacer(size, <Widget> parent)

Parameters:
parent - a Widget that contains this widget. Use of this parameter is deprecated and it will hopefully be removed in a codebase cleanup.
html - an HTML node to use as this widget's representation.