Packagefeathers.controls
Classpublic class ScrollBar
InheritanceScrollBar Inheritance FeathersControl Inheritance Sprite Inheritance DisplayObjectContainer Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Implements IScrollBar

Select a value between a minimum and a maximum by dragging a thumb over a physical range or by using step buttons. This is a desktop-centric scroll bar with many skinnable parts. For mobile, the SimpleScrollBar is probably a better choice as it provides only the thumb to indicate position without all the extra chrome.

See also

http://wiki.starling-framework.org/feathers/scroll-bar
SimpleScrollBar


Public Properties
 PropertyDefined By
 Inheritedalpha : Number
The opacity of the object.
DisplayObject
 Inheritedbase : DisplayObject
[read-only] The topmost object in the display tree the object is part of.
DisplayObject
 InheritedblendMode : String
The blend mode determines how the object is blended with the objects underneath.
DisplayObject
 Inheritedbounds : Rectangle
[read-only] The bounds of the object relative to the local coordinates of the parent.
DisplayObject
 InheritedclipRect : Rectangle
[override]
FeathersControl
  customDecrementButtonName : String
A name to add to the scroll bar's decrement button sub-component.
ScrollBar
  customIncrementButtonName : String
A name to add to the scroll bar's increment button sub-component.
ScrollBar
  customMaximumTrackName : String
A name to add to the scroll bar's maximum track sub-component.
ScrollBar
  customMinimumTrackName : String
A name to add to the scroll bar's minimum track sub-component.
ScrollBar
  customThumbName : String
A name to add to the scroll bar's thumb sub-component.
ScrollBar
  decrementButtonFactory : Function
A function used to generate the scroll bar's decrement button sub-component.
ScrollBar
  decrementButtonProperties : Object
A set of key/value pairs to be passed down to the scroll bar's decrement button sub-component.
ScrollBar
 InheriteddefaultTextEditorFactory : Function
[static] A function used by all UI controls that support text editor to create an ITextEditor instance.
FeathersControl
 InheriteddefaultTextRendererFactory : Function
[static] A function used by all UI controls that support text renderers to create an ITextRenderer instance.
FeathersControl
  direction : String
Determines if the scroll bar's thumb can be dragged horizontally or vertically.
ScrollBar
 Inheritedfilter : FragmentFilter
The filter that is attached to the display object.
DisplayObject
 InheritedfocusManager : IFocusManager
The current focus manager for this component.
FeathersControl
 InheritedhasVisibleArea : Boolean
[read-only] Indicates if an object occupies any visible area.
DisplayObject
 Inheritedheight : Number
[override] The height of the component, in pixels.
FeathersControl
 InheritedincludeInLayout : Boolean
Determines if the ILayout should use this object or ignore it.
FeathersControl
  incrementButtonFactory : Function
A function used to generate the scroll bar's increment button sub-component.
ScrollBar
  incrementButtonProperties : Object
A set of key/value pairs to be passed down to the scroll bar's increment button sub-component.
ScrollBar
 InheritedisEnabled : Boolean
Indicates whether the control is interactive or not.
FeathersControl
 InheritedisFlattened : Boolean
[read-only] Indicates if the sprite was flattened.
Sprite
 InheritedisFocusEnabled : Boolean
Determines if this component can receive focus.
FeathersControl
 InheritedisInitialized : Boolean
[read-only] Determines if the component has been initialized yet.
FeathersControl
 InheritedisQuickHitAreaEnabled : Boolean
Similar to mouseChildren on the classic display list.
FeathersControl
 InheritedlayoutData : ILayoutData
Extra parameters associated with this display object that will be used by the layout algorithm.
FeathersControl
  liveDragging : Boolean = true
Determines if the scroll bar dispatches the Event.CHANGE event every time the thumb moves, or only once it stops moving.
ScrollBar
 InheritedmaxHeight : Number
The maximum recommended height to be used for self-measurement and, optionally, by any code that is resizing this component.
FeathersControl
  maximum : Number
The maximum value of the scroll bar.
ScrollBar
  maximumTrackFactory : Function
A function used to generate the scroll bar's maximum track sub-component.
ScrollBar
  maximumTrackProperties : Object
