Package | feathers.controls |
Class | public class ScrollBar |
Inheritance | ScrollBar ![]() ![]() |
Implements | IDirectionalScrollBar |
SimpleScrollBar
is probably a better choice as it provides
only the thumb to indicate position without all the extra chrome.
The following example updates a list to use scroll bars:
list.horizontalScrollBarFactory = function():IScrollBar { return new ScrollBar(); }; list.verticalScrollBarFactory = function():IScrollBar { return new ScrollBar(); };
See also
Property | Defined By | ||
---|---|---|---|
customDecrementButtonName : String
DEPRECATED: Replaced by customDecrementButtonStyleName. | ScrollBar | ||
customDecrementButtonStyleName : String
A style name to add to the scroll bar's decrement button
sub-component. | ScrollBar | ||
customIncrementButtonName : String
DEPRECATED: Replaced by customIncrementButtonStyleName. | ScrollBar | ||
customIncrementButtonStyleName : String
A style name to add to the scroll bar's increment button
sub-component. | ScrollBar | ||
customMaximumTrackName : String
DEPRECATED: Replaced by customMaximumTrackStyleName. | ScrollBar | ||
customMaximumTrackStyleName : String
A style name to add to the scroll bar's maximum track sub-component. | ScrollBar | ||
customMinimumTrackName : String
DEPRECATED: Replaced by customMinimumTrackStyleName. | ScrollBar | ||
customMinimumTrackStyleName : String
A style name to add to the scroll bar's minimum track sub-component. | ScrollBar | ||
customThumbName : String
DEPRECATED: Replaced by customThumbStyleName. | ScrollBar | ||
customThumbStyleName : String
A style 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
An object that stores properties for the scroll bar's decrement
button, and the properties will be passed down to the decrement
button when the scroll bar validates. | ScrollBar | ||
![]() | defaultTextEditorFactory : Function [static]
A function used by all UI controls that support text editor to
create an ITextEditor instance. | FeathersControl | |
![]() | defaultTextRendererFactory : Function [static]
A function used by all UI controls that support text renderers to
create an ITextRenderer instance. | FeathersControl | |
![]() | depth : int [read-only]
The component's depth in the display list, relative to the stage. | FeathersControl | |
direction : String
Determines if the scroll bar's thumb can be dragged horizontally or
vertically. | ScrollBar | ||
![]() | focusIndicatorSkin : DisplayObject
If this component supports focus, this optional skin will be
displayed above the component when showFocus() is
called. | FeathersControl | |
![]() | focusManager : IFocusManager | FeathersControl | |
![]() | focusOwner : IFocusDisplayObject | FeathersControl | |
![]() | focusPadding : Number
Quickly sets all focus padding properties to the same value. | FeathersControl | |
![]() | focusPaddingBottom : Number
The minimum space, in pixels, between the object's bottom edge and the
bottom edge of the focus indicator skin. | FeathersControl | |
![]() | focusPaddingLeft : Number
The minimum space, in pixels, between the object's left edge and the
left edge of the focus indicator skin. | FeathersControl | |
![]() | focusPaddingRight : Number
The minimum space, in pixels, between the object's right edge and the
right edge of the focus indicator skin. | FeathersControl | |
![]() | focusPaddingTop : Number
The minimum space, in pixels, between the object's top edge and the
top edge of the focus indicator skin. | FeathersControl | |
globalStyleProvider : IStyleProvider [static]
The default IStyleProvider for all ScrollBar
components. | ScrollBar | ||
![]() | height : Number [override]
The height of the component, in pixels. | FeathersControl | |
![]() | includeInLayout : 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
An object that stores properties for the scroll bar's increment
button, and the properties will be passed down to the increment
button when the scroll bar validates. | ScrollBar | ||
![]() | isCreated : Boolean [read-only]
Determines if the component has been initialized and validated for
the first time. | FeathersControl | |
![]() | isEnabled : Boolean
Indicates whether the control is interactive or not. | FeathersControl | |
![]() | isFocusEnabled : Boolean | FeathersControl | |
![]() | isInitialized : Boolean [read-only]
Determines if the component has been initialized yet. | FeathersControl | |
![]() | isQuickHitAreaEnabled : Boolean
Similar to mouseChildren on the classic display list. | FeathersControl | |
![]() | layoutData : 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 | ||
![]() | maxHeight : 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 numeric value of the range. | ScrollBar | ||
maximumTrackFactory : Function
A function used to generate the scroll bar's maximum track
sub-component. | ScrollBar | ||
maximumTrackProperties : Object
An object that stores properties for the scroll bar's "maximum"
track, and the properties will be passed down to the "maximum" track when
the scroll bar validates. | ScrollBar | ||
![]() | maxWidth : Number
The maximum recommended width to be used for self-measurement and,
optionally, by any code that is resizing this component. | FeathersControl | |
![]() | minHeight : 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 numeric value of the range. | ScrollBar | ||
minimumTrackFactory : Function
A function used to generate the scroll bar's minimum track
sub-component. | ScrollBar | ||
minimumTrackProperties : Object
An object that stores properties for the scroll bar's "minimum"
track, and the properties will be passed down to the "minimum" track when
the scroll bar validates. | ScrollBar | ||
![]() | minTouchHeight : Number
If using isQuickHitAreaEnabled, and the hit area's
height is smaller than this value, it will be expanded. | FeathersControl | |
![]() | minTouchWidth : Number
If using isQuickHitAreaEnabled, and the hit area's
width is smaller than this value, it will be expanded. | FeathersControl | |
![]() | minWidth : Number
The minimum recommended width to be used for self-measurement and,
optionally, by any code that is resizing this component. | FeathersControl | |
![]() | nextTabFocus : IFocusDisplayObject | FeathersControl | |
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 | ||
![]() | previousTabFocus : IFocusDisplayObject | FeathersControl | |
repeatDelay : Number
The time, in seconds, before actions are repeated. | ScrollBar | ||
step : Number
The amount the value must change to increment or decrement. | ScrollBar | ||
![]() | styleName : String
The concatenated styleNameList, with values separated
by spaces. | FeathersControl | |
![]() | styleNameList : TokenList [read-only]
Contains a list of all "styles" assigned to this control. | FeathersControl | |
![]() | styleProvider : IStyleProvider
When a component initializes, a style provider may be used to set
properties that affect the component's visual appearance. | FeathersControl | |
thumbFactory : Function
A function used to generate the scroll bar's thumb sub-component. | ScrollBar | ||
thumbProperties : Object
An object that stores properties for the scroll bar's thumb, and the
properties will be passed down to the thumb when the scroll bar
validates. | ScrollBar | ||
trackLayoutMode : String
Determines how the minimum and maximum track skins are positioned and
sized. | ScrollBar | ||
value : Number
The current numeric value. | ScrollBar | ||
![]() | width : Number [override]
The width of the component, in pixels. | FeathersControl |
Property | Defined By | ||
---|---|---|---|
![]() | actualHeight : Number = 0
The final height value that should be used for layout. | FeathersControl | |
![]() | actualWidth : 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
DEPRECATED: Replaced by decrementButtonStyleName. | ScrollBar | ||
decrementButtonStyleName : String = feathers-scroll-bar-decrement-button
The value added to the styleNameList of the decrement
button. | ScrollBar | ||
![]() | defaultStyleProvider : IStyleProvider [read-only]
When the FeathersControl constructor is called, the
globalStyleProvider property is set to this value. | FeathersControl | |
![]() | explicitHeight : Number = NaN
The height value explicitly set by calling the height setter or
setSize(). | FeathersControl | |
![]() | explicitWidth : 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
DEPRECATED: Replaced by incrementButtonStyleName. | ScrollBar | ||
incrementButtonStyleName : String = feathers-scroll-bar-increment-button
The value added to the styleNameList of the increment
button. | ScrollBar | ||
maximumTrack : Button
The scroll bar's maximum track sub-component. | ScrollBar | ||
maximumTrackName : String
DEPRECATED: Replaced by maximumTrackStyleName. | ScrollBar | ||
maximumTrackStyleName : String = feathers-scroll-bar-maximum-track
The value added to the styleNameList of the maximum
track. | ScrollBar | ||
minimumTrack : Button
The scroll bar's minimum track sub-component. | ScrollBar | ||
minimumTrackName : String
DEPRECATED: Replaced by minimumTrackStyleName. | ScrollBar | ||
minimumTrackStyleName : String = feathers-scroll-bar-minimum-track
The value added to the styleNameList of the minimum
track. | ScrollBar | ||
thumb : Button
The scroll bar's thumb sub-component. | ScrollBar | ||
thumbName : String
DEPRECATED: Replaced by thumbStyleName. | ScrollBar | ||
thumbStyleName : String = feathers-scroll-bar-thumb
The value added to the styleNameList of the thumb. | ScrollBar |
Method | Defined By | ||
---|---|---|---|
Constructor. | ScrollBar | ||
![]() | hideFocus():void
If the visual indicator of focus has been displayed by
showFocus(), call this function to hide it. | FeathersControl | |
![]() | invalidate(flag:String):void
Call this function to tell the UI control that a redraw is pending. | FeathersControl | |
![]() | isInvalid(flag:String = null):Boolean
Indicates whether the control is pending validation or not. | FeathersControl | |
![]() | move(x:Number, y:Number):void
Sets both the x and the y positions of the control in a single
function call. | FeathersControl | |
![]() | setSize(width:Number, height:Number):void
Sets both the width and the height of the control in a single
function call. | FeathersControl | |
![]() | showFocus():void
If the object has focus, an additional visual indicator may
optionally be displayed to highlight the object. | FeathersControl | |
![]() | validate():void
Immediately validates the display object, if it is invalid. | FeathersControl |
Method | Defined By | ||
---|---|---|---|
autoSizeIfNeeded():Boolean
If the component's dimensions have not been set explicitly, it will
measure its content and determine an ideal size for itself. | ScrollBar | ||
![]() | clearInvalidationFlag(flag:String):void
Clears an invalidation flag. | FeathersControl | |
createDecrementButton():void
Creates and adds the decrementButton sub-component and
removes the old instance, if one exists. | ScrollBar | ||
createIncrementButton():void
Creates and adds the incrementButton sub-component and
removes the old instance, if one exists. | ScrollBar | ||
createMaximumTrack():void
Creates and adds the maximumTrack sub-component and
removes the old instance, if one exists. | ScrollBar | ||
createMinimumTrack():void
Creates and adds the minimumTrack sub-component and
removes the old instance, if one exists. | ScrollBar | ||
createThumb():void
Creates and adds the thumb sub-component and
removes the old instance, if one exists. | ScrollBar | ||
![]() | draw():void
Override to customize layout and to adjust properties of children. | FeathersControl | |
![]() | focusInHandler(event:Event):void
Default event handler for FeathersEventType.FOCUS_IN
that may be overridden in subclasses to perform additional actions
when the component receives focus. | FeathersControl | |
![]() | focusOutHandler(event:Event):void
Default event handler for FeathersEventType.FOCUS_OUT
that may be overridden in subclasses to perform additional actions
when the component loses focus. | FeathersControl | |
![]() | 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 | |
![]() | refreshFocusIndicator():void
Updates the focus indicator skin by showing or hiding it and
adjusting its position and dimensions. | FeathersControl | |
![]() | setInvalidationFlag(flag:String):void
Sets an invalidation flag. | FeathersControl | |
![]() | setSizeInternal(width:Number, height:Number, canInvalidate:Boolean):Boolean
Sets the width and height of the control, with the option of
invalidating or not. | FeathersControl |
Event | Summary | Defined By | ||
---|---|---|---|---|
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 after the component has validated for the first time. | FeathersControl | ||
Dispatched when the user stops interacting with the scroll bar's thumb, track, or buttons. | ScrollBar | |||
![]() | Dispatched after initialize() has been called, but before the first time that draw() has been called. | FeathersControl | ||
![]() | Dispatched when the width or height of the control changes. | FeathersControl |
Constant | Defined By | ||
---|---|---|---|
DEFAULT_CHILD_NAME_DECREMENT_BUTTON : String = feathers-scroll-bar-decrement-button [static]
DEPRECATED: Replaced by ScrollBar.DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON. | ScrollBar | ||
DEFAULT_CHILD_NAME_INCREMENT_BUTTON : String = feathers-scroll-bar-increment-button [static]
DEPRECATED: Replaced by ScrollBar.DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON. | ScrollBar | ||
DEFAULT_CHILD_NAME_MAXIMUM_TRACK : String = feathers-scroll-bar-maximum-track [static]
DEPRECATED: Replaced by ScrollBar.DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK. | ScrollBar | ||
DEFAULT_CHILD_NAME_MINIMUM_TRACK : String = feathers-scroll-bar-minimum-track [static]
DEPRECATED: Replaced by ScrollBar.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK. | ScrollBar | ||
DEFAULT_CHILD_NAME_THUMB : String = feathers-scroll-bar-thumb [static]
DEPRECATED: Replaced by ScrollBar.DEFAULT_CHILD_STYLE_NAME_THUMB. | ScrollBar | ||
DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON : String = feathers-scroll-bar-decrement-button [static]
The default value added to the styleNameList of the decrement
button. | ScrollBar | ||
DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON : String = feathers-scroll-bar-increment-button [static]
The default value added to the styleNameList of the increment
button. | ScrollBar | ||
DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK : String = feathers-scroll-bar-maximum-track [static]
The default value added to the styleNameList of the maximum
track. | ScrollBar | ||
DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK : String = feathers-scroll-bar-minimum-track [static]
The default value added to the styleNameList of the minimum
track. | ScrollBar | ||
DEFAULT_CHILD_STYLE_NAME_THUMB : String = feathers-scroll-bar-thumb [static]
The default value added to the styleNameList 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 | ||
![]() | INVALIDATION_FLAG_ALL : String = all [static]
Flag to indicate that everything is invalid and should be redrawn. | FeathersControl | |
![]() | INVALIDATION_FLAG_DATA : String = data [static]
Invalidation flag to indicate that the primary data displayed by the
UI control has changed. | FeathersControl | |
![]() | INVALIDATION_FLAG_FOCUS : String = focus [static]
Invalidation flag to indicate that the focus of the UI control has
changed. | FeathersControl | |
![]() | INVALIDATION_FLAG_LAYOUT : String = layout [static]
Invalidation flag to indicate that the layout of the UI control has
changed. | FeathersControl | |
![]() | INVALIDATION_FLAG_SCROLL : String = scroll [static]
Invalidation flag to indicate that the scroll position of the UI
control has changed. | FeathersControl | |
![]() | INVALIDATION_FLAG_SELECTED : String = selected [static]
Invalidation flag to indicate that the selection of the UI control
has changed. | FeathersControl | |
![]() | INVALIDATION_FLAG_SIZE : String = size [static]
Invalidation flag to indicate that the dimensions of the UI control
have changed. | FeathersControl | |
![]() | INVALIDATION_FLAG_SKIN : String = skin [static]
Invalidation flag to indicate that the skin of the UI control has changed. | FeathersControl | |
![]() | INVALIDATION_FLAG_STATE : String = state [static]
Invalidation flag to indicate that the state has changed. | FeathersControl | |
![]() | INVALIDATION_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 |
customDecrementButtonName | property |
customDecrementButtonName:String
DEPRECATED: Replaced by customDecrementButtonStyleName
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
public function get customDecrementButtonName():String
public function set customDecrementButtonName(value:String):void
See also
customDecrementButtonStyleName | property |
customDecrementButtonStyleName:String
A style name to add to the scroll bar's decrement button sub-component. Typically used by a theme to provide different styles to different scroll bars.
In the following example, a custom decrement button style name is passed to the scroll bar:
scrollBar.customDecrementButtonStyleName = "my-custom-decrement-button";
In your theme, you can target this sub-component style name to provide different skins than the default style:
getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-decrement-button", setCustomDecrementButtonStyles );
The default value is null
.
public function get customDecrementButtonStyleName():String
public function set customDecrementButtonStyleName(value:String):void
See also
customIncrementButtonName | property |
customIncrementButtonName:String
DEPRECATED: Replaced by customIncrementButtonStyleName
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
public function get customIncrementButtonName():String
public function set customIncrementButtonName(value:String):void
See also
customIncrementButtonStyleName | property |
customIncrementButtonStyleName:String
A style name to add to the scroll bar's increment button sub-component. Typically used by a theme to provide different styles to different scroll bars.
In the following example, a custom increment button style name is passed to the scroll bar:
scrollBar.customIncrementButtonStyleName = "my-custom-increment-button";
In your theme, you can target this sub-component style name to provide different styles than the default:
getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-increment-button", setCustomIncrementButtonStyles );
The default value is null
.
public function get customIncrementButtonStyleName():String
public function set customIncrementButtonStyleName(value:String):void
See also
customMaximumTrackName | property |
customMaximumTrackName:String
DEPRECATED: Replaced by customMaximumTrackStyleName
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
public function get customMaximumTrackName():String
public function set customMaximumTrackName(value:String):void
See also
customMaximumTrackStyleName | property |
customMaximumTrackStyleName:String
A style name to add to the scroll bar's maximum track sub-component. Typically used by a theme to provide different styles to different scroll bars.
In the following example, a custom maximum track style name is passed to the scroll bar:
scrollBar.customMaximumTrackStyleName = "my-custom-maximum-track";
In your theme, you can target this sub-component style name to provide different styles than the default:
getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-maximum-track", setCustomMaximumTrackStyles );
The default value is null
.
public function get customMaximumTrackStyleName():String
public function set customMaximumTrackStyleName(value:String):void
See also
customMinimumTrackName | property |
customMinimumTrackName:String
DEPRECATED: Replaced by customMinimumTrackStyleName
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
public function get customMinimumTrackName():String
public function set customMinimumTrackName(value:String):void
See also
customMinimumTrackStyleName | property |
customMinimumTrackStyleName:String
A style name to add to the scroll bar's minimum track sub-component. Typically used by a theme to provide different styles to different scroll bars.
In the following example, a custom minimum track style name is passed to the scroll bar:
scrollBar.customMinimumTrackStyleName = "my-custom-minimum-track";
In your theme, you can target this sub-component style name to provide different styles than the default:
getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-minimum-track", setCustomMinimumTrackStyles );
The default value is null
.
public function get customMinimumTrackStyleName():String
public function set customMinimumTrackStyleName(value:String):void
See also
customThumbName | property |
customThumbName:String
DEPRECATED: Replaced by customThumbStyleName
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
public function get customThumbName():String
public function set customThumbName(value:String):void
See also
customThumbStyleName | property |
customThumbStyleName:String
A style name to add to the scroll bar's thumb sub-component. Typically used by a theme to provide different styles to different scroll bars.
In the following example, a custom thumb style name is passed to the scroll bar:
scrollBar.customThumbStyleName = "my-custom-thumb";
In your theme, you can target this sub-component style name to provide different styles than the default:
getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-thumb", setCustomThumbStyles );
The default value is null
.
public function get customThumbStyleName():String
public function set customThumbStyleName(value:String):void
See also
decrementButton | property |
protected var decrementButton:Button
The scroll bar's decrement button sub-component.
For internal use in subclasses.
See also
decrementButtonFactory | property |
decrementButtonFactory:Function
A function used to generate the scroll bar's decrement button
sub-component. The decrement button must be an instance of
Button
. This factory 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 this
factory to set skins and other styles on the decrement button.
The function should have the following signature:
function():Button
In the following example, a custom decrement button factory is passed to the scroll bar:
scrollBar.decrementButtonFactory = function():Button { var button:Button = new Button(); button.defaultSkin = new Image( upTexture ); button.downSkin = new Image( downTexture ); return button; };
The default value is null
.
public function get decrementButtonFactory():Function
public function set decrementButtonFactory(value:Function):void
See also
decrementButtonName | property |
decrementButtonName:String
DEPRECATED: Replaced by decrementButtonStyleName
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
protected function get decrementButtonName():String
protected function set decrementButtonName(value:String):void
See also
decrementButtonProperties | property |
decrementButtonProperties:Object
An object that stores properties for the scroll bar's decrement
button, and the properties will be passed down to the decrement
button when the scroll bar validates. For a list of available
properties, refer to
feathers.controls.Button
.
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 which is in a SimpleScrollBar
,
which is in a List
, you can use the following syntax:
list.verticalScrollBarProperties.@thumbProperties.defaultSkin = new Image(texture);
Setting properties in a decrementButtonFactory
function instead of using decrementButtonProperties
will
result in better performance.
In the following example, the scroll bar's decrement button properties are updated:
scrollBar.decrementButtonProperties.defaultSkin = new Image( upTexture ); scrollBar.decrementButtonProperties.downSkin = new Image( downTexture );
The default value is null
.
public function get decrementButtonProperties():Object
public function set decrementButtonProperties(value:Object):void
See also
decrementButtonStyleName | property |
protected var decrementButtonStyleName:String = feathers-scroll-bar-decrement-button
The value added to the styleNameList
of the decrement
button. This variable is protected
so that sub-classes
can customize the decrement button style name in their constructors
instead of using the default style name defined by
DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON
.
To customize the decrement button style name without subclassing,
see customDecrementButtonStyleName
.
See also
direction | property |
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.
In the following example, the direction is changed to vertical:
scrollBar.direction = ScrollBar.DIRECTION_VERTICAL;
The default value is ScrollBar.DIRECTION_HORIZONTAL
.
public function get direction():String
public function set direction(value:String):void
See also
globalStyleProvider | property |
public static var globalStyleProvider:IStyleProvider
The default IStyleProvider
for all ScrollBar
components.
The default value is null
.
See also
incrementButton | property |
protected var incrementButton:Button
The scroll bar's increment button sub-component.
For internal use in subclasses.
See also
incrementButtonFactory | property |
incrementButtonFactory:Function
A function used to generate the scroll bar's increment button
sub-component. The increment button must be an instance of
Button
. This factory 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 this
factory to set skins and other styles on the increment button.
The function should have the following signature:
function():Button
In the following example, a custom increment button factory is passed to the scroll bar:
scrollBar.incrementButtonFactory = function():Button { var button:Button = new Button(); button.defaultSkin = new Image( upTexture ); button.downSkin = new Image( downTexture ); return button; };
The default value is null
.
public function get incrementButtonFactory():Function
public function set incrementButtonFactory(value:Function):void
See also
incrementButtonName | property |
incrementButtonName:String
DEPRECATED: Replaced by incrementButtonStyleName
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
protected function get incrementButtonName():String
protected function set incrementButtonName(value:String):void
See also
incrementButtonProperties | property |
incrementButtonProperties:Object
An object that stores properties for the scroll bar's increment
button, and the properties will be passed down to the increment
button when the scroll bar validates. For a list of available
properties, refer to
feathers.controls.Button
.
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 which is in a SimpleScrollBar
,
which is in a List
, you can use the following syntax:
list.verticalScrollBarProperties.@thumbProperties.defaultSkin = new Image(texture);
Setting properties in a incrementButtonFactory
function instead of using incrementButtonProperties
will
result in better performance.
In the following example, the scroll bar's increment button properties are updated:
scrollBar.incrementButtonProperties.defaultSkin = new Image( upTexture ); scrollBar.incrementButtonProperties.downSkin = new Image( downTexture );
The default value is null
.
public function get incrementButtonProperties():Object
public function set incrementButtonProperties(value:Object):void
See also
incrementButtonStyleName | property |
protected var incrementButtonStyleName:String = feathers-scroll-bar-increment-button
The value added to the styleNameList
of the increment
button. This variable is protected
so that sub-classes
can customize the increment button style name in their constructors
instead of using the default style name defined by
DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON
.
To customize the increment button style name without subclassing,
see customIncrementButtonName
.
See also
liveDragging | property |
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.
In the following example, live dragging is disabled:
scrollBar.liveDragging = false;
The default value is true
.
maximum | property |
maximum:Number
The maximum numeric value of the range.
In the following example, the maximum is changed to 100:
component.minimum = 0; component.maximum = 100; component.step = 1; component.page = 10 component.value = 12;
The default value is 0
.
public function get maximum():Number
public function set maximum(value:Number):void
See also
maximumTrack | property |
protected var maximumTrack:Button
The scroll bar's maximum track sub-component.
For internal use in subclasses.
See also
maximumTrackFactory | property |
maximumTrackFactory:Function
A function used to generate the scroll bar's maximum track
sub-component. The maximum track must be an instance of
Button
. This factory 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 this
factory to set skins and other styles on the maximum track.
The function should have the following signature:
function():Button
In the following example, a custom maximum track factory is passed to the scroll bar:
scrollBar.maximumTrackFactory = function():Button { var track:Button = new Button(); track.defaultSkin = new Image( upTexture ); track.downSkin = new Image( downTexture ); return track; };
The default value is null
.
public function get maximumTrackFactory():Function
public function set maximumTrackFactory(value:Function):void
See also
maximumTrackName | property |
maximumTrackName:String
DEPRECATED: Replaced by maximumTrackStyleName
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
protected function get maximumTrackName():String
protected function set maximumTrackName(value:String):void
See also
maximumTrackProperties | property |
maximumTrackProperties:Object
An object that stores properties for the scroll bar's "maximum"
track, and the properties will be passed down to the "maximum" track when
the scroll bar validates. For a list of available properties, refer to
feathers.controls.Button
.
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 which is in a SimpleScrollBar
,
which is in a List
, you can use the following syntax:
list.verticalScrollBarProperties.@thumbProperties.defaultSkin = new Image(texture);
Setting properties in a maximumTrackFactory
function
instead of using maximumTrackProperties
will result in
better performance.
In the following example, the scroll bar's maximum track properties are updated:
scrollBar.maximumTrackProperties.defaultSkin = new Image( upTexture ); scrollBar.maximumTrackProperties.downSkin = new Image( downTexture );
The default value is null
.
public function get maximumTrackProperties():Object
public function set maximumTrackProperties(value:Object):void
See also
maximumTrackStyleName | property |
protected var maximumTrackStyleName:String = feathers-scroll-bar-maximum-track
The value added to the styleNameList
of the maximum
track. This variable is protected
so that sub-classes
can customize the maximum track style name in their constructors
instead of using the default style name defined by
DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK
.
To customize the maximum track style name without subclassing, see
customMaximumTrackStyleName
.
See also
minimum | property |
minimum:Number
The minimum numeric value of the range.
In the following example, the minimum is changed to 0:
component.minimum = 0; component.maximum = 100; component.step = 1; component.page = 10 component.value = 12;
The default value is 0
.
public function get minimum():Number
public function set minimum(value:Number):void
See also
minimumTrack | property |
protected var minimumTrack:Button
The scroll bar's minimum track sub-component.
For internal use in subclasses.
See also
minimumTrackFactory | property |
minimumTrackFactory:Function
A function used to generate the scroll bar's minimum track
sub-component. The minimum track must be an instance of
Button
. This factory 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 this
factory to set skins and other styles on the minimum track.
The function should have the following signature:
function():Button
In the following example, a custom minimum track factory is passed to the scroll bar:
scrollBar.minimumTrackFactory = function():Button { var track:Button = new Button(); track.defaultSkin = new Image( upTexture ); track.downSkin = new Image( downTexture ); return track; };
The default value is null
.
public function get minimumTrackFactory():Function
public function set minimumTrackFactory(value:Function):void
See also
minimumTrackName | property |
minimumTrackName:String
DEPRECATED: Replaced by minimumTrackStyleName
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
protected function get minimumTrackName():String
protected function set minimumTrackName(value:String):void
See also
minimumTrackProperties | property |
minimumTrackProperties:Object
An object that stores properties for the scroll bar's "minimum"
track, and the properties will be passed down to the "minimum" track when
the scroll bar validates. For a list of available properties, refer to
feathers.controls.Button
.
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 which is in a SimpleScrollBar
,
which is in a List
, you can use the following syntax:
list.verticalScrollBarProperties.@thumbProperties.defaultSkin = new Image(texture);
Setting properties in a minimumTrackFactory
function
instead of using minimumTrackProperties
will result in
better performance.
In the following example, the scroll bar's minimum track properties are updated:
scrollBar.minimumTrackProperties.defaultSkin = new Image( upTexture ); scrollBar.minimumTrackProperties.downSkin = new Image( downTexture );
The default value is null
.
public function get minimumTrackProperties():Object
public function set minimumTrackProperties(value:Object):void
See also
minimumTrackStyleName | property |
protected var minimumTrackStyleName:String = feathers-scroll-bar-minimum-track
The value added to the styleNameList
of the minimum
track. This variable is protected
so that sub-classes
can customize the minimum track style name in their constructors
instead of using the default style name defined by
DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK
.
To customize the minimum track style name without subclassing, see
customMinimumTrackStyleName
.
See also
padding | property |
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.
In the following example, the padding is changed to 20 pixels:
scrollBar.padding = 20;
The default value is 0
.
public function get padding():Number
public function set padding(value:Number):void
See also
paddingBottom | property |
paddingBottom:Number
The minimum space, in pixels, below the content, not including the track(s).
In the following example, the bottom padding is changed to 20 pixels:
scrollBar.paddingBottom = 20;
The default value is 0
.
public function get paddingBottom():Number
public function set paddingBottom(value:Number):void
paddingLeft | property |
paddingLeft:Number
The minimum space, in pixels, to the left of the content, not including the track(s).
In the following example, the left padding is changed to 20 pixels:
scrollBar.paddingLeft = 20;
The default value is 0
.
public function get paddingLeft():Number
public function set paddingLeft(value:Number):void
paddingRight | property |
paddingRight:Number
The minimum space, in pixels, to the right of the content, not including the track(s).
In the following example, the right padding is changed to 20 pixels:
scrollBar.paddingRight = 20;
The default value is 0
.
public function get paddingRight():Number
public function set paddingRight(value:Number):void
paddingTop | property |
paddingTop:Number
The minimum space, in pixels, above the content, not including the track(s).
In the following example, the top padding is changed to 20 pixels:
scrollBar.paddingTop = 20;
The default value is 0
.
public function get paddingTop():Number
public function set paddingTop(value:Number):void
page | property |
page:Number
The amount the scroll bar value must change to get from one "page" to the next.
In the following example, the page is changed to 10:
scrollBar.minimum = 0; scrollBar.maximum = 100; scrollBar.step = 1; scrollBar.page = 10 scrollBar.value = 12;
The default value is 0
.
public function get page():Number
public function set page(value:Number):void
See also
repeatDelay | property |
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.
In the following example, the repeat delay is changed to 500 milliseconds:
scrollBar.repeatDelay = 0.5;
The default value is 0.05
.
public function get repeatDelay():Number
public function set repeatDelay(value:Number):void
step | property |
step:Number
The amount the value must change to increment or decrement.
In the following example, the step is changed to 1:
component.minimum = 0; component.maximum = 100; component.step = 1; component.page = 10 component.value = 12;
The default value is 0
.
public function get step():Number
public function set step(value:Number):void
See also
thumb | property |
protected var thumb:Button
The scroll bar's thumb sub-component.
For internal use in subclasses.
See also
thumbFactory | property |
thumbFactory:Function
A function used to generate the scroll bar's thumb sub-component.
The thumb must be an instance of Button
. This factory
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 this factory to set skins and other
styles on the thumb.
The function should have the following signature:
function():Button
In the following example, a custom thumb factory is passed to the scroll bar:
scrollBar.thumbFactory = function():Button { var thumb:Button = new Button(); thumb.defaultSkin = new Image( upTexture ); thumb.downSkin = new Image( downTexture ); return thumb; };
The default value is null
.
public function get thumbFactory():Function
public function set thumbFactory(value:Function):void
See also
thumbName | property |
thumbName:String
DEPRECATED: Replaced by thumbStyleName
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
protected function get thumbName():String
protected function set thumbName(value:String):void
See also
thumbProperties | property |
thumbProperties:Object
An object that stores properties for the scroll bar's thumb, and the
properties will be passed down to the thumb when the scroll bar
validates. For a list of available properties, refer to
feathers.controls.Button
.
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 which is in a SimpleScrollBar
,
which is in a List
, you can use the following syntax:
list.verticalScrollBarProperties.@thumbProperties.defaultSkin = new Image(texture);
Setting properties in a thumbFactory
function instead
of using thumbProperties
will result in better
performance.
In the following example, the scroll bar's thumb properties are updated:
scrollBar.thumbProperties.defaultSkin = new Image( upTexture ); scrollBar.thumbProperties.downSkin = new Image( downTexture );
The default value is null
.
public function get thumbProperties():Object
public function set thumbProperties(value:Object):void
See also
thumbStyleName | property |
protected var thumbStyleName:String = feathers-scroll-bar-thumb
The value added to the styleNameList
of the thumb. This
variable is protected
so that sub-classes can customize
the thumb style name in their constructors instead of using the
default style name defined by DEFAULT_CHILD_STYLE_NAME_THUMB
.
To customize the thumb style name without subclassing, see
customThumbStyleName
.
See also
trackLayoutMode | property |
trackLayoutMode:String
Determines how the minimum and maximum track skins are positioned and sized.
In the following example, the scroll bar is given two tracks:
scrollBar.trackLayoutMode = ScrollBar.TRACK_LAYOUT_MODE_MIN_MAX;
The default value is ScrollBar.TRACK_LAYOUT_MODE_SINGLE
.
public function get trackLayoutMode():String
public function set trackLayoutMode(value:String):void
See also
value | property |
value:Number
The current numeric value.
In the following example, the value is changed to 12:
component.minimum = 0; component.maximum = 100; component.step = 1; component.page = 10 component.value = 12;
The default value is 0
.
public function get value():Number
public function set value(value:Number):void
See also
ScrollBar | () | Constructor |
public function ScrollBar()
Constructor.
autoSizeIfNeeded | () | method |
protected function autoSizeIfNeeded():Boolean
If the component's dimensions have not been set explicitly, it will
measure its content and determine an ideal size for itself. If the
explicitWidth
or explicitHeight
member
variables are set, those value will be used without additional
measurement. If one is set, but not the other, the dimension with the
explicit value will not be measured, but the other non-explicit
dimension will still need measurement.
Calls setSizeInternal()
to set up the
actualWidth
and actualHeight
member
variables used for layout.
Meant for internal use, and subclasses may override this function with a custom implementation.
ReturnsBoolean |
createDecrementButton | () | method |
protected function createDecrementButton():void
Creates and adds the decrementButton
sub-component and
removes the old instance, if one exists.
Meant for internal use, and subclasses may override this function with a custom implementation.
See also
createIncrementButton | () | method |
protected function createIncrementButton():void
Creates and adds the incrementButton
sub-component and
removes the old instance, if one exists.
Meant for internal use, and subclasses may override this function with a custom implementation.
See also
createMaximumTrack | () | method |
protected function createMaximumTrack():void
Creates and adds the maximumTrack
sub-component and
removes the old instance, if one exists. If the maximum track is not
needed, it will not be created.
Meant for internal use, and subclasses may override this function with a custom implementation.
See also
createMinimumTrack | () | method |
protected function createMinimumTrack():void
Creates and adds the minimumTrack
sub-component and
removes the old instance, if one exists.
Meant for internal use, and subclasses may override this function with a custom implementation.
See also
createThumb | () | method |
protected function createThumb():void
Creates and adds the thumb
sub-component and
removes the old instance, if one exists.
Meant for internal use, and subclasses may override this function with a custom implementation.
See also
beginInteraction | Event |
starling.events.Event
feathers.events.FeathersEventType.BEGIN_INTERACTION
Dispatched when the user starts interacting with the scroll bar's thumb, track, or buttons.
The properties of the event object have the following values:
Property | Value |
---|---|
bubbles | false |
currentTarget | The Object that defines the
event listener that handles the event. For example, if you use
myButton.addEventListener() to register an event listener,
myButton is the value of the currentTarget . |
data | null |
target | The Object that dispatched the event;
it is not always the Object listening for the event. Use the
currentTarget property to always access the Object
listening for the event. |
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 |
starling.events.Event
starling.events.Event.CHANGE
Dispatched when the scroll bar's value changes.
The properties of the event object have the following values:
Property | Value |
---|---|
bubbles | false |
currentTarget | The Object that defines the
event listener that handles the event. For example, if you use
myButton.addEventListener() to register an event listener,
myButton is the value of the currentTarget . |
data | null |
target | The Object that dispatched the event;
it is not always the Object listening for the event. Use the
currentTarget property to always access the Object
listening for the event. |
endInteraction | Event |
starling.events.Event
feathers.events.FeathersEventType.END_INTERACTION
Dispatched when the user stops interacting with the scroll bar's thumb, track, or buttons.
The properties of the event object have the following values:
Property | Value |
---|---|
bubbles | false |
currentTarget | The Object that defines the
event listener that handles the event. For example, if you use
myButton.addEventListener() to register an event listener,
myButton is the value of the currentTarget . |
data | null |
target | The Object that dispatched the event;
it is not always the Object listening for the event. Use the
currentTarget property to always access the Object
listening for the event. |
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.
Depending on the control, the result of the interaction may
continue after the interaction ends. For instance, a Scroller
may be "thrown", and the scrolling will continue animating after the
user has finished interacting with it.
DEFAULT_CHILD_NAME_DECREMENT_BUTTON | Constant |
public static const DEFAULT_CHILD_NAME_DECREMENT_BUTTON:String = feathers-scroll-bar-decrement-button
DEPRECATED: Replaced by ScrollBar.DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
See also
DEFAULT_CHILD_NAME_INCREMENT_BUTTON | Constant |
public static const DEFAULT_CHILD_NAME_INCREMENT_BUTTON:String = feathers-scroll-bar-increment-button
DEPRECATED: Replaced by ScrollBar.DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
See also
DEFAULT_CHILD_NAME_MAXIMUM_TRACK | Constant |
public static const DEFAULT_CHILD_NAME_MAXIMUM_TRACK:String = feathers-scroll-bar-maximum-track
DEPRECATED: Replaced by ScrollBar.DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
See also
DEFAULT_CHILD_NAME_MINIMUM_TRACK | Constant |
public static const DEFAULT_CHILD_NAME_MINIMUM_TRACK:String = feathers-scroll-bar-minimum-track
DEPRECATED: Replaced by ScrollBar.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
See also
DEFAULT_CHILD_NAME_THUMB | Constant |
public static const DEFAULT_CHILD_NAME_THUMB:String = feathers-scroll-bar-thumb
DEPRECATED: Replaced by ScrollBar.DEFAULT_CHILD_STYLE_NAME_THUMB
.
DEPRECATION WARNING: This property is deprecated starting with Feathers 2.1. It will be removed in a future version of Feathers according to the standard Feathers deprecation policy.
See also
DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON | Constant |
public static const DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON:String = feathers-scroll-bar-decrement-button
The default value added to the styleNameList
of the decrement
button.
See also
DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON | Constant |
public static const DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON:String = feathers-scroll-bar-increment-button
The default value added to the styleNameList
of the increment
button.
See also
DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK | Constant |
public static const DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK:String = feathers-scroll-bar-maximum-track
The default value added to the styleNameList
of the maximum
track.
See also
DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK | Constant |
public static const DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK:String = feathers-scroll-bar-minimum-track
The default value added to the styleNameList
of the minimum
track.
See also
DEFAULT_CHILD_STYLE_NAME_THUMB | Constant |
public static const DEFAULT_CHILD_STYLE_NAME_THUMB:String = feathers-scroll-bar-thumb
The default value added to the styleNameList
of the thumb.
See also
DIRECTION_HORIZONTAL | Constant |
public static const DIRECTION_HORIZONTAL:String = horizontal
The scroll bar's thumb may be dragged horizontally (on the x-axis).
See also
DIRECTION_VERTICAL | Constant |
public static const DIRECTION_VERTICAL:String = vertical
The scroll bar's thumb may be dragged vertically (on the y-axis).
See also
TRACK_LAYOUT_MODE_MIN_MAX | Constant |
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
using a special display object such as a Scale9Image
,
Scale3Image
or a TiledImage
that is
designed to be resized dynamically.
See also
TRACK_LAYOUT_MODE_SINGLE | Constant |
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.
See also