X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/c930e9176a5a85509c5b0230e2bff5c22a591432..7a654f8d43fdb43d78b63d90528bed6e86b608cc:/docs/output/Ext.dd.DropZone.html?ds=inline diff --git a/docs/output/Ext.dd.DropZone.html b/docs/output/Ext.dd.DropZone.html deleted file mode 100644 index 13d71b69..00000000 --- a/docs/output/Ext.dd.DropZone.html +++ /dev/null @@ -1,348 +0,0 @@ -
DragDrop DDTarget DropTarget DropZone
Package: | Ext.dd |
Defined In: | DropZone.js |
Class: | DropZone |
Subclasses: | TreeDropZone |
Extends: | DropTarget |
This class provides a container DD instance that allows dropping on multiple child target nodes.
-By default, this class requires that child nodes accepting drop are registered with Ext.dd.Registry. -However a simpler way to allow a DropZone to manage any number of target elements is to configure the -DropZone with an implementation of getTargetFromEvent which interrogates the passed -mouse event to see if it has taken place within an element, or class of elements. This is easily done -by using the event's getTarget method to identify a node based on a -Ext.DomQuery selector.
-Once the DropZone has detected through calling getTargetFromEvent, that the mouse is over -a drop target, that target is passed as the first parameter to onNodeEnter, onNodeOver, -onNodeOut, onNodeDrop. You may configure the instance of DropZone with implementations -of these methods to provide application-specific behaviour for these events to update both -application state, and UI state.
-For example to make a GridPanel a cooperating target with the example illustrated in -DragZone, the following technique might be used:
myGridPanel.on('render', function() {
- myGridPanel.dropZone = new Ext.dd.DropZone(myGridPanel.getView().scroller, {
-
-// If the mouse is over a grid row, return that node. This is
-// provided as the "target" parameter in all "onNodeXXXX" node event handling functions
- getTargetFromEvent: function(e) {
- return e.getTarget(myGridPanel.getView().rowSelector);
- },
-
-// On entry into a target node, highlight that node.
- onNodeEnter : function(target, dd, e, data){
- Ext.fly(target).addClass('my-row-highlight-class');
- },
-
-// On exit from a target node, unhighlight that node.
- onNodeOut : function(target, dd, e, data){
- Ext.fly(target).removeClass('my-row-highlight-class');
- },
-
-// While over a target node, return the default drop allowed class which
-// places a "tick" icon into the drag proxy.
- onNodeOver : function(target, dd, e, data){
- return Ext.dd.DropZone.prototype.dropAllowed;
- },
-
-// On node drop we can interrogate the target to find the underlying
-// application object that is the real target of the dragged data.
-// In this case, it is a Record in the GridPanel's Store.
-// We can use the data set up by the DragZone's getDragData method to read
-// any data we decided to attach in the DragZone's getDragData method.
- onNodeDrop : function(target, dd, e, data){
- var rowIndex = myGridPanel.getView().findRowIndex(target);
- var r = myGridPanel.getStore().getAt(rowIndex);
- Ext.Msg.alert('Drop gesture', 'Dropped Record id ' + data.draggedRecord.id +
- ' on Record id ' + r.id);
- return true;
- }
- });
-}
-See the DragZone documentation for details about building a DragZone which
-cooperates with this DropZone.Config Options | Defined By | |
---|---|---|
ddGroup : String A named drag drop group to which this object belongs. If a group is specified, then this object will only
-interact ... A named drag drop group to which this object belongs. If a group is specified, then this object will only
-interact with other drag drop objects in the same group (defaults to undefined). | DropTarget | |
dropAllowed : String The CSS class returned to the drag source when drop is allowed (defaults to "x-dd-drop-ok"). | DropTarget | |
dropNotAllowed : String The CSS class returned to the drag source when drop is not allowed (defaults to "x-dd-drop-nodrop"). | DropTarget | |
overClass : String The CSS class applied to the drop target element while the drag source is over it (defaults to ""). | DropTarget |
Property | Defined By | |
---|---|---|
Only : Object The drag and drop utility provides a framework for building drag and drop
-applications. In addition to enabling drag... The drag and drop utility provides a framework for building drag and drop
-applications. In addition to enabling drag and drop for specific elements,
-the drag and drop elements are tracked by the manager class, and the
-interactions between the various elements are tracked during the drag and
-the implementing code is notified about these important moments. | DragDrop | |
available : boolean The availabe property is false until the linked dom element is accessible. | DragDrop | |
config : object Configuration attributes passed into the constructor | DragDrop | |
defaultPadding : Object Provides default constraint padding to "constrainTo" elements (defaults to {left: 0, right:0, top:0, bottom:0}). | DragDrop | |
groups : object An object in the format {'group1':true, 'group2':true The group defines a logical collection of DragDrop objects that are
-related. Instances only get events when interact... The group defines a logical collection of DragDrop objects that are
-related. Instances only get events when interacting with other
-DragDrop object in the same group. This lets us define multiple
-groups using a single DragDrop subclass if we want. | DragDrop | |
hasOuterHandles : boolean By default, drags can only be initiated if the mousedown occurs in the
-region the linked element is. This is done in... By default, drags can only be initiated if the mousedown occurs in the
-region the linked element is. This is done in part to work around a
-bug in some browsers that mis-report the mousedown if the previous
-mouseup happened outside of the window. This property is set to true
-if outer handles are defined. | DragDrop | |
id : String The id of the element associated with this object. This is what we
-refer to as the "linked element" because the size... The id of the element associated with this object. This is what we
-refer to as the "linked element" because the size and position of
-this element is used to determine when the drag and drop objects have
-interacted. | DragDrop | |
ignoreSelf : Boolean Set to false to enable a DragDrop object to fire drag events while dragging
-over its own Element. Defaults to true - ... Set to false to enable a DragDrop object to fire drag events while dragging
-over its own Element. Defaults to true - DragDrop objects do not by default
-fire drag events to themselves. | DragDrop | |
invalidHandleClasses : Array An Array of CSS class names for elements to be considered in valid as drag handles. | DragDrop | |
invalidHandleIds : Object An object who's property names identify the IDs of elements to be considered invalid as drag handles.
-A non-null prop... An object who's property names identify the IDs of elements to be considered invalid as drag handles.
-A non-null property value identifies the ID as invalid. For example, to prevent
-dragging from being initiated on element ID "foo", use:
| DragDrop | |
invalidHandleTypes : Object An object who's property names identify HTML tags to be considered invalid as drag handles.
-A non-null property value... An object who's property names identify HTML tags to be considered invalid as drag handles.
-A non-null property value identifies the tag as invalid. Defaults to the
-following value which prevents drag operations from being initiated by <a> elements:
| DragDrop | |
isTarget : boolean By default, all instances can be a drop target. This can be disabled by
-setting isTarget to false. | DragDrop | |
maintainOffset : boolean Maintain offsets when we resetconstraints. Set to true when you want
-the position of the element relative to its par... Maintain offsets when we resetconstraints. Set to true when you want
-the position of the element relative to its parent to stay the same
-when the page changes | DragDrop | |
moveOnly : boolean When set to true, other DD objects in cooperating DDGroups do not receive
-notification events when this DD object is ... When set to true, other DD objects in cooperating DDGroups do not receive
-notification events when this DD object is dragged over them. Defaults to false. | DragDrop | |
padding : int[] An array containing the 4 padding values: [top, right, bottom, left] The padding configured for this drag and drop object for calculating
-the drop zone intersection with this object. | DragDrop | |
primaryButtonOnly : boolean By default the drag and drop instance will only respond to the primary
-button click (left button for a right-handed m... By default the drag and drop instance will only respond to the primary
-button click (left button for a right-handed mouse). Set to true to
-allow drag and drop to start with any mouse click that is propogated
-by the browser | DragDrop | |
xTicks : int[] Array of pixel locations the element will snap to if we specified a
-horizontal graduation/interval. This array is ge... Array of pixel locations the element will snap to if we specified a
-horizontal graduation/interval. This array is generated automatically
-when you define a tick interval. | DragDrop | |
yTicks : int[] Array of pixel locations the element will snap to if we specified a
-vertical graduation/interval. This array is gene... Array of pixel locations the element will snap to if we specified a
-vertical graduation/interval. This array is generated automatically
-when you define a tick interval. | DragDrop |
Method | Defined By | |
---|---|---|
DropZone( Mixed el , Object config )
- Parameters:
| DropZone | |
addInvalidHandleClass( string cssClass )
- :
- voidLets you specify a css class of elements that will not initiate a drag Lets you specify a css class of elements that will not initiate a drag Parameters:
| DragDrop | |
addInvalidHandleId( string id )
- :
- voidLets you to specify an element id for a child of a drag handle
-that should not initiate a drag Lets you to specify an element id for a child of a drag handle
-that should not initiate a drag Parameters:
| DragDrop | |
addInvalidHandleType( string tagName )
- :
- voidAllows you to specify a tag name that should not start a drag operation
-when clicked. This is designed to facilitate... Allows you to specify a tag name that should not start a drag operation
-when clicked. This is designed to facilitate embedding links within a
-drag handle that do something other than start the drag. Parameters:
| DragDrop | |
addToGroup( sGroup {string} )
- :
- voidAdd this instance to a group of related drag/drop objects. All
-instances belong to at least one group, and can belon... Add this instance to a group of related drag/drop objects. All
-instances belong to at least one group, and can belong to as many
-groups as needed. Parameters:
| DragDrop | |
applyConfig()
- :
- void Applies the configuration parameters that were passed into the constructor.
-This is supposed to happen at each level ... Applies the configuration parameters that were passed into the constructor.
-This is supposed to happen at each level through the inheritance chain. So
-a DDProxy implentation will execute apply config on DDProxy, DD, and
-DragDrop in order to get all of the parameters that are available in
-each object. Parameters:
| DragDrop | |
clearConstraints()
- :
- void Clears any constraints applied to this instance. Also clears ticks
-since they can't exist independent of a constrain... Clears any constraints applied to this instance. Also clears ticks
-since they can't exist independent of a constraint at this time. Parameters:
| DragDrop | |
clearTicks()
- :
- void Clears any tick interval defined for this instance Clears any tick interval defined for this instance Parameters:
| DragDrop | |
constrainTo( Mixed constrainTo , [Object/Number pad ], [Boolean inContent ] )
- :
- voidInitializes the drag drop object's constraints to restrict movement to a certain element.
-Usage:
- var dd = new Ext.dd... Initializes the drag drop object's constraints to restrict movement to a certain element.
-Usage:
-
-Or you can initalize it using the Ext.Element object:
-
Parameters:
| DragDrop | |
endDrag( Event e )
- :
- voidFired when we are done dragging the object Fired when we are done dragging the object Parameters:
| DragDrop | |
getDragEl()
- :
- HTMLElement Returns a reference to the actual element to drag. By default this is
-the same as the html element, but it can be as... Returns a reference to the actual element to drag. By default this is
-the same as the html element, but it can be assigned to another
-element. An example of this can be found in Ext.dd.DDProxy Parameters:
| DragDrop | |
getEl()
- :
- HTMLElement Returns a reference to the linked element Returns a reference to the linked element Parameters:
| DragDrop | |
getTargetFromEvent( Event e )
- :
- ObjectReturns a custom data object associated with the DOM node that is the target of the event. By default
-this looks up... Returns a custom data object associated with the DOM node that is the target of the event. By default
-this looks up the event target in the Ext.dd.Registry, although you can override this method to
-provide your own custom lookup. Parameters:
| DropZone | |
init( id the , String sGroup , object config )
- :
- voidSets up the DragDrop object. Must be called in the constructor of any
-Ext.dd.DragDrop subclass Sets up the DragDrop object. Must be called in the constructor of any
-Ext.dd.DragDrop subclass Parameters:
| DragDrop | |
initTarget( id the , String sGroup , object config )
- :
- voidInitializes Targeting functionality only... the object does not
-get a mousedown handler. Initializes Targeting functionality only... the object does not
-get a mousedown handler. Parameters:
| DragDrop | |
isLocked()
- :
- boolean Returns true if this instance is locked, or the drag drop mgr is locked
-(meaning that all drag/drop is disabled on th... Returns true if this instance is locked, or the drag drop mgr is locked
-(meaning that all drag/drop is disabled on the page.) Parameters:
| DragDrop | |
isValidHandleChild( HTMLElement node )
- :
- booleanChecks the tag exclusion list to see if this click should be ignored Checks the tag exclusion list to see if this click should be ignored Parameters:
| DragDrop | |
lock()
- :
- void Lock this instance Lock this instance Parameters:
| DragDrop | |
notifyDrop( Ext.dd.DragSource source , Event e , Object data )
- :
- BooleanThe function a Ext.dd.DragSource calls once to notify this drop zone that the dragged item has
-been dropped on it. ... The function a Ext.dd.DragSource calls once to notify this drop zone that the dragged item has
-been dropped on it. The drag zone will look up the target node based on the event passed in, and if there
-is a node registered for that event, it will delegate to onNodeDrop for node-specific handling,
-otherwise it will call onContainerDrop. Parameters:
| DropZone | |
notifyEnter( Ext.dd.DragSource source , Event e , Object data )
- :
- StringThe function a Ext.dd.DragSource calls once to notify this drop zone that the source is now over
-the zone. The defa... The function a Ext.dd.DragSource calls once to notify this drop zone that the source is now over
-the zone. The default implementation returns this.dropNotAllowed and expects that only registered drop
-nodes can process drag drop operations, so if you need the drop zone itself to be able to process drops
-you should override this method and provide a custom implementation. Parameters:
| DropZone | |
notifyOut( Ext.dd.DragSource source , Event e , Object data )
- :
- voidThe function a Ext.dd.DragSource calls once to notify this drop zone that the source has been dragged
-out of the zon... The function a Ext.dd.DragSource calls once to notify this drop zone that the source has been dragged
-out of the zone without dropping. If the drag source is currently over a registered node, the notification
-will be delegated to onNodeOut for node-specific handling, otherwise it will be ignored. Parameters:
| DropZone | |
notifyOver( Ext.dd.DragSource source , Event e , Object data )
- :
- StringThe function a Ext.dd.DragSource calls continuously while it is being dragged over the drop zone.
-This method will b... The function a Ext.dd.DragSource calls continuously while it is being dragged over the drop zone.
-This method will be called on every mouse movement while the drag source is over the drop zone.
-It will call onNodeOver while the drag source is over a registered node, and will also automatically
-delegate to the appropriate node-specific methods as necessary when the drag source enters and exits
-registered nodes (onNodeEnter, onNodeOut). If the drag source is not currently over a
-registered node, it will call onContainerOver. Parameters:
| DropZone | |
onAvailable()
- :
- void Override the onAvailable method to do what is needed after the initial
-position was determined. Override the onAvailable method to do what is needed after the initial
-position was determined. Parameters:
| DragDrop | |
onContainerDrop( Ext.dd.DragSource source , Event e , Object data )
- :
- BooleanCalled when the DropZone determines that a Ext.dd.DragSource has been dropped on it,
-but not on any of its registere... Called when the DropZone determines that a Ext.dd.DragSource has been dropped on it,
-but not on any of its registered drop nodes. The default implementation returns false, so it should be
-overridden to provide the appropriate processing of the drop event if you need the drop zone itself to
-be able to accept drops. It should return true when valid so that the drag source's repair action does not run. Parameters:
| DropZone | |
onContainerOver( Ext.dd.DragSource source , Event e , Object data )
- :
- StringCalled while the DropZone determines that a Ext.dd.DragSource is being dragged over it,
-but not over any of its regi... Called while the DropZone determines that a Ext.dd.DragSource is being dragged over it,
-but not over any of its registered drop nodes. The default implementation returns this.dropNotAllowed, so
-it should be overridden to provide the proper feedback if necessary. Parameters:
| DropZone | |
onDrag( Event e )
- :
- voidAbstract method called during the onMouseMove event while dragging an
-object. Abstract method called during the onMouseMove event while dragging an
-object. Parameters:
| DragDrop | |
onDragDrop( Event e , String|DragDrop[] id )
- :
- voidAbstract method called when this item is dropped on another DragDrop
-obj Abstract method called when this item is dropped on another DragDrop
-obj Parameters:
| DragDrop | |
onDragEnter( Event e , String|DragDrop[] id )
- :
- voidAbstract method called when this element fist begins hovering over
-another DragDrop obj Abstract method called when this element fist begins hovering over
-another DragDrop obj Parameters:
| DragDrop | |
onDragOut( Event e , String|DragDrop[] id )
- :
- voidAbstract method called when we are no longer hovering over an element Abstract method called when we are no longer hovering over an element Parameters:
| DragDrop | |
onDragOver( Event e , String|DragDrop[] id )
- :
- voidAbstract method called when this element is hovering over another
-DragDrop obj Abstract method called when this element is hovering over another
-DragDrop obj Parameters:
| DragDrop | |
onInvalidDrop( Event e )
- :
- voidAbstract method called when this item is dropped on an area with no
-drop target Abstract method called when this item is dropped on an area with no
-drop target Parameters:
| DragDrop | |
onMouseDown( Event e )
- :
- voidEvent handler that fires when a drag/drop obj gets a mousedown Event handler that fires when a drag/drop obj gets a mousedown Parameters:
| DragDrop | |
onMouseUp( Event e )
- :
- voidEvent handler that fires when a drag/drop obj gets a mouseup Event handler that fires when a drag/drop obj gets a mouseup Parameters:
| DragDrop | |
onNodeDrop( Object nodeData , Ext.dd.DragSource source , Event e , Object data )
- :
- BooleanCalled when the DropZone determines that a Ext.dd.DragSource has been dropped onto
-the drop node. The default imple... Called when the DropZone determines that a Ext.dd.DragSource has been dropped onto
-the drop node. The default implementation returns false, so it should be overridden to provide the
-appropriate processing of the drop event and return true so that the drag source's repair action does not run. Parameters:
| DropZone | |
onNodeEnter( Object nodeData , Ext.dd.DragSource source , Event e , Object data )
- :
- voidCalled when the DropZone determines that a Ext.dd.DragSource has entered a drop node
-that has either been registered... Called when the DropZone determines that a Ext.dd.DragSource has entered a drop node
-that has either been registered or detected by a configured implementation of getTargetFromEvent.
-This method has no default implementation and should be overridden to provide
-node-specific processing if necessary. Parameters:
| DropZone | |
onNodeOut( Object nodeData , Ext.dd.DragSource source , Event e , Object data )
- :
- voidCalled when the DropZone determines that a Ext.dd.DragSource has been dragged out of
-the drop node without dropping.... Called when the DropZone determines that a Ext.dd.DragSource has been dragged out of
-the drop node without dropping. This method has no default implementation and should be overridden to provide
-node-specific processing if necessary. Parameters:
| DropZone | |
onNodeOver( Object nodeData , Ext.dd.DragSource source , Event e , Object data )
- :
- StringCalled while the DropZone determines that a Ext.dd.DragSource is over a drop node
-that has either been registered or... Called while the DropZone determines that a Ext.dd.DragSource is over a drop node
-that has either been registered or detected by a configured implementation of getTargetFromEvent.
-The default implementation returns this.dropNotAllowed, so it should be
-overridden to provide the proper feedback. Parameters:
| DropZone | |
removeFromGroup( string sGroup )
- :
- voidRemove's this instance from the supplied interaction group Remove's this instance from the supplied interaction group Parameters:
| DragDrop | |
removeInvalidHandleClass( string cssClass )
- :
- voidUnsets an invalid css class Unsets an invalid css class Parameters:
| DragDrop | |
removeInvalidHandleId( string id )
- :
- voidUnsets an invalid handle id Unsets an invalid handle id Parameters:
| DragDrop | |
removeInvalidHandleType( string tagName )
- :
- voidUnsets an excluded tag name set by addInvalidHandleType Unsets an excluded tag name set by addInvalidHandleType Parameters:
| DragDrop | |
resetConstraints( boolean maintainOffset )
- :
- voidresetConstraints must be called if you manually reposition a dd element. resetConstraints must be called if you manually reposition a dd element. Parameters:
| DragDrop | |
setDragElId( id {string} )
- :
- voidAllows you to specify that an element other than the linked element
-will be moved with the cursor during a drag Allows you to specify that an element other than the linked element
-will be moved with the cursor during a drag Parameters:
| DragDrop | |
setHandleElId( id {string} )
- :
- voidAllows you to specify a child of the linked element that should be
-used to initiate the drag operation. An example o... Allows you to specify a child of the linked element that should be
-used to initiate the drag operation. An example of this would be if
-you have a content div with text and links. Clicking anywhere in the
-content area would normally start the drag operation. Use this method
-to specify that an element inside of the content div is the element
-that starts the drag operation. Parameters:
| DragDrop | |
setInitPosition( int diffX , int diffY )
- :
- voidStores the initial placement of the linked element. Stores the initial placement of the linked element. Parameters:
| DragDrop | |
setOuterHandleElId( id the )
- :
- voidAllows you to set an element outside of the linked element as a drag
-handle Allows you to set an element outside of the linked element as a drag
-handle Parameters:
| DragDrop | |
setPadding( int iTop , int iRight , int iBot , int iLeft )
- :
- voidConfigures the padding for the target zone in px. Effectively expands
-(or reduces) the virtual object size for targe... Configures the padding for the target zone in px. Effectively expands
-(or reduces) the virtual object size for targeting calculations.
-Supports css-style shorthand; if only one parameter is passed, all sides
-will have that padding, and if only two are passed, the top and bottom
-will have the first param, the left and right the second. Parameters:
| DragDrop | |
setXConstraint( int iLeft , int iRight , int iTickSize )
- :
- voidBy default, the element can be dragged any place on the screen. Use
-this method to limit the horizontal travel of th... By default, the element can be dragged any place on the screen. Use
-this method to limit the horizontal travel of the element. Pass in
-0,0 for the parameters if you want to lock the drag to the y axis. Parameters:
| DragDrop | |
setYConstraint( int iUp , int iDown , int iTickSize )
- :
- voidBy default, the element can be dragged any place on the screen. Set
-this to limit the vertical travel of the element... By default, the element can be dragged any place on the screen. Set
-this to limit the vertical travel of the element. Pass in 0,0 for the
-parameters if you want to lock the drag to the x axis. Parameters:
| DragDrop | |
startDrag( int X , int Y )
- :
- voidAbstract method called after a drag/drop object is clicked
-and the drag or mousedown time thresholds have beeen met. Abstract method called after a drag/drop object is clicked
-and the drag or mousedown time thresholds have beeen met. Parameters:
| DragDrop | |
toString()
- :
- string toString method toString method Parameters:
| DragDrop | |
unlock()
- :
- void Unlock this instace Unlock this instace Parameters:
| DragDrop | |
unreg()
- :
- void Remove all drag and drop hooks for this element Remove all drag and drop hooks for this element Parameters:
| DragDrop |