A set of key/value pairs to be passed down to the scroll bar's maximum track sub-component.
ScrollBar
 InheritedmaxWidth : Number
The maximum recommended width to be used for self-measurement and, optionally, by any code that is resizing this component.
FeathersControl
 InheritedminHeight : Number
The minimum recommended height to be used for self-measurement and, optionally, by any code that is resizing this component.
FeathersControl
  minimum : Number
The minimum value of the scroll bar.
ScrollBar
  minimumTrackFactory : Function
A function used to generate the scroll bar's minimum track sub-component.
ScrollBar
  minimumTrackProperties : Object
A set of key/value pairs to be passed down to the scroll bar's minimum track sub-component.
ScrollBar
 InheritedminTouchHeight : Number
If using isQuickHitAreaEnabled, and the hit area's height is smaller than this value, it will be expanded.
FeathersControl
 InheritedminTouchWidth : Number
If using isQuickHitAreaEnabled, and the hit area's width is smaller than this value, it will be expanded.
FeathersControl
 InheritedminWidth : Number
The minimum recommended width to be used for self-measurement and, optionally, by any code that is resizing this component.
FeathersControl
 Inheritedname : String
[override] The concatenated nameList, with each name separated by spaces.
FeathersControl
 InheritednameList : TokenList
[read-only] Contains a list of all "names" assigned to this control.
FeathersControl
 InheritednextTabFocus : IFocusDisplayObject
The next object that will receive focus when the tab key is pressed.
FeathersControl
 InheritednumChildren : int
[read-only] The number of children of this container.
DisplayObjectContainer
  padding : Number
Quickly sets all padding properties to the same value.
ScrollBar
  paddingBottom : Number
The minimum space, in pixels, below the content, not including the track(s).
ScrollBar
  paddingLeft : Number
The minimum space, in pixels, to the left of the content, not including the track(s).
ScrollBar
  paddingRight : Number
The minimum space, in pixels, to the right of the content, not including the track(s).
ScrollBar
  paddingTop : Number
The minimum space, in pixels, above the content, not including the track(s).
ScrollBar
  page : Number
The amount the scroll bar value must change to get from one "page" to the next.
ScrollBar
 Inheritedparent : DisplayObjectContainer
[read-only] The display object container that contains this display object.
DisplayObject
 InheritedpivotX : Number
The x coordinate of the object's origin in its own coordinate space (default: 0).
DisplayObject
 InheritedpivotY : Number
The y coordinate of the object's origin in its own coordinate space (default: 0).
DisplayObject
  repeatDelay : Number
The time, in seconds, before actions are repeated.
ScrollBar
 Inheritedroot : DisplayObject
[read-only] The root object the display object is connected to (i.e.
DisplayObject
 Inheritedrotation : Number
The rotation of the object in radians.
DisplayObject
 InheritedscaleX : Number
The horizontal scale factor.
DisplayObject
 InheritedscaleY : Number
The vertical scale factor.
DisplayObject
 InheritedskewX : Number
The horizontal skew angle in radians.
DisplayObject
 InheritedskewY : Number
The vertical skew angle in radians.
DisplayObject
 Inheritedstage : Stage
[read-only] The stage the display object is connected to, or null if it is not connected to the stage.
DisplayObject
  step : Number
The amount the scroll bar value must change to increment or decrement.
ScrollBar
  thumbFactory : Function
A function used to generate the scroll bar's thumb sub-component.
ScrollBar
  thumbProperties : Object
A set of key/value pairs to be passed down to the scroll bar's thumb sub-component.
ScrollBar
 Inheritedtouchable : Boolean
Indicates if this object (and its children) will receive touch events.
DisplayObject
  trackLayoutMode : String
Determines how the minimum and maximum track skins are positioned and sized.
ScrollBar
 InheritedtransformationMatrix : Matrix
The transformation matrix of the object relative to its parent.
DisplayObject
 InheriteduseHandCursor : Boolean
Indicates if the mouse cursor should transform into a hand while it's over the sprite.
DisplayObject
  value : Number
The current value of the scroll bar.
ScrollBar
 Inheritedvisible : Boolean
The visibility of the object.
DisplayObject
 Inheritedwidth : Number
[override] The width of the component, in pixels.
FeathersControl
 Inheritedx : Number
The x coordinate of the object relative to the local coordinates of the parent.
DisplayObject
 Inheritedy : Number
The y coordinate of the object relative to the local coordinates of the parent.
DisplayObject
Protected Properties
 PropertyDefined By
 InheritedactualHeight : Number = 0
The final height value that should be used for layout.
FeathersControl
 InheritedactualWidth : Number = 0
The final width value that should be used for layout.
FeathersControl
  decrementButton : Button
The scroll bar's decrement button sub-component.
ScrollBar
  decrementButtonName : String = feathers-scroll-bar-decrement-button
The value added to the nameList of the decrement button.
ScrollBar
 InheritedexplicitHeight : Number = NaN
The height value explicitly set by calling the height setter or setSize().
FeathersControl
 InheritedexplicitWidth : Number = NaN
The width value explicitly set by calling the width setter or setSize().
FeathersControl
  incrementButton : Button
The scroll bar's increment button sub-component.
ScrollBar
  incrementButtonName : String = feathers-scroll-bar-increment-button
The value added to the nameList of the increment button.
ScrollBar
  maximumTrack : Button
The scroll bar's maximum track sub-component.
ScrollBar
  maximumTrackName : String = feathers-scroll-bar-maximum-track
The value added to the nameList of the maximum track.
ScrollBar
  minimumTrack : Button
The scroll bar's minimum track sub-component.
ScrollBar
  minimumTrackName : String = feathers-scroll-bar-minimum-track
The value added to the nameList of the minimum track.
ScrollBar
  thumb : Button
The scroll bar's thumb sub-component.
ScrollBar
  thumbName : String = feathers-scroll-bar-thumb
The value added to the nameList of the thumb.
ScrollBar
Public Methods
 MethodDefined By
  
Constructor.
ScrollBar
 Inherited
Adds a child to the container.
DisplayObjectContainer
 Inherited
Adds a child to the container at a certain index.
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function):void
[override]
DisplayObject
 Inherited
alignPivot(hAlign:String = center, vAlign:String = center):void
Moves the pivot point to a certain position within the local coordinate system of the object.
DisplayObject
 Inherited
broadcastEvent(event:Event):void
Dispatches an event on all children (recursively).
DisplayObjectContainer
 Inherited
broadcastEventWith(type:String, data:Object = null):void
Dispatches an event with the given parameters on all children (recursively).
DisplayObjectContainer
 Inherited
contains(child:DisplayObject):Boolean
Determines if a certain object is a child of the container (recursively).
DisplayObjectContainer
 Inherited
dispatchEvent(event:Event):void
Dispatches an event to all objects that have registered listeners for its type.
EventDispatcher
 Inherited
dispatchEventWith(type:String, bubbles:Boolean = false, data:Object = null):void
Dispatches an event with the given parameters to all objects that have registered listeners for the given type.
EventDispatcher
 Inherited
dispose():void
[override] Disposes the resources of all children.
Sprite
 Inherited
flatten():void
Optimizes the sprite for optimal rendering performance.
Sprite
 Inherited
getBounds(targetSpace:DisplayObject, resultRect:Rectangle = null):Rectangle
[override] Returns a rectangle that completely encloses the object as it appears in another coordinate system.
Sprite
 Inherited
Returns a child object at a certain index.
DisplayObjectContainer
 Inherited
Returns a child object with a certain name (non-recursively).
DisplayObjectContainer
 Inherited
Returns the index of a child within the container, or "-1" if it is not found.
DisplayObjectContainer
 Inherited
getClipRect(targetSpace:DisplayObject, resultRect:Rectangle = null):Rectangle
Returns the bounds of the container's clipRect in the given coordinate space, or null if the sprite doens't have a clipRect.
Sprite
 Inherited
getTransformationMatrix(targetSpace:DisplayObject, resultMatrix:Matrix = null):Matrix
Creates a matrix that represents the transformation from the local coordinate system to another.
DisplayObject
 Inherited
globalToLocal(globalPoint:Point, resultPoint:Point = null):Point
Transforms a point from global (stage) coordinates to the local coordinate system.
DisplayObject
 Inherited
hasEventListener(type:String):Boolean
Returns if there are listeners registered for a certain event type.
EventDispatcher
 Inherited
hitTest(localPoint:Point, forTouch:Boolean = false):DisplayObject
[override] Returns the object that is found topmost beneath a point in local coordinates, or nil if the test fails.
Sprite
 Inherited
invalidate(flag:String):void
Call this function to tell the UI control that a redraw is pending.
FeathersControl
 Inherited
isInvalid(flag:String = null):Boolean
Indicates whether the control is pending validation or not.
FeathersControl
 Inherited
localToGlobal(localPoint:Point, resultPoint:Point = null):Point
Transforms a point from the local coordinate system to global (stage) coordinates.
DisplayObject
 Inherited
removeChild(child:DisplayObject, dispose:Boolean = false):DisplayObject
Removes a child from the container.
DisplayObjectContainer
 Inherited
removeChildAt(index:int, dispose:Boolean = false):DisplayObject
Removes a child at a certain index.
DisplayObjectContainer
 Inherited
removeChildren(beginIndex:int = 0, endIndex:int = -1, dispose:Boolean = false):void
Removes a range of children from the container (endIndex included).
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function):void
[override]
DisplayObject
 Inherited
removeEventListeners(type:String = null):void
[override]
DisplayObject
 Inherited
removeFromParent(dispose:Boolean = false):void
Removes the object from its parent, if it has one, and optionally disposes it.
DisplayObject
 Inherited
render(support:RenderSupport, parentAlpha:Number):void
[override] Renders the display object with the help of a support object.
Sprite
 Inherited
setChildIndex(child:DisplayObject, index:int):void
Moves a child to a certain index.
DisplayObjectContainer
 Inherited
setSize(width:Number, height:Number):void
Sets both the width and the height of the control.
FeathersControl
 Inherited
sortChildren(compareFunction:Function):void
Sorts the children according to a given function (that works just like the sort function of the Vector class).
DisplayObjectContainer
 Inherited
Swaps the indexes of two children.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Swaps the indexes of two children.
DisplayObjectContainer
 Inherited
unflatten():void
Removes the rendering optimizations that were created when flattening the sprite.
Sprite
 Inherited
validate():void
Immediately validates the control, which triggers a redraw, if one is pending.
FeathersControl
Protected Methods
 MethodDefined By
 Inherited
draw():void
Override to customize layout and to adjust properties of children.
FeathersControl
 Inherited
initialize():void
Called the first time that the UI control is added to the stage, and you should override this function to customize the initialization process.
FeathersControl
 Inherited
setSizeInternal(width:Number, height:Number, canInvalidate:Boolean):Boolean
Sets the width and height of the control, with the option of invalidating or not.
FeathersControl
Events
 Event Summary Defined By
 InheritedDispatched when an object is added to a parent.DisplayObject
 InheritedDispatched when an object is connected to the stage (directly or indirectly).DisplayObject
  Dispatched when the user starts interacting with the scroll bar's thumb, track, or buttons.ScrollBar
  Dispatched when the scroll bar's value changes.ScrollBar
  Dispatched when the user stops interacting with the scroll bar's thumb, track, or buttons.ScrollBar
 InheritedDispatched once every frame on every object that is connected to the stage.DisplayObject
 InheritedDispatched on all children when the object is flattened.Sprite
 InheritedDispatched after initialize() has been called, but before the first time that draw() has been called.FeathersControl
 InheritedDispatched when a key on the keyboard is pressed.DisplayObject
 InheritedDispatched when a key on the keyboard is released.DisplayObject
 InheritedDispatched when an object is removed from its parent.DisplayObject
 InheritedDispatched when an object is removed from the stage and won't be rendered any longer.DisplayObject
 InheritedDispatched when the width or height of the control changes.FeathersControl
 InheritedDispatched when an object is touched.DisplayObject
Public Constants
 ConstantDefined By
  DEFAULT_CHILD_NAME_DECREMENT_BUTTON : String = feathers-scroll-bar-decrement-button
[static] The default value added to the nameList of the decrement button.
ScrollBar
  DEFAULT_CHILD_NAME_INCREMENT_BUTTON : String = feathers-scroll-bar-increment-button
[static] The default value added to the nameList of the increment button.
ScrollBar
  DEFAULT_CHILD_NAME_MAXIMUM_TRACK : String = feathers-scroll-bar-maximum-track
[static] The default value added to the nameList of the maximum track.
ScrollBar
  DEFAULT_CHILD_NAME_MINIMUM_TRACK : String = feathers-scroll-bar-minimum-track
[static] The default value added to the nameList of the minimum track.
ScrollBar
  DEFAULT_CHILD_NAME_THUMB : String = feathers-scroll-bar-thumb
[static] The default value added to the nameList of the thumb.
ScrollBar
  DIRECTION_HORIZONTAL : String = horizontal
[static] The scroll bar's thumb may be dragged horizontally (on the x-axis).
ScrollBar
  DIRECTION_VERTICAL : String = vertical
[static] The scroll bar's thumb may be dragged vertically (on the y-axis).
ScrollBar
 InheritedINVALIDATION_FLAG_ALL : String = all
[static] Flag to indicate that everything is invalid and should be redrawn.
FeathersControl
 InheritedINVALIDATION_FLAG_DATA : String = data
[static] Invalidation flag to indicate that the primary data displayed by the UI control has changed.
FeathersControl
 InheritedINVALIDATION_FLAG_LAYOUT : String = layout
[static] Invalidation flag to indicate that the layout of the UI control has changed.
FeathersControl
 InheritedINVALIDATION_FLAG_SCROLL : String = scroll
[static] Invalidation flag to indicate that the scroll position of the UI control has changed.
FeathersControl
 InheritedINVALIDATION_FLAG_SELECTED : String = selected
[static] Invalidation flag to indicate that the selection of the UI control has changed.
FeathersControl
 InheritedINVALIDATION_FLAG_SIZE : String = size
[static] Invalidation flag to indicate that the dimensions of the UI control have changed.
FeathersControl
 InheritedINVALIDATION_FLAG_SKIN : String = skin
[static] Invalidation flag to indicate that the skin of the UI control has changed.
FeathersControl
 InheritedINVALIDATION_FLAG_STATE : String = state
[static] Invalidation flag to indicate that the state has changed.
FeathersControl
 InheritedINVALIDATION_FLAG_STYLES : String = styles
[static] Invalidation flag to indicate that the styles or visual appearance of the UI control has changed.
FeathersControl
  TRACK_LAYOUT_MODE_MIN_MAX : String = minMax
[static] The scroll bar has two tracks, stretching to fill each side of the scroll bar with the thumb in the middle.
ScrollBar
  TRACK_LAYOUT_MODE_SINGLE : String = single
[static] The scroll bar has only one track, that fills the full length of the scroll bar.
ScrollBar
Property Detail
customDecrementButtonNameproperty
customDecrementButtonName:String

A name to add to the scroll bar's decrement button sub-component. Typically used by a theme to provide different skins to different scroll bars.


Implementation
    public function get customDecrementButtonName():String
    public function set customDecrementButtonName(value:String):void

See also

customIncrementButtonNameproperty 
customIncrementButtonName:String

A name to add to the scroll bar's increment button sub-component. Typically used by a theme to provide different skins to different scroll bars.


Implementation
    public function get customIncrementButtonName():String
    public function set customIncrementButtonName(value:String):void

See also

customMaximumTrackNameproperty 
customMaximumTrackName:String

A name to add to the scroll bar's maximum track sub-component. Typically used by a theme to provide different skins to different scroll bars.


Implementation
    public function get customMaximumTrackName():String
    public function set customMaximumTrackName(value:String):void

See also

customMinimumTrackNameproperty 
customMinimumTrackName:String

A name to add to the scroll bar's minimum track sub-component. Typically used by a theme to provide different skins to different scroll bars.


Implementation
    public function get customMinimumTrackName():String
    public function set customMinimumTrackName(value:String):void

See also

customThumbNameproperty 
customThumbName:String

A name to add to the scroll bar's thumb sub-component. Typically used by a theme to provide different skins to different scroll bars.


Implementation
    public function get customThumbName():String
    public function set customThumbName(value:String):void

See also

decrementButtonproperty 
protected var decrementButton:Button

The scroll bar's decrement button sub-component.

decrementButtonFactoryproperty 
decrementButtonFactory:Function

A function used to generate the scroll bar's decrement button sub-component. This can be used to change properties on the decrement button when it is first created. For instance, if you are skinning Feathers components without a theme, you might use decrementButtonFactory to set skins and other styles on the maximum track.

The function should have the following signature:

function():Button


Implementation
    public function get decrementButtonFactory():Function
    public function set decrementButtonFactory(value:Function):void

See also

decrementButtonNameproperty 
protected var decrementButtonName:String = feathers-scroll-bar-decrement-button

The value added to the nameList of the decrement button.

decrementButtonPropertiesproperty 
decrementButtonProperties:Object

A set of key/value pairs to be passed down to the scroll bar's decrement button sub-component. The decrement button is a feathers.controls.Button instance.

If the subcomponent has its own subcomponents, their properties can be set too, using attribute @ notation. For example, to set the skin on the thumb of a SimpleScrollBar which is in a Scroller which is in a List, you can use the following syntax:

list.scrollerProperties.@verticalScrollBarProperties.@thumbProperties.defaultSkin = new Image(texture);


Implementation
    public function get decrementButtonProperties():Object
    public function set decrementButtonProperties(value:Object):void

See also

directionproperty 
direction:String

Determines if the scroll bar's thumb can be dragged horizontally or vertically. When this value changes, the scroll bar's width and height values do not change automatically.

The default value is DIRECTION_HORIZONTAL.


Implementation
    public function get direction():String
    public function set direction(value:String):void

See also

incrementButtonproperty 
protected var incrementButton:Button

The scroll bar's increment button sub-component.

incrementButtonFactoryproperty 
incrementButtonFactory:Function

A function used to generate the scroll bar's increment button sub-component. This can be used to change properties on the increment button when it is first created. For instance, if you are skinning Feathers components without a theme, you might use incrementButtonFactory to set skins and other styles on the maximum track.

The function should have the following signature:

function():Button


Implementation
    public function get incrementButtonFactory():Function
    public function set incrementButtonFactory(value:Function):void

See also

incrementButtonNameproperty 
protected var incrementButtonName:String = feathers-scroll-bar-increment-button

The value added to the nameList of the increment button.

incrementButtonPropertiesproperty 
incrementButtonProperties:Object

A set of key/value pairs to be passed down to the scroll bar's increment button sub-component. The increment button is a feathers.controls.Button instance.

If the subcomponent has its own subcomponents, their properties can be set too, using attribute @ notation. For example, to set the skin on the thumb of a SimpleScrollBar which is in a Scroller which is in a List, you can use the following syntax:

list.scrollerProperties.@verticalScrollBarProperties.@thumbProperties.defaultSkin = new Image(texture);


Implementation
    public function get incrementButtonProperties():Object
    public function set incrementButtonProperties(value:Object):void

See also

liveDraggingproperty 
public var liveDragging:Boolean = true

Determines if the scroll bar dispatches the Event.CHANGE event every time the thumb moves, or only once it stops moving.

maximumproperty 
maximum:Number

The maximum value of the scroll bar.


Implementation
    public function get maximum():Number
    public function set maximum(value:Number):void
maximumTrackproperty 
protected var maximumTrack:Button

The scroll bar's maximum track sub-component.

maximumTrackFactoryproperty 
maximumTrackFactory:Function

A function used to generate the scroll bar's maximum track sub-component. This can be used to change properties on the maximum track when it is first created. For instance, if you are skinning Feathers components without a theme, you might use maximumTrackFactory to set skins and other styles on the maximum track.

The function should have the following signature:

function():Button


Implementation
    public function get maximumTrackFactory():Function
    public function set maximumTrackFactory(value:Function):void

See also

maximumTrackNameproperty 
protected var maximumTrackName:String = feathers-scroll-bar-maximum-track

The value added to the nameList of the maximum track.

maximumTrackPropertiesproperty 
maximumTrackProperties:Object

A set of key/value pairs to be passed down to the scroll bar's maximum track sub-component. The maximum track is a feathers.controls.Button instance.

If the subcomponent has its own subcomponents, their properties can be set too, using attribute @ notation. For example, to set the skin on the thumb of a SimpleScrollBar which is in a Scroller which is in a List, you can use the following syntax:

list.scrollerProperties.@verticalScrollBarProperties.@thumbProperties.defaultSkin = new Image(texture);


