| autoStart : Boolean/NumberDefaults to false. Specify true to defer trigger start by 1000 ms.
-Specify a Number for the number of milliseconds t... Defaults to false. Specify true to defer trigger start by 1000 ms.
+ A DragTracker listens for drag events on an Element and fires events at the start and end of the drag,
+as well as during the drag. This is useful for components such as Ext.Slider, where there is
+an element that can be dragged around to change the Slider's value.
+DragTracker provides a series of template methods that should be overridden to provide functionality
+in response to detected drag operations. These are onBeforeStart, onStart, onDrag and onEnd.
+See Ext.Slider's initEvents function for an example implementation. Config Options|
| active : Boolean Defaults to false. | DragTracker | | autoStart : Boolean/NumberDefaults to false. Specify true to defer trigger start by 1000 ms.
+Specify a Number for the number of milliseconds to... Defaults to false. Specify true to defer trigger start by 1000 ms.
Specify a Number for the number of milliseconds to defer trigger start. | DragTracker | | listeners : ObjectA config object containing one or more event handlers to be added to this
object during initialization. This should ... A config object containing one or more event handlers to be added to this
object during initialization. This should be a valid listeners config object as specified in the
@@ -55,9 +60,11 @@ Ext.DomObserver = Ext.extend(Object, {
typeAhead: true,
mode: 'local',
triggerAction: 'all'
-}); | Observable | | tolerance : Number Defaults to 5. | DragTracker |
Public PropertiesThis class has no public properties. Public Methods|
| addEvents( Object object )
+}); | Observable | | tolerance : Number Number of pixels the drag target must be moved before dragging is considered to have started. Defaults to 5. | DragTracker |
Public PropertiesThis class has no public properties. Public Methods|
| addEvents( Object|String o , string Optional. )
:
- voidUsed to define events on this Observable Used to define events on this Observable | Observable | | addListener( String eventName , Function handler , [Object scope ], [Object options ] )
+ voidAdds the specified events to the list of events which this Observable may fire. Adds the specified events to the list of events which this Observable may fire. | Observable | | addListener( String eventName , Function handler , [Object scope ], [Object options ] )
:
voidAppends an event handler to this object. Appends an event handler to this object. Parameters:eventName : StringThe name of the event to listen for. handler : FunctionThe method the event invokes. scope : Object(optional) The scope (this reference) in which the handler function is executed.
If omitted, defaults to the object which fired the event. options : Object(optional) An object containing handler configuration.
@@ -78,8 +85,8 @@ Using the options argument, it is possible to combine different types of listene
A delayed, one-time listener.
myDataView.on('click', this.onClick, this, {
- single: true,
- delay: 100
+single: true,
+delay: 100
});
Attaching multiple handlers in 1 call
@@ -87,40 +94,87 @@ The method also allows for a single argument to be passed which is a config obje
which specify multiple handlers.
myGridPanel.on({
- 'click' : {
- fn: this.onClick,
- scope: this,
- delay: 100
- },
- 'mouseover' : {
- fn: this.onMouseOver,
- scope: this
- },
- 'mouseout' : {
- fn: this.onMouseOut,
- scope: this
- }
+'click' : {
+ fn: this.onClick,
+ scope: this,
+ delay: 100
+},
+'mouseover' : {
+ fn: this.onMouseOver,
+ scope: this
+},
+'mouseout' : {
+ fn: this.onMouseOut,
+ scope: this
+}
});
Or a shorthand syntax:
myGridPanel.on({
- 'click' : this.onClick,
- 'mouseover' : this.onMouseOver,
- 'mouseout' : this.onMouseOut,
- scope: this
-});
Returns: | Observable | | enableBubble( Object events )
+'click' : this.onClick,
+'mouseover' : this.onMouseOver,
+'mouseout' : this.onMouseOut,
+ scope: this
+});Returns: | Observable | | enableBubble( String/Array events )
:
- voidUsed to enable bubbling of events Used to enable bubbling of events | Observable | | fireEvent( String eventName , Object... args )
+ voidEnables events fired by this Observable to bubble up an owner hierarchy by calling
+this.getBubbleTarget() if present.... Enables events fired by this Observable to bubble up an owner hierarchy by calling
+this.getBubbleTarget() if present. There is no implementation in the Observable base class.
+ This is commonly used by Ext.Components to bubble events to owner Containers. See Ext.Component.getBubbleTarget. The default
+implementation in Ext.Component returns the Component's immediate owner. But if a known target is required, this can be overridden to
+access the required target more quickly.
+ Example: Ext.override(Ext.form.Field, {
+ // Add functionality to Field's initComponent to enable the change event to bubble
+ initComponent : Ext.form.Field.prototype.initComponent.createSequence(function() {
+ this.enableBubble('change');
+ }),
+
+ // We know that we want Field's events to bubble directly to the FormPanel.
+ getBubbleTarget : function() {
+ if (!this.formPanel) {
+ this.formPanel = this.findParentByType('form');
+ }
+ return this.formPanel;
+ }
+});
+
+var myForm = new Ext.formPanel({
+ title: 'User Details',
+ items: [{
+ ...
+ }],
+ listeners: {
+ change: function() {
+ // Title goes red if form has been modified.
+ myForm.header.setStyle('color', 'red');
+ }
+ }
+});
| Observable | | fireEvent( String eventName , Object... args )
:
BooleanFires the specified event with the passed parameters (minus the event name).
An event may be set to bubble up an Obse... | Observable | | hasListener( String eventName )
+by calling enableBubble. | Observable | | getDragTarget()
+ :
+ Ext.Element | DragTracker | | hasListener( String eventName )
:
BooleanChecks to see if this object has any listeners for a specified event Checks to see if this object has any listeners for a specified event | Observable | | on( String eventName , Function handler , [Object scope ], [Object options ] )
:
voidAppends an event handler to this object (shorthand for addListener.) Appends an event handler to this object (shorthand for addListener.) Parameters:eventName : StringThe type of event to listen for handler : FunctionThe method the event invokes scope : Object(optional) The scope (this reference) in which the handler function is executed.
-If omitted, defaults to the object which fired the event. options : Object(optional) An object containing handler configuration. Returns: | Observable | | purgeListeners()
+If omitted, defaults to the object which fired the event.options : Object(optional) An object containing handler configuration. Returns: | Observable | | onBeforeStart( Ext.EventObject e )
+ :
+ voidTemplate method which should be overridden by each DragTracker instance. Called when the user first clicks and
+holds ... Template method which should be overridden by each DragTracker instance. Called when the user first clicks and
+holds the mouse button down. Return false to disallow the drag Parameters:e : Ext.EventObjectThe event object Returns: | DragTracker | | onDrag( Ext.EventObject e )
+ :
+ voidTemplate method which should be overridden by each DragTracker instance. Called whenever a drag has been detected. Template method which should be overridden by each DragTracker instance. Called whenever a drag has been detected. Parameters:e : Ext.EventObjectThe event object Returns: | DragTracker | | onEnd( Ext.EventObject e )
+ :
+ voidTemplate method which should be overridden by each DragTracker instance. Called when a drag operation has been comple... Template method which should be overridden by each DragTracker instance. Called when a drag operation has been completed
+(e.g. the user clicked and held the mouse down, dragged the element and then released the mouse button) Parameters:e : Ext.EventObjectThe event object Returns: | DragTracker | | onStart( Array xy )
+ :
+ voidTemplate method which should be overridden by each DragTracker instance. Called when a drag operation starts
+(e.g. th... Template method which should be overridden by each DragTracker instance. Called when a drag operation starts
+(e.g. the user has moved the tracked element beyond the specified tolerance) | DragTracker | | purgeListeners()
:
voidRemoves all listeners for this object Removes all listeners for this object | Observable | | relayEvents( Object o , Array events )
:
|
|