sync
[roojs1] / docs / symbols / Roo.dd.DragDrop.json
1 {
2   "name" : "Roo.dd.DragDrop",
3   "augments" : [
4     "Roo.util.Observable"
5   ],
6   "childClasses" : {
7     "Roo.dd.DragDrop" : [
8       "Roo.dd.DD",
9       "Roo.dd.DDTarget"
10     ],
11     "Roo.dd.DDProxy" : [
12       "Roo.dd.DragSource",
13       "Roo.grid.SplitDragZone"
14     ],
15     "Roo.dd.DD" : [
16       "Roo.dd.DDProxy"
17     ],
18     "Roo.dd.DDTarget" : [
19       "Roo.dd.DropTarget"
20     ],
21     "Roo.dd.DropTarget" : [
22       "Roo.dd.DropZone"
23     ],
24     "Roo.dd.DragSource" : [
25       "Roo.dd.DragZone"
26     ]
27   },
28   "tree_children" : [],
29   "tree_parent" : [],
30   "desc" : "Defines the interface and base operation of items that that can be\ndragged or can be drop targets.  It was designed to be extended, overriding\nthe event handlers for startDrag, onDrag, onDragOver and onDragOut.\nUp to three html elements can be associated with a DragDrop instance:\n<ul>\n<li>linked element: the element that is passed into the constructor.\nThis is the element which defines the boundaries for interaction with\nother DragDrop objects.</li>\n<li>handle element(s): The drag operation only occurs if the element that\nwas clicked matches a handle element.  By default this is the linked\nelement, but there are times that you will want only a portion of the\nlinked element to initiate the drag operation, and the setHandleElId()\nmethod provides a way to define this.</li>\n<li>drag element: this represents the element that would be moved along\nwith the cursor during a drag operation.  By default, this is the linked\nelement itself as in {@link Roo.dd.DD}.  setDragElId() lets you define\na separate element that would be moved, as in {@link Roo.dd.DDProxy}.\n</li>\n</ul>\nThis class should not be instantiated until the onload event to ensure that\nthe associated elements are available.\nThe following would define a DragDrop obj that would interact with any\nother DragDrop obj in the \"group1\" group:\n<pre>\n dd = new Roo.dd.DragDrop(\"div1\", \"group1\");\n</pre>\nSince none of the event handlers have been implemented, nothing would\nactually happen if you were to run the code above.  Normally you would\noverride this class or one of the default implementations, but you can\nalso override the methods you want on an instance of the class...\n<pre>\n dd.onDragDrop = function(e, id) {\n &nbsp;&nbsp;alert(\"dd was dropped on \" + id);\n }\n</pre>",
31   "isSingleton" : false,
32   "isStatic" : true,
33   "isBuiltin" : false,
34   "isAbstract" : false,
35   "isBuilderTop" : false,
36   "memberOf" : "DragDrop",
37   "example" : "",
38   "deprecated" : "",
39   "since" : "",
40   "see" : "",
41   "params" : [
42     {
43       "name" : "id",
44       "type" : "String",
45       "desc" : "of the element that is linked to this instance",
46       "isOptional" : false
47     },
48     {
49       "name" : "sGroup",
50       "type" : "String",
51       "desc" : "the group of related DragDrop objects",
52       "isOptional" : false
53     },
54     {
55       "name" : "config",
56       "type" : "object",
57       "desc" : "an object containing configurable attributes\n               Valid properties for DragDrop:\n                   padding, isTarget, maintainOffset, primaryButtonOnly",
58       "isOptional" : false
59     }
60   ],
61   "returns" : [],
62   "throws" : "",
63   "requires" : "",
64   "config" : [
65     {
66       "name" : "listeners",
67       "type" : "Object",
68       "desc" : "list of events and functions to call for this object, \nFor example :\n<pre><code>\n    listeners :  { \n       'click' : function(e) {\n           ..... \n        } ,\n        .... \n    } \n  </code></pre>",
69       "memberOf" : "Roo.util.Observable"
70     }
71   ],
72   "methods" : [
73     {
74       "name" : "setHandleElId",
75       "type" : "function",
76       "desc" : "Allows you to specify a child of the linked element that should be\nused to initiate the drag operation.  An example of this would be if\nyou have a content div with text and links.  Clicking anywhere in the\ncontent area would normally start the drag operation.  Use this method\nto specify that an element inside of the content div is the element\nthat starts the drag operation.",
77       "sig" : "(id)",
78       "static" : false,
79       "memberOf" : "",
80       "isStatic" : false,
81       "isConstructor" : false,
82       "isPrivate" : false,
83       "example" : "",
84       "deprecated" : "",
85       "since" : "",
86       "see" : "",
87       "exceptions" : "",
88       "requires" : "",
89       "params" : [
90         {
91           "name" : "id",
92           "type" : "",
93           "desc" : "{string} the id of the element that will be used to\ninitiate the drag.",
94           "isOptional" : false
95         }
96       ],
97       "returns" : []
98     },
99     {
100       "name" : "init",
101       "type" : "function",
102       "desc" : "Sets up the DragDrop object.  Must be called in the constructor of any\nRoo.dd.DragDrop subclass",
103       "sig" : "(id, sGroup, config)",
104       "static" : false,
105       "memberOf" : "",
106       "isStatic" : false,
107       "isConstructor" : false,
108       "isPrivate" : false,
109       "example" : "",
110       "deprecated" : "",
111       "since" : "",
112       "see" : "",
113       "exceptions" : "",
114       "requires" : "",
115       "params" : [
116         {
117           "name" : "id",
118           "type" : "",
119           "desc" : "the id of the linked element",
120           "isOptional" : false
121         },
122         {
123           "name" : "sGroup",
124           "type" : "String",
125           "desc" : "the group of related items",
126           "isOptional" : false
127         },
128         {
129           "name" : "config",
130           "type" : "object",
131           "desc" : "configuration attributes",
132           "isOptional" : false
133         }
134       ],
135       "returns" : []
136     },
137     {
138       "name" : "removeInvalidHandleType",
139       "type" : "function",
140       "desc" : "Unsets an excluded tag name set by addInvalidHandleType",
141       "sig" : "(tagName)",
142       "static" : false,
143       "memberOf" : "",
144       "isStatic" : false,
145       "isConstructor" : false,
146       "isPrivate" : false,
147       "example" : "",
148       "deprecated" : "",
149       "since" : "",
150       "see" : "",
151       "exceptions" : "",
152       "requires" : "",
153       "params" : [
154         {
155           "name" : "tagName",
156           "type" : "string",
157           "desc" : "the type of element to unexclude",
158           "isOptional" : false
159         }
160       ],
161       "returns" : []
162     },
163     {
164       "name" : "unreg",
165       "type" : "function",
166       "desc" : "Remove all drag and drop hooks for this element",
167       "sig" : "()\n{\n\n}",
168       "static" : false,
169       "memberOf" : "",
170       "isStatic" : false,
171       "isConstructor" : false,
172       "isPrivate" : false,
173       "example" : "",
174       "deprecated" : "",
175       "since" : "",
176       "see" : "",
177       "exceptions" : "",
178       "requires" : "",
179       "params" : [],
180       "returns" : []
181     },
182     {
183       "name" : "addInvalidHandleType",
184       "type" : "function",
185       "desc" : "Allows you to specify a tag name that should not start a drag operation\nwhen clicked.  This is designed to facilitate embedding links within a\ndrag handle that do something other than start the drag.",
186       "sig" : "(tagName)",
187       "static" : false,
188       "memberOf" : "",
189       "isStatic" : false,
190       "isConstructor" : false,
191       "isPrivate" : false,
192       "example" : "",
193       "deprecated" : "",
194       "since" : "",
195       "see" : "",
196       "exceptions" : "",
197       "requires" : "",
198       "params" : [
199         {
200           "name" : "tagName",
201           "type" : "string",
202           "desc" : "the type of element to exclude",
203           "isOptional" : false
204         }
205       ],
206       "returns" : []
207     },
208     {
209       "name" : "onDragDrop",
210       "type" : "function",
211       "desc" : "Abstract method called when this item is dropped on another DragDrop\nobj",
212       "sig" : "(e, id)",
213       "static" : false,
214       "memberOf" : "",
215       "isStatic" : false,
216       "isConstructor" : false,
217       "isPrivate" : false,
218       "example" : "",
219       "deprecated" : "",
220       "since" : "",
221       "see" : "",
222       "exceptions" : "",
223       "requires" : "",
224       "params" : [
225         {
226           "name" : "e",
227           "type" : "Event",
228           "desc" : "the mouseup event",
229           "isOptional" : false
230         },
231         {
232           "name" : "id",
233           "type" : "String|DragDrop[]",
234           "desc" : "In POINT mode, the element\nid this was dropped on.  In INTERSECT mode, an array of dd items this\nwas dropped on.",
235           "isOptional" : false
236         }
237       ],
238       "returns" : []
239     },
240     {
241       "name" : "removeInvalidHandleId",
242       "type" : "function",
243       "desc" : "Unsets an invalid handle id",
244       "sig" : "(id)",
245       "static" : false,
246       "memberOf" : "",
247       "isStatic" : false,
248       "isConstructor" : false,
249       "isPrivate" : false,
250       "example" : "",
251       "deprecated" : "",
252       "since" : "",
253       "see" : "",
254       "exceptions" : "",
255       "requires" : "",
256       "params" : [
257         {
258           "name" : "id",
259           "type" : "string",
260           "desc" : "the id of the element to re-enable",
261           "isOptional" : false
262         }
263       ],
264       "returns" : []
265     },
266     {
267       "name" : "onAvailable",
268       "type" : "function",
269       "desc" : "Override the onAvailable method to do what is needed after the initial\nposition was determined.",
270       "sig" : "()\n{\n\n}",
271       "static" : false,
272       "memberOf" : "",
273       "isStatic" : false,
274       "isConstructor" : false,
275       "isPrivate" : false,
276       "example" : "",
277       "deprecated" : "",
278       "since" : "",
279       "see" : "",
280       "exceptions" : "",
281       "requires" : "",
282       "params" : [],
283       "returns" : []
284     },
285     {
286       "name" : "setOuterHandleElId",
287       "type" : "function",
288       "desc" : "Allows you to set an element outside of the linked element as a drag\nhandle",
289       "sig" : "(id)",
290       "static" : false,
291       "memberOf" : "",
292       "isStatic" : false,
293       "isConstructor" : false,
294       "isPrivate" : false,
295       "example" : "",
296       "deprecated" : "",
297       "since" : "",
298       "see" : "",
299       "exceptions" : "",
300       "requires" : "",
301       "params" : [
302         {
303           "name" : "id",
304           "type" : "",
305           "desc" : "the id of the element that will be used to initiate the drag",
306           "isOptional" : false
307         }
308       ],
309       "returns" : []
310     },
311     {
312       "name" : "onMouseUp",
313       "type" : "function",
314       "desc" : "Event handler that fires when a drag/drop obj gets a mouseup",
315       "sig" : "(e)",
316       "static" : false,
317       "memberOf" : "",
318       "isStatic" : false,
319       "isConstructor" : false,
320       "isPrivate" : false,
321       "example" : "",
322       "deprecated" : "",
323       "since" : "",
324       "see" : "",
325       "exceptions" : "",
326       "requires" : "",
327       "params" : [
328         {
329           "name" : "e",
330           "type" : "Event",
331           "desc" : "the mouseup event",
332           "isOptional" : false
333         }
334       ],
335       "returns" : []
336     },
337     {
338       "name" : "getDragEl",
339       "type" : "function",
340       "desc" : "Returns a reference to the actual element to drag.  By default this is\nthe same as the html element, but it can be assigned to another\nelement. An example of this can be found in Roo.dd.DDProxy",
341       "sig" : "()\n{\n\n}",
342       "static" : false,
343       "memberOf" : "",
344       "isStatic" : false,
345       "isConstructor" : false,
346       "isPrivate" : false,
347       "example" : "",
348       "deprecated" : "",
349       "since" : "",
350       "see" : "",
351       "exceptions" : "",
352       "requires" : "",
353       "params" : [],
354       "returns" : [
355         {
356           "name" : "",
357           "type" : "HTMLElement",
358           "desc" : "the html element"
359         }
360       ]
361     },
362     {
363       "name" : "setYConstraint",
364       "type" : "function",
365       "desc" : "By default, the element can be dragged any place on the screen.  Set\nthis to limit the vertical travel of the element.  Pass in 0,0 for the\nparameters if you want to lock the drag to the x axis.",
366       "sig" : "(iUp, iDown, iTickSize)",
367       "static" : false,
368       "memberOf" : "",
369       "isStatic" : false,
370       "isConstructor" : false,
371       "isPrivate" : false,
372       "example" : "",
373       "deprecated" : "",
374       "since" : "",
375       "see" : "",
376       "exceptions" : "",
377       "requires" : "",
378       "params" : [
379         {
380           "name" : "iUp",
381           "type" : "int",
382           "desc" : "the number of pixels the element can move up",
383           "isOptional" : false
384         },
385         {
386           "name" : "iDown",
387           "type" : "int",
388           "desc" : "the number of pixels the element can move down",
389           "isOptional" : false
390         },
391         {
392           "name" : "iTickSize",
393           "type" : "int",
394           "desc" : "optional parameter for specifying that the\nelement should move iTickSize pixels at a time.",
395           "isOptional" : false
396         }
397       ],
398       "returns" : []
399     },
400     {
401       "name" : "clearConstraints",
402       "type" : "function",
403       "desc" : "Clears any constraints applied to this instance.  Also clears ticks\nsince they can't exist independent of a constraint at this time.",
404       "sig" : "()\n{\n\n}",
405       "static" : false,
406       "memberOf" : "",
407       "isStatic" : false,
408       "isConstructor" : false,
409       "isPrivate" : false,
410       "example" : "",
411       "deprecated" : "",
412       "since" : "",
413       "see" : "",
414       "exceptions" : "",
415       "requires" : "",
416       "params" : [],
417       "returns" : []
418     },
419     {
420       "name" : "onInvalidDrop",
421       "type" : "function",
422       "desc" : "Abstract method called when this item is dropped on an area with no\ndrop target",
423       "sig" : "(e)",
424       "static" : false,
425       "memberOf" : "",
426       "isStatic" : false,
427       "isConstructor" : false,
428       "isPrivate" : false,
429       "example" : "",
430       "deprecated" : "",
431       "since" : "",
432       "see" : "",
433       "exceptions" : "",
434       "requires" : "",
435       "params" : [
436         {
437           "name" : "e",
438           "type" : "Event",
439           "desc" : "the mouseup event",
440           "isOptional" : false
441         }
442       ],
443       "returns" : []
444     },
445     {
446       "name" : "addInvalidHandleId",
447       "type" : "function",
448       "desc" : "Lets you to specify an element id for a child of a drag handle\nthat should not initiate a drag",
449       "sig" : "(id)",
450       "static" : false,
451       "memberOf" : "",
452       "isStatic" : false,
453       "isConstructor" : false,
454       "isPrivate" : false,
455       "example" : "",
456       "deprecated" : "",
457       "since" : "",
458       "see" : "",
459       "exceptions" : "",
460       "requires" : "",
461       "params" : [
462         {
463           "name" : "id",
464           "type" : "string",
465           "desc" : "the element id of the element you wish to ignore",
466           "isOptional" : false
467         }
468       ],
469       "returns" : []
470     },
471     {
472       "name" : "removeInvalidHandleClass",
473       "type" : "function",
474       "desc" : "Unsets an invalid css class",
475       "sig" : "(cssClass)",
476       "static" : false,
477       "memberOf" : "",
478       "isStatic" : false,
479       "isConstructor" : false,
480       "isPrivate" : false,
481       "example" : "",
482       "deprecated" : "",
483       "since" : "",
484       "see" : "",
485       "exceptions" : "",
486       "requires" : "",
487       "params" : [
488         {
489           "name" : "cssClass",
490           "type" : "string",
491           "desc" : "the class of the element(s) you wish to\nre-enable",
492           "isOptional" : false
493         }
494       ],
495       "returns" : []
496     },
497     {
498       "name" : "onDragOut",
499       "type" : "function",
500       "desc" : "Abstract method called when we are no longer hovering over an element",
501       "sig" : "(e, id)",
502       "static" : false,
503       "memberOf" : "",
504       "isStatic" : false,
505       "isConstructor" : false,
506       "isPrivate" : false,
507       "example" : "",
508       "deprecated" : "",
509       "since" : "",
510       "see" : "",
511       "exceptions" : "",
512       "requires" : "",
513       "params" : [
514         {
515           "name" : "e",
516           "type" : "Event",
517           "desc" : "the mousemove event",
518           "isOptional" : false
519         },
520         {
521           "name" : "id",
522           "type" : "String|DragDrop[]",
523           "desc" : "In POINT mode, the element\nid this was hovering over.  In INTERSECT mode, an array of dd items\nthat the mouse is no longer over.",
524           "isOptional" : false
525         }
526       ],
527       "returns" : []
528     },
529     {
530       "name" : "setDragElId",
531       "type" : "function",
532       "desc" : "Allows you to specify that an element other than the linked element\nwill be moved with the cursor during a drag",
533       "sig" : "(id)",
534       "static" : false,
535       "memberOf" : "",
536       "isStatic" : false,
537       "isConstructor" : false,
538       "isPrivate" : false,
539       "example" : "",
540       "deprecated" : "",
541       "since" : "",
542       "see" : "",
543       "exceptions" : "",
544       "requires" : "",
545       "params" : [
546         {
547           "name" : "id",
548           "type" : "",
549           "desc" : "{string} the id of the element that will be used to initiate the drag",
550           "isOptional" : false
551         }
552       ],
553       "returns" : []
554     },
555     {
556       "name" : "endDrag",
557       "type" : "function",
558       "desc" : "Fired when we are done dragging the object",
559       "sig" : "(e)",
560       "static" : false,
561       "memberOf" : "",
562       "isStatic" : false,
563       "isConstructor" : false,
564       "isPrivate" : false,
565       "example" : "",
566       "deprecated" : "",
567       "since" : "",
568       "see" : "",
569       "exceptions" : "",
570       "requires" : "",
571       "params" : [
572         {
573           "name" : "e",
574           "type" : "Event",
575           "desc" : "the mouseup event",
576           "isOptional" : false
577         }
578       ],
579       "returns" : []
580     },
581     {
582       "name" : "getEl",
583       "type" : "function",
584       "desc" : "Returns a reference to the linked element",
585       "sig" : "()\n{\n\n}",
586       "static" : false,
587       "memberOf" : "",
588       "isStatic" : false,
589       "isConstructor" : false,
590       "isPrivate" : false,
591       "example" : "",
592       "deprecated" : "",
593       "since" : "",
594       "see" : "",
595       "exceptions" : "",
596       "requires" : "",
597       "params" : [],
598       "returns" : [
599         {
600           "name" : "",
601           "type" : "HTMLElement",
602           "desc" : "the html element"
603         }
604       ]
605     },
606     {
607       "name" : "onDrag",
608       "type" : "function",
609       "desc" : "Abstract method called during the onMouseMove event while dragging an\nobject.",
610       "sig" : "(e)",
611       "static" : false,
612       "memberOf" : "",
613       "isStatic" : false,
614       "isConstructor" : false,
615       "isPrivate" : false,
616       "example" : "",
617       "deprecated" : "",
618       "since" : "",
619       "see" : "",
620       "exceptions" : "",
621       "requires" : "",
622       "params" : [
623         {
624           "name" : "e",
625           "type" : "Event",
626           "desc" : "the mousemove event",
627           "isOptional" : false
628         }
629       ],
630       "returns" : []
631     },
632     {
633       "name" : "onDragEnter",
634       "type" : "function",
635       "desc" : "Abstract method called when this element fist begins hovering over\nanother DragDrop obj",
636       "sig" : "(e, id)",
637       "static" : false,
638       "memberOf" : "",
639       "isStatic" : false,
640       "isConstructor" : false,
641       "isPrivate" : false,
642       "example" : "",
643       "deprecated" : "",
644       "since" : "",
645       "see" : "",
646       "exceptions" : "",
647       "requires" : "",
648       "params" : [
649         {
650           "name" : "e",
651           "type" : "Event",
652           "desc" : "the mousemove event",
653           "isOptional" : false
654         },
655         {
656           "name" : "id",
657           "type" : "String|DragDrop[]",
658           "desc" : "In POINT mode, the element\nid this is hovering over.  In INTERSECT mode, an array of one or more\ndragdrop items being hovered over.",
659           "isOptional" : false
660         }
661       ],
662       "returns" : []
663     },
664     {
665       "name" : "lock",
666       "type" : "function",
667       "desc" : "Lock this instance",
668       "sig" : "()\n{\n\n}",
669       "static" : false,
670       "memberOf" : "",
671       "isStatic" : false,
672       "isConstructor" : false,
673       "isPrivate" : false,
674       "example" : "",
675       "deprecated" : "",
676       "since" : "",
677       "see" : "",
678       "exceptions" : "",
679       "requires" : "",
680       "params" : [],
681       "returns" : []
682     },
683     {
684       "name" : "onMouseDown",
685       "type" : "function",
686       "desc" : "Event handler that fires when a drag/drop obj gets a mousedown",
687       "sig" : "(e)",
688       "static" : false,
689       "memberOf" : "",
690       "isStatic" : false,
691       "isConstructor" : false,
692       "isPrivate" : false,
693       "example" : "",
694       "deprecated" : "",
695       "since" : "",
696       "see" : "",
697       "exceptions" : "",
698       "requires" : "",
699       "params" : [
700         {
701           "name" : "e",
702           "type" : "Event",
703           "desc" : "the mousedown event",
704           "isOptional" : false
705         }
706       ],
707       "returns" : []
708     },
709     {
710       "name" : "applyConfig",
711       "type" : "function",
712       "desc" : "Applies the configuration parameters that were passed into the constructor.\nThis is supposed to happen at each level through the inheritance chain.  So\na DDProxy implentation will execute apply config on DDProxy, DD, and\nDragDrop in order to get all of the parameters that are available in\neach object.",
713       "sig" : "()\n{\n\n}",
714       "static" : false,
715       "memberOf" : "",
716       "isStatic" : false,
717       "isConstructor" : false,
718       "isPrivate" : false,
719       "example" : "",
720       "deprecated" : "",
721       "since" : "",
722       "see" : "",
723       "exceptions" : "",
724       "requires" : "",
725       "params" : [],
726       "returns" : []
727     },
728     {
729       "name" : "unlock",
730       "type" : "function",
731       "desc" : "Unlock this instace",
732       "sig" : "()\n{\n\n}",
733       "static" : false,
734       "memberOf" : "",
735       "isStatic" : false,
736       "isConstructor" : false,
737       "isPrivate" : false,
738       "example" : "",
739       "deprecated" : "",
740       "since" : "",
741       "see" : "",
742       "exceptions" : "",
743       "requires" : "",
744       "params" : [],
745       "returns" : []
746     },
747     {
748       "name" : "isTarget",
749       "type" : "function",
750       "desc" : "By default, all insances can be a drop target.  This can be disabled by\nsetting isTarget to false.",
751       "sig" : "()\n{\n\n}",
752       "static" : false,
753       "memberOf" : "",
754       "isStatic" : false,
755       "isConstructor" : false,
756       "isPrivate" : false,
757       "example" : "",
758       "deprecated" : "",
759       "since" : "",
760       "see" : "",
761       "exceptions" : "",
762       "requires" : "",
763       "params" : [],
764       "returns" : []
765     },
766     {
767       "name" : "setInitPosition",
768       "type" : "function",
769       "desc" : "Stores the initial placement of the linked element.",
770       "sig" : "(diffX, diffY)",
771       "static" : false,
772       "memberOf" : "",
773       "isStatic" : false,
774       "isConstructor" : false,
775       "isPrivate" : false,
776       "example" : "",
777       "deprecated" : "",
778       "since" : "",
779       "see" : "",
780       "exceptions" : "",
781       "requires" : "",
782       "params" : [
783         {
784           "name" : "diffX",
785           "type" : "int",
786           "desc" : "the X offset, default 0",
787           "isOptional" : false
788         },
789         {
790           "name" : "diffY",
791           "type" : "int",
792           "desc" : "the Y offset, default 0",
793           "isOptional" : false
794         }
795       ],
796       "returns" : []
797     },
798     {
799       "name" : "initTarget",
800       "type" : "function",
801       "desc" : "Initializes Targeting functionality only... the object does not\nget a mousedown handler.",
802       "sig" : "(id, sGroup, config)",
803       "static" : false,
804       "memberOf" : "",
805       "isStatic" : false,
806       "isConstructor" : false,
807       "isPrivate" : false,
808       "example" : "",
809       "deprecated" : "",
810       "since" : "",
811       "see" : "",
812       "exceptions" : "",
813       "requires" : "",
814       "params" : [
815         {
816           "name" : "id",
817           "type" : "",
818           "desc" : "the id of the linked element",
819           "isOptional" : false
820         },
821         {
822           "name" : "sGroup",
823           "type" : "String",
824           "desc" : "the group of related items",
825           "isOptional" : false
826         },
827         {
828           "name" : "config",
829           "type" : "object",
830           "desc" : "configuration attributes",
831           "isOptional" : false
832         }
833       ],
834       "returns" : []
835     },
836     {
837       "name" : "addToGroup",
838       "type" : "function",
839       "desc" : "Add this instance to a group of related drag/drop objects.  All\ninstances belong to at least one group, and can belong to as many\ngroups as needed.",
840       "sig" : "(sGroup)",
841       "static" : false,
842       "memberOf" : "",
843       "isStatic" : false,
844       "isConstructor" : false,
845       "isPrivate" : false,
846       "example" : "",
847       "deprecated" : "",
848       "since" : "",
849       "see" : "",
850       "exceptions" : "",
851       "requires" : "",
852       "params" : [
853         {
854           "name" : "sGroup",
855           "type" : "",
856           "desc" : "{string} the name of the group",
857           "isOptional" : false
858         }
859       ],
860       "returns" : []
861     },
862     {
863       "name" : "onDragOver",
864       "type" : "function",
865       "desc" : "Abstract method called when this element is hovering over another\nDragDrop obj",
866       "sig" : "(e, id)",
867       "static" : false,
868       "memberOf" : "",
869       "isStatic" : false,
870       "isConstructor" : false,
871       "isPrivate" : false,
872       "example" : "",
873       "deprecated" : "",
874       "since" : "",
875       "see" : "",
876       "exceptions" : "",
877       "requires" : "",
878       "params" : [
879         {
880           "name" : "e",
881           "type" : "Event",
882           "desc" : "the mousemove event",
883           "isOptional" : false
884         },
885         {
886           "name" : "id",
887           "type" : "String|DragDrop[]",
888           "desc" : "In POINT mode, the element\nid this is hovering over.  In INTERSECT mode, an array of dd items\nbeing hovered over.",
889           "isOptional" : false
890         }
891       ],
892       "returns" : []
893     },
894     {
895       "name" : "toString",
896       "type" : "function",
897       "desc" : "toString method",
898       "sig" : "()\n{\n\n}",
899       "static" : false,
900       "memberOf" : "",
901       "isStatic" : false,
902       "isConstructor" : false,
903       "isPrivate" : false,
904       "example" : "",
905       "deprecated" : "",
906       "since" : "",
907       "see" : "",
908       "exceptions" : "",
909       "requires" : "",
910       "params" : [],
911       "returns" : [
912         {
913           "name" : "",
914           "type" : "string",
915           "desc" : "string representation of the dd obj"
916         }
917       ]
918     },
919     {
920       "name" : "setPadding",
921       "type" : "function",
922       "desc" : "Configures the padding for the target zone in px.  Effectively expands\n(or reduces) the virtual object size for targeting calculations.\nSupports css-style shorthand; if only one parameter is passed, all sides\nwill have that padding, and if only two are passed, the top and bottom\nwill have the first param, the left and right the second.",
923       "sig" : "(iTop, iRight, iBot, iLeft)",
924       "static" : false,
925       "memberOf" : "",
926       "isStatic" : false,
927       "isConstructor" : false,
928       "isPrivate" : false,
929       "example" : "",
930       "deprecated" : "",
931       "since" : "",
932       "see" : "",
933       "exceptions" : "",
934       "requires" : "",
935       "params" : [
936         {
937           "name" : "iTop",
938           "type" : "int",
939           "desc" : "Top pad",
940           "isOptional" : false
941         },
942         {
943           "name" : "iRight",
944           "type" : "int",
945           "desc" : "Right pad",
946           "isOptional" : false
947         },
948         {
949           "name" : "iBot",
950           "type" : "int",
951           "desc" : "Bot pad",
952           "isOptional" : false
953         },
954         {
955           "name" : "iLeft",
956           "type" : "int",
957           "desc" : "Left pad",
958           "isOptional" : false
959         }
960       ],
961       "returns" : []
962     },
963     {
964       "name" : "removeFromGroup",
965       "type" : "function",
966       "desc" : "Remove's this instance from the supplied interaction group",
967       "sig" : "(sGroup)",
968       "static" : false,
969       "memberOf" : "",
970       "isStatic" : false,
971       "isConstructor" : false,
972       "isPrivate" : false,
973       "example" : "",
974       "deprecated" : "",
975       "since" : "",
976       "see" : "",
977       "exceptions" : "",
978       "requires" : "",
979       "params" : [
980         {
981           "name" : "sGroup",
982           "type" : "string",
983           "desc" : "The group to drop",
984           "isOptional" : false
985         }
986       ],
987       "returns" : []
988     },
989     {
990       "name" : "addInvalidHandleClass",
991       "type" : "function",
992       "desc" : "Lets you specify a css class of elements that will not initiate a drag",
993       "sig" : "(cssClass)",
994       "static" : false,
995       "memberOf" : "",
996       "isStatic" : false,
997       "isConstructor" : false,
998       "isPrivate" : false,
999       "example" : "",
1000       "deprecated" : "",
1001       "since" : "",
1002       "see" : "",
1003       "exceptions" : "",
1004       "requires" : "",
1005       "params" : [
1006         {
1007           "name" : "cssClass",
1008           "type" : "string",
1009           "desc" : "the class of the elements you wish to ignore",
1010           "isOptional" : false
1011         }
1012       ],
1013       "returns" : []
1014     },
1015     {
1016       "name" : "startDrag",
1017       "type" : "function",
1018       "desc" : "Abstract method called after a drag/drop object is clicked\nand the drag or mousedown time thresholds have beeen met.",
1019       "sig" : "(X, Y)",
1020       "static" : false,
1021       "memberOf" : "",
1022       "isStatic" : false,
1023       "isConstructor" : false,
1024       "isPrivate" : false,
1025       "example" : "",
1026       "deprecated" : "",
1027       "since" : "",
1028       "see" : "",
1029       "exceptions" : "",
1030       "requires" : "",
1031       "params" : [
1032         {
1033           "name" : "X",
1034           "type" : "int",
1035           "desc" : "click location",
1036           "isOptional" : false
1037         },
1038         {
1039           "name" : "Y",
1040           "type" : "int",
1041           "desc" : "click location",
1042           "isOptional" : false
1043         }
1044       ],
1045       "returns" : []
1046     },
1047     {
1048       "name" : "padding",
1049       "type" : "function",
1050       "desc" : "The padding configured for this drag and drop object for calculating\nthe drop zone intersection with this object.",
1051       "sig" : "()\n{\n\n}",
1052       "static" : false,
1053       "memberOf" : "",
1054       "isStatic" : false,
1055       "isConstructor" : false,
1056       "isPrivate" : false,
1057       "example" : "",
1058       "deprecated" : "",
1059       "since" : "",
1060       "see" : "",
1061       "exceptions" : "",
1062       "requires" : "",
1063       "params" : [],
1064       "returns" : []
1065     },
1066     {
1067       "name" : "resetConstraints",
1068       "type" : "function",
1069       "desc" : "resetConstraints must be called if you manually reposition a dd element.",
1070       "sig" : "(maintainOffset)",
1071       "static" : false,
1072       "memberOf" : "",
1073       "isStatic" : false,
1074       "isConstructor" : false,
1075       "isPrivate" : false,
1076       "example" : "",
1077       "deprecated" : "",
1078       "since" : "",
1079       "see" : "",
1080       "exceptions" : "",
1081       "requires" : "",
1082       "params" : [
1083         {
1084           "name" : "maintainOffset",
1085           "type" : "boolean",
1086           "desc" : "",
1087           "isOptional" : false
1088         }
1089       ],
1090       "returns" : []
1091     },
1092     {
1093       "name" : "clearTicks",
1094       "type" : "function",
1095       "desc" : "Clears any tick interval defined for this instance",
1096       "sig" : "()\n{\n\n}",
1097       "static" : false,
1098       "memberOf" : "",
1099       "isStatic" : false,
1100       "isConstructor" : false,
1101       "isPrivate" : false,
1102       "example" : "",
1103       "deprecated" : "",
1104       "since" : "",
1105       "see" : "",
1106       "exceptions" : "",
1107       "requires" : "",
1108       "params" : [],
1109       "returns" : []
1110     },
1111     {
1112       "name" : "isLocked",
1113       "type" : "function",
1114       "desc" : "Returns true if this instance is locked, or the drag drop mgr is locked\n(meaning that all drag/drop is disabled on the page.)",
1115       "sig" : "()\n{\n\n}",
1116       "static" : false,
1117       "memberOf" : "",
1118       "isStatic" : false,
1119       "isConstructor" : false,
1120       "isPrivate" : false,
1121       "example" : "",
1122       "deprecated" : "",
1123       "since" : "",
1124       "see" : "",
1125       "exceptions" : "",
1126       "requires" : "",
1127       "params" : [],
1128       "returns" : [
1129         {
1130           "name" : "",
1131           "type" : "boolean",
1132           "desc" : "true if this obj or all drag/drop is locked, else\nfalse"
1133         }
1134       ]
1135     },
1136     {
1137       "name" : "setXConstraint",
1138       "type" : "function",
1139       "desc" : "By default, the element can be dragged any place on the screen.  Use\nthis method to limit the horizontal travel of the element.  Pass in\n0,0 for the parameters if you want to lock the drag to the y axis.",
1140       "sig" : "(iLeft, iRight, iTickSize)",
1141       "static" : false,
1142       "memberOf" : "",
1143       "isStatic" : false,
1144       "isConstructor" : false,
1145       "isPrivate" : false,
1146       "example" : "",
1147       "deprecated" : "",
1148       "since" : "",
1149       "see" : "",
1150       "exceptions" : "",
1151       "requires" : "",
1152       "params" : [
1153         {
1154           "name" : "iLeft",
1155           "type" : "int",
1156           "desc" : "the number of pixels the element can move to the left",
1157           "isOptional" : false
1158         },
1159         {
1160           "name" : "iRight",
1161           "type" : "int",
1162           "desc" : "the number of pixels the element can move to the\nright",
1163           "isOptional" : false
1164         },
1165         {
1166           "name" : "iTickSize",
1167           "type" : "int",
1168           "desc" : "optional parameter for specifying that the\nelement\nshould move iTickSize pixels at a time.",
1169           "isOptional" : false
1170         }
1171       ],
1172       "returns" : []
1173     },
1174     {
1175       "name" : "isValidHandleChild",
1176       "type" : "function",
1177       "desc" : "Checks the tag exclusion list to see if this click should be ignored",
1178       "sig" : "(node)",
1179       "static" : false,
1180       "memberOf" : "",
1181       "isStatic" : false,
1182       "isConstructor" : false,
1183       "isPrivate" : false,
1184       "example" : "",
1185       "deprecated" : "",
1186       "since" : "",
1187       "see" : "",
1188       "exceptions" : "",
1189       "requires" : "",
1190       "params" : [
1191         {
1192           "name" : "node",
1193           "type" : "HTMLElement",
1194           "desc" : "the HTMLElement to evaluate",
1195           "isOptional" : false
1196         }
1197       ],
1198       "returns" : [
1199         {
1200           "name" : "",
1201           "type" : "boolean",
1202           "desc" : "true if this is a valid tag type, false if not"
1203         }
1204       ]
1205     },
1206     {
1207       "name" : "purgeListeners",
1208       "type" : "function",
1209       "desc" : "Removes all listeners for this object",
1210       "sig" : "()\n{\n\n}",
1211       "static" : false,
1212       "memberOf" : "Roo.util.Observable",
1213       "isStatic" : false,
1214       "isConstructor" : false,
1215       "isPrivate" : false,
1216       "example" : "",
1217       "deprecated" : "",
1218       "since" : "",
1219       "see" : "",
1220       "exceptions" : "",
1221       "requires" : "",
1222       "params" : [],
1223       "returns" : []
1224     },
1225     {
1226       "name" : "on",
1227       "type" : "function",
1228       "desc" : "Appends an event handler to this element (shorthand for addListener)",
1229       "sig" : "(eventName, handler, scope, options)",
1230       "static" : false,
1231       "memberOf" : "Roo.util.Observable",
1232       "isStatic" : false,
1233       "isConstructor" : false,
1234       "isPrivate" : false,
1235       "example" : "",
1236       "deprecated" : "",
1237       "since" : "",
1238       "see" : "",
1239       "exceptions" : "",
1240       "requires" : "",
1241       "params" : [
1242         {
1243           "name" : "eventName",
1244           "type" : "String",
1245           "desc" : "The type of event to listen for",
1246           "isOptional" : false
1247         },
1248         {
1249           "name" : "handler",
1250           "type" : "Function",
1251           "desc" : "The method the event invokes",
1252           "isOptional" : false
1253         },
1254         {
1255           "name" : "scope",
1256           "type" : "Object",
1257           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
1258           "isOptional" : false
1259         },
1260         {
1261           "name" : "options",
1262           "type" : "Object",
1263           "desc" : "(optional)",
1264           "isOptional" : false
1265         }
1266       ],
1267       "returns" : []
1268     },
1269     {
1270       "name" : "un",
1271       "type" : "function",
1272       "desc" : "Removes a listener (shorthand for removeListener)",
1273       "sig" : "(eventName, handler, scope)",
1274       "static" : false,
1275       "memberOf" : "Roo.util.Observable",
1276       "isStatic" : false,
1277       "isConstructor" : false,
1278       "isPrivate" : false,
1279       "example" : "",
1280       "deprecated" : "",
1281       "since" : "",
1282       "see" : "",
1283       "exceptions" : "",
1284       "requires" : "",
1285       "params" : [
1286         {
1287           "name" : "eventName",
1288           "type" : "String",
1289           "desc" : "The type of event to listen for",
1290           "isOptional" : false
1291         },
1292         {
1293           "name" : "handler",
1294           "type" : "Function",
1295           "desc" : "The handler to remove",
1296           "isOptional" : false
1297         },
1298         {
1299           "name" : "scope",
1300           "type" : "Object",
1301           "desc" : "(optional) The scope (this object) for the handler",
1302           "isOptional" : false
1303         }
1304       ],
1305       "returns" : []
1306     },
1307     {
1308       "name" : "addEvents",
1309       "type" : "function",
1310       "desc" : "Used to define events on this Observable",
1311       "sig" : "(object)",
1312       "static" : false,
1313       "memberOf" : "Roo.util.Observable",
1314       "isStatic" : false,
1315       "isConstructor" : false,
1316       "isPrivate" : false,
1317       "example" : "",
1318       "deprecated" : "",
1319       "since" : "",
1320       "see" : "",
1321       "exceptions" : "",
1322       "requires" : "",
1323       "params" : [
1324         {
1325           "name" : "object",
1326           "type" : "Object",
1327           "desc" : "The object with the events defined",
1328           "isOptional" : false
1329         }
1330       ],
1331       "returns" : []
1332     },
1333     {
1334       "name" : "releaseCapture",
1335       "type" : "function",
1336       "desc" : "Removes <b>all</b> added captures from the Observable.",
1337       "sig" : "(o)",
1338       "static" : true,
1339       "memberOf" : "Roo.util.Observable",
1340       "isStatic" : true,
1341       "isConstructor" : false,
1342       "isPrivate" : false,
1343       "example" : "",
1344       "deprecated" : "",
1345       "since" : "",
1346       "see" : "",
1347       "exceptions" : "",
1348       "requires" : "",
1349       "params" : [
1350         {
1351           "name" : "o",
1352           "type" : "Observable",
1353           "desc" : "The Observable to release",
1354           "isOptional" : false
1355         }
1356       ],
1357       "returns" : []
1358     },
1359     {
1360       "name" : "removeListener",
1361       "type" : "function",
1362       "desc" : "Removes a listener",
1363       "sig" : "(eventName, handler, scope)",
1364       "static" : false,
1365       "memberOf" : "Roo.util.Observable",
1366       "isStatic" : false,
1367       "isConstructor" : false,
1368       "isPrivate" : false,
1369       "example" : "",
1370       "deprecated" : "",
1371       "since" : "",
1372       "see" : "",
1373       "exceptions" : "",
1374       "requires" : "",
1375       "params" : [
1376         {
1377           "name" : "eventName",
1378           "type" : "String",
1379           "desc" : "The type of event to listen for",
1380           "isOptional" : false
1381         },
1382         {
1383           "name" : "handler",
1384           "type" : "Function",
1385           "desc" : "The handler to remove",
1386           "isOptional" : false
1387         },
1388         {
1389           "name" : "scope",
1390           "type" : "Object",
1391           "desc" : "(optional) The scope (this object) for the handler",
1392           "isOptional" : false
1393         }
1394       ],
1395       "returns" : []
1396     },
1397     {
1398       "name" : "fireEvent",
1399       "type" : "function",
1400       "desc" : "Fires the specified event with the passed parameters (minus the event name).",
1401       "sig" : "(eventName, args)",
1402       "static" : false,
1403       "memberOf" : "Roo.util.Observable",
1404       "isStatic" : false,
1405       "isConstructor" : false,
1406       "isPrivate" : false,
1407       "example" : "",
1408       "deprecated" : "",
1409       "since" : "",
1410       "see" : "",
1411       "exceptions" : "",
1412       "requires" : "",
1413       "params" : [
1414         {
1415           "name" : "eventName",
1416           "type" : "String",
1417           "desc" : "",
1418           "isOptional" : false
1419         },
1420         {
1421           "name" : "args",
1422           "type" : "Object...",
1423           "desc" : "Variable number of parameters are passed to handlers",
1424           "isOptional" : false
1425         }
1426       ],
1427       "returns" : [
1428         {
1429           "name" : "",
1430           "type" : "Boolean",
1431           "desc" : "returns false if any of the handlers return false otherwise it returns true"
1432         }
1433       ]
1434     },
1435     {
1436       "name" : "hasListener",
1437       "type" : "function",
1438       "desc" : "Checks to see if this object has any listeners for a specified event",
1439       "sig" : "(eventName)",
1440       "static" : false,
1441       "memberOf" : "Roo.util.Observable",
1442       "isStatic" : false,
1443       "isConstructor" : false,
1444       "isPrivate" : false,
1445       "example" : "",
1446       "deprecated" : "",
1447       "since" : "",
1448       "see" : "",
1449       "exceptions" : "",
1450       "requires" : "",
1451       "params" : [
1452         {
1453           "name" : "eventName",
1454           "type" : "String",
1455           "desc" : "The name of the event to check for",
1456           "isOptional" : false
1457         }
1458       ],
1459       "returns" : [
1460         {
1461           "name" : "",
1462           "type" : "Boolean",
1463           "desc" : "True if the event is being listened for, else false"
1464         }
1465       ]
1466     },
1467     {
1468       "name" : "capture",
1469       "type" : "function",
1470       "desc" : "Starts capture on the specified Observable. All events will be passed\nto the supplied function with the event name + standard signature of the event\n<b>before</b> the event is fired. If the supplied function returns false,\nthe event will not fire.",
1471       "sig" : "(o, fn, scope)",
1472       "static" : true,
1473       "memberOf" : "Roo.util.Observable",
1474       "isStatic" : true,
1475       "isConstructor" : false,
1476       "isPrivate" : false,
1477       "example" : "",
1478       "deprecated" : "",
1479       "since" : "",
1480       "see" : "",
1481       "exceptions" : "",
1482       "requires" : "",
1483       "params" : [
1484         {
1485           "name" : "o",
1486           "type" : "Observable",
1487           "desc" : "The Observable to capture",
1488           "isOptional" : false
1489         },
1490         {
1491           "name" : "fn",
1492           "type" : "Function",
1493           "desc" : "The function to call",
1494           "isOptional" : false
1495         },
1496         {
1497           "name" : "scope",
1498           "type" : "Object",
1499           "desc" : "(optional) The scope (this object) for the fn",
1500           "isOptional" : false
1501         }
1502       ],
1503       "returns" : []
1504     },
1505     {
1506       "name" : "addListener",
1507       "type" : "function",
1508       "desc" : "Appends an event handler to this component",
1509       "sig" : "(eventName, handler, scope, options)",
1510       "static" : false,
1511       "memberOf" : "Roo.util.Observable",
1512       "isStatic" : false,
1513       "isConstructor" : false,
1514       "isPrivate" : false,
1515       "example" : "",
1516       "deprecated" : "",
1517       "since" : "",
1518       "see" : "",
1519       "exceptions" : "",
1520       "requires" : "",
1521       "params" : [
1522         {
1523           "name" : "eventName",
1524           "type" : "String",
1525           "desc" : "The type of event to listen for",
1526           "isOptional" : false
1527         },
1528         {
1529           "name" : "handler",
1530           "type" : "Function",
1531           "desc" : "The method the event invokes",
1532           "isOptional" : false
1533         },
1534         {
1535           "name" : "scope",
1536           "type" : "Object",
1537           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
1538           "isOptional" : false
1539         },
1540         {
1541           "name" : "options",
1542           "type" : "Object",
1543           "desc" : "(optional) An object containing handler configuration\nproperties. This may contain any of the following properties:<ul>\n<li>scope {Object} The scope in which to execute the handler function. The handler function's \"this\" context.</li>\n<li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li>\n<li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li>\n<li>buffer {Number} Causes the handler to be scheduled to run in an {@link Roo.util.DelayedTask} delayed\nby the specified number of milliseconds. If the event fires again within that time, the original\nhandler is <em>not</em> invoked, but the new handler is scheduled in its place.</li>\n</ul><br>\n<p>\n<b>Combining Options</b><br>\nUsing the options argument, it is possible to combine different types of listeners:<br>\n<br>\nA normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)\n\t\t<pre><code>\n\t\tel.on('click', this.onClick, this, {\n \t\t\tsingle: true,\n    \t\tdelay: 100,\n    \t\tforumId: 4\n\t\t});\n\t\t</code></pre>\n<p>\n<b>Attaching multiple handlers in 1 call</b><br>\nThe method also allows for a single argument to be passed which is a config object containing properties\nwhich specify multiple handlers.\n<pre><code>\n\t\tel.on({\n\t\t\t'click': {\n        \t\tfn: this.onClick,\n        \t\tscope: this,\n        \t\tdelay: 100\n    \t\t}, \n    \t\t'mouseover': {\n        \t\tfn: this.onMouseOver,\n        \t\tscope: this\n    \t\t},\n    \t\t'mouseout': {\n        \t\tfn: this.onMouseOut,\n        \t\tscope: this\n    \t\t}\n\t\t});\n\t\t</code></pre>\n<p>\nOr a shorthand syntax which passes the same scope object to all handlers:\n     \t<pre><code>\n\t\tel.on({\n\t\t\t'click': this.onClick,\n    \t\t'mouseover': this.onMouseOver,\n    \t\t'mouseout': this.onMouseOut,\n    \t\tscope: this\n\t\t});\n\t\t</code></pre>",
1544           "isOptional" : false
1545         }
1546       ],
1547       "returns" : []
1548     }
1549   ],
1550   "events" : []
1551 }