Implementation
    public function get maximumTrackProperties():Object
    public function set maximumTrackProperties(value:Object):void

See also

minimumproperty 
minimum:Number

The minimum value of the scroll bar.


Implementation
    public function get minimum():Number
    public function set minimum(value:Number):void
minimumTrackproperty 
protected var minimumTrack:Button

The scroll bar's minimum track sub-component.

minimumTrackFactoryproperty 
minimumTrackFactory:Function

A function used to generate the scroll bar's minimum track sub-component. This can be used to change properties on the minimum track when it is first created. For instance, if you are skinning Feathers components without a theme, you might use minimumTrackFactory to set skins and other styles on the minimum track.

The function should have the following signature:

function():Button


Implementation
    public function get minimumTrackFactory():Function
    public function set minimumTrackFactory(value:Function):void

See also

minimumTrackNameproperty 
protected var minimumTrackName:String = feathers-scroll-bar-minimum-track

The value added to the nameList of the minimum track.

minimumTrackPropertiesproperty 
minimumTrackProperties:Object

A set of key/value pairs to be passed down to the scroll bar's minimum track sub-component. The minimum track is a feathers.controls.Button instance.

If the subcomponent has its own subcomponents, their properties can be set too, using attribute @ notation. For example, to set the skin on the thumb of a SimpleScrollBar which is in a Scroller which is in a List, you can use the following syntax:

list.scrollerProperties.@verticalScrollBarProperties.@thumbProperties.defaultSkin = new Image(texture);


Implementation
    public function get minimumTrackProperties():Object
    public function set minimumTrackProperties(value:Object):void

See also

paddingproperty 
padding:Number

Quickly sets all padding properties to the same value. The padding getter always returns the value of paddingTop, but the other padding values may be different.


Implementation
    public function get padding():Number
    public function set padding(value:Number):void
paddingBottomproperty 
paddingBottom:Number

The minimum space, in pixels, below the content, not including the track(s).


Implementation
    public function get paddingBottom():Number
    public function set paddingBottom(value:Number):void
paddingLeftproperty 
paddingLeft:Number

The minimum space, in pixels, to the left of the content, not including the track(s).


Implementation
    public function get paddingLeft():Number
    public function set paddingLeft(value:Number):void
paddingRightproperty 
paddingRight:Number

The minimum space, in pixels, to the right of the content, not including the track(s).


Implementation
    public function get paddingRight():Number
    public function set paddingRight(value:Number):void
paddingTopproperty 
paddingTop:Number

The minimum space, in pixels, above the content, not including the track(s).


Implementation
    public function get paddingTop():Number
    public function set paddingTop(value:Number):void
pageproperty 
page:Number

The amount the scroll bar value must change to get from one "page" to the next.


Implementation
    public function get page():Number
    public function set page(value:Number):void
repeatDelayproperty 
repeatDelay:Number

The time, in seconds, before actions are repeated. The first repeat happens after a delay that is five times longer than the following repeats.


Implementation
    public function get repeatDelay():Number
    public function set repeatDelay(value:Number):void
stepproperty 
step:Number

The amount the scroll bar value must change to increment or decrement.


Implementation
    public function get step():Number
    public function set step(value:Number):void
thumbproperty 
protected var thumb:Button

The scroll bar's thumb sub-component.

thumbFactoryproperty 
thumbFactory:Function

A function used to generate the scroll bar's thumb sub-component. This can be used to change properties on the thumb when it is first created. For instance, if you are skinning Feathers components without a theme, you might use thumbFactory to set skins and text styles on the thumb.

The function should have the following signature:

function():Button


Implementation
    public function get thumbFactory():Function
    public function set thumbFactory(value:Function):void

See also

thumbNameproperty 
protected var thumbName:String = feathers-scroll-bar-thumb

The value added to the nameList of the thumb.

thumbPropertiesproperty 
thumbProperties:Object

A set of key/value pairs to be passed down to the scroll bar's thumb sub-component. The thumb is a feathers.controls.Button instance.

If the subcomponent has its own subcomponents, their properties can be set too, using attribute @ notation. For example, to set the skin on the thumb of a SimpleScrollBar which is in a Scroller which is in a List, you can use the following syntax:

