YUI recommends YUI3.

YUI 2 has been deprecated since 2011. This site acts as an archive for files and documentation.

This documentation is no longer maintained.

Yahoo! UI Library

Drag and Drop  2.6.0

Yahoo! UI Library > dragdrop > YAHOO.util.DDProxy
Search:
 
Filters

Class YAHOO.util.DDProxy - extends YAHOO.util.DD

Known Subclasses:
YAHOO.util.ColumnResizer YAHOO.util.ColumnDD
A DragDrop implementation that inserts an empty, bordered div into the document that follows the cursor during drag operations. At the time of the click, the frame div is resized to the dimensions of the linked html element, and moved to the exact location of the linked element. References to the "frame" element refer to the single proxy element that was created to be dragged in place of all DDProxy elements on the page.

Constructor

YAHOO.util.DDProxy ( id , sGroup , config )
Parameters:
id <String> the id of the linked html element
sGroup <String> the group of related DragDrop objects
config <object> an object containing configurable attributes Valid properties for DDProxy in addition to those in DragDrop: resizeFrame, centerFrame, dragElId

Properties

centerFrame - boolean

By default the frame is positioned exactly where the drag element is, so we use the cursor offset provided by YAHOO.util.DD. Another option that works only if you do not have constraints on the obj is to have the drag frame centered around the cursor. Set centerFrame to true for this effect.

resizeFrame - boolean

By default we resize the drag frame to be the same size as the element we want to drag (this is to get the frame effect). We can turn it off if we want a different behavior.

YAHOO.util.DDProxy.dragElId - static String

The default drag frame div id

Methods

_resizeProxy

private void _resizeProxy ( )
The proxy is automatically resized to the dimensions of the linked element when a drag is initiated, unless resizeFrame is set to false
Returns: void

createFrame

void createFrame ( )
Creates the proxy element if it does not yet exist
Returns: void

initFrame

void initFrame ( )
Initialization for the drag frame element. Must be called in the constructor of all subclasses
Returns: void

showFrame

private void showFrame ( iPageX , iPageY )
Resizes the drag frame to the dimensions of the clicked object, positions it over the object, and finally displays it
Parameters:
iPageX <int> X click position
iPageY <int> Y click position
Returns: void

Events

b4DragDropEvent

b4DragDropEvent ( )
Fires before the dragDropEvent

b4DragEvent

b4DragEvent ( )
Fires before the dragEvent.

b4DragOutEvent

b4DragOutEvent ( )
Fires before the dragOutEvent

b4DragOverEvent

b4DragOverEvent ( )
Fires before the dragOverEvent.

b4EndDragEvent

b4EndDragEvent ( )
Fires before the endDragEvent. Returning false will cancel.

b4MouseDownEvent

b4MouseDownEvent ( )
Provides access to the mousedown event, before the mouseDownEvent gets fired. Returning false will cancel the drag.

b4StartDragEvent

b4StartDragEvent ( )
Fires before the startDragEvent, returning false will cancel the startDrag Event.

dragDropEvent

dragDropEvent ( )
Fires when the dragged objects is dropped on another.

dragEnterEvent

dragEnterEvent ( )
Occurs when the dragged object first interacts with another targettable drag and drop object.

dragEvent

dragEvent ( )
Occurs every mousemove event while dragging.

dragOutEvent

dragOutEvent ( )
Fires when a dragged object is no longer over an object that had the onDragEnter fire.

dragOverEvent

dragOverEvent ( )
Fires every mousemove event while over a drag and drop object.

endDragEvent

endDragEvent ( )
Fires on the mouseup event after a drag has been initiated (startDrag fired).

invalidDropEvent

invalidDropEvent ( )
Fires when the dragged objects is dropped in a location that contains no drop targets.

mouseDownEvent

mouseDownEvent ( )
Provides access to the mousedown event. The mousedown does not always result in a drag operation.

mouseUpEvent

mouseUpEvent ( )
Fired from inside DragDropMgr when the drag operation is finished.

startDragEvent

startDragEvent ( )
Occurs after a mouse down and the drag threshold has been met. The drag threshold default is either 3 pixels of mouse movement or 1 full second of holding the mousedown.


Copyright © 2008 Yahoo! Inc. All rights reserved.