list.scrollerProperties.@verticalScrollBarProperties.@thumbProperties.defaultSkin = new Image(texture);


Implementation
    public function get thumbProperties():Object
    public function set thumbProperties(value:Object):void

See also

trackLayoutModeproperty 
trackLayoutMode:String

Determines how the minimum and maximum track skins are positioned and sized.

The default value is TRACK_LAYOUT_MODE_SINGLE.


Implementation
    public function get trackLayoutMode():String
    public function set trackLayoutMode(value:String):void

See also

valueproperty 
value:Number

The current value of the scroll bar.


Implementation
    public function get value():Number
    public function set value(value:Number):void
Constructor Detail
ScrollBar()Constructor
public function ScrollBar()

Constructor.

Event Detail
beginInteraction Event
Event Object Type: starling.events.Event
Event.type property = feathers.events.FeathersEventType.BEGIN_INTERACTION

Dispatched when the user starts interacting with the scroll bar's thumb, track, or buttons.

The FeathersEventType.BEGIN_INTERACTION event type is used by many UI controls where a drag or other interaction happens over time. An example is a Slider control where the user touches the thumb to begin dragging.
change Event  
Event Object Type: starling.events.Event
Event.type property = starling.events.Event.CHANGE

Dispatched when the scroll bar's value changes.

An event type to be utilized in custom events. Not used by Starling right now.
endInteraction Event  
Event Object Type: starling.events.Event
Event.type property = feathers.events.FeathersEventType.END_INTERACTION

Dispatched when the user stops interacting with the scroll bar's thumb, track, or buttons.

The FeathersEventType.END_INTERACTION event type is used by many UI controls where a drag or other interaction happens over time. An example is a Slider control where the user stops touching the thumb after dragging.
Constant Detail
DEFAULT_CHILD_NAME_DECREMENT_BUTTONConstant
public static const DEFAULT_CHILD_NAME_DECREMENT_BUTTON:String = feathers-scroll-bar-decrement-button

The default value added to the nameList of the decrement button.

DEFAULT_CHILD_NAME_INCREMENT_BUTTONConstant 
public static const DEFAULT_CHILD_NAME_INCREMENT_BUTTON:String = feathers-scroll-bar-increment-button

The default value added to the nameList of the increment button.

DEFAULT_CHILD_NAME_MAXIMUM_TRACKConstant 
public static const DEFAULT_CHILD_NAME_MAXIMUM_TRACK:String = feathers-scroll-bar-maximum-track

The default value added to the nameList of the maximum track.

DEFAULT_CHILD_NAME_MINIMUM_TRACKConstant 
public static const DEFAULT_CHILD_NAME_MINIMUM_TRACK:String = feathers-scroll-bar-minimum-track

The default value added to the nameList of the minimum track.

DEFAULT_CHILD_NAME_THUMBConstant 
public static const DEFAULT_CHILD_NAME_THUMB:String = feathers-scroll-bar-thumb

The default value added to the nameList of the thumb.

DIRECTION_HORIZONTALConstant 
public static const DIRECTION_HORIZONTAL:String = horizontal

The scroll bar's thumb may be dragged horizontally (on the x-axis).

DIRECTION_VERTICALConstant 
public static const DIRECTION_VERTICAL:String = vertical

The scroll bar's thumb may be dragged vertically (on the y-axis).

TRACK_LAYOUT_MODE_MIN_MAXConstant 
public static const TRACK_LAYOUT_MODE_MIN_MAX:String = minMax

The scroll bar has two tracks, stretching to fill each side of the scroll bar with the thumb in the middle. The tracks will be resized as the thumb moves. This layout mode is designed for scroll bars where the two sides of the track may be colored differently to show the value "filling up" as the thumb is dragged or to highlight the track when it is triggered to scroll by a page instead of a step.

Since the width and height of the tracks will change, consider sing a special display object such as a Scale9Image, Scale3Image or a TiledImage that is designed to be resized dynamically.

See also

TRACK_LAYOUT_MODE_SINGLEConstant 
public static const TRACK_LAYOUT_MODE_SINGLE:String = single

The scroll bar has only one track, that fills the full length of the scroll bar. In this layout mode, the "minimum" track is displayed and fills the entire length of the scroll bar. The maximum track will not exist.