CS3 JS: Scrollbar

CS3 ScriptUI

Scrollbar

 

A scrollbar with a draggable scroll indicator and stepper buttons to move the indicator.

The scrollbar control has a horizontal orientation if the width is greater than the height at creation time, or vertical if its height is greater than its width. Calls the onChange callback after the position of the indicator is changed or if its notify() method is called. Calls the onChanging callback repeatedly while the user is moving the indicator. Scrollbars are often created with an associated EditText field to display the current value of the scrollbar, and to allow setting the scrollbar's position to a specific value.

QuickLinks

addEventListener, dispatchEvent, hide, notify, onChange, onChanging, onShortcutKey, removeEventListener, show

Properties

PropertyTypeAccessDescription
activeboolr/w

True if this element is active.

An active control is the one with keyboard focus—that is, the one that accepts keystrokes, or in the case of a Button, is selected when the user types Return or Enter in Windows, or the space bar in Mac OS.

alignmentStringr/w

The alignment style for this element. If defined, this value overrides the alignChildren setting for the parent container.

This can be a single string, which indicates the alignment for the orientation specified in the parent container, or an array of two strings, indicating both the horizontal and vertical alignment (in that order). Allowed values depend on the orientation value of the parent container. They are not case sensitive.

- For orientation=row:top, bottom, fill

- For orientation=column: left, right, fill

- For orientation=stack:top, bottom, left, right, fill

boundsBoundsr/w

The boundaries of the element, in parent-relative coordinates.

Setting an element's size or location changes its bounds property, and vice-versa.

childrenArray of ObjectreadonlyAn array of child elements.
enabledboolr/w

True if this element is enabled.

An enabled element can accept input, according to its type. When false, control elements do not accept input, and all types of elements have a dimmed appearance.

graphicsScriptUIGraphicsreadonlyThe graphics object that can be used to customize the element's appearance, in response to the onDraw event.
helpTipStringr/wThe help text that is displayed when the mouse hovers over the element.
indentNumberr/w

The number of pixels to indent the element during automatic layout.

Applies for column orientation and left alignment, or row orientation and top alignment.

jumpdeltaNumberr/w

The amount to increment or decrement a scrollbar indicator's position when the user clicks ahead or behind the moveable element.

Default is 20% of the range between the maxvalue and minvalue property values.

locationPointr/w

The upper left corner of this element relative to its parent.

The location is defined as [bounds.x, bounds.y]. Setting an element's location changes its bounds property, and vice-versa.

maximumSizeDimensionr/w The maximum height and width to which the element can be resized.
maxvalueNumberr/w

The maximum value allowed in the value property.

Together with minvalue, sets the scrolling range. Default is 100.

minimumSizeDimensionr/w The minimum height and width to which the element can be resized.
minvalueNumberr/w

The minimum value allowed in the value property.

Together with maxvalue, sets the scrolling range.Default is 0.

parentObjectreadonlyThe parent element.
preferredSizeDimensionr/w

The preferred size, used by layout managers to determine the best size for each element.

If not explicitly set by a script, value is established by the UI framework in which ScriptUI is employed, and is based on such attributes of the element as its text, font, font size, icon size, and other UI framework-specific attributes.A script can explicitly set preferredSize before the layout manager is invoked in order to establish an element size other than the default.

propertiesObjectr/w

An object that contains one or more creation properties of the container (properties used only when the element is created).

A Scrollbar object has no creation properties. The third argument of the add() method that creates it is the initial value, and the fourth and fifth arguments are the minimum and maximum values of the range.

shortcutKeyStringr/wThe key sequence that invokes the onShortcutKey callback for this element (in Windows only).
sizeDimensionr/w

The current dimensions of this element.

Initially undefined, and unless explicitly set by a script, it is defined by a LayoutManager. A script can explicitly set size before the layout manager is invoked to establish an element size other than the preferredSize or the default size, but this is not recommended. Defined as [bounds.width, bounds.height]. Setting an element's size changes its bounds property, and vice-versa.

stepdeltaNumberr/wThe amount by which to increment or decrement a Scrollbar element's position when the user clicks a stepper button.
typeStringreadonlyThe element type, "scrollbar".
valueNumberr/w

The current position of the indicator.

If set to a value outside the range specified by minvalue and maxvalue, it is automatically reset to the closest boundary.

visibleboolr/w

True if this element is shown, false if it is hidden.

When a container is hidden, its children are also hidden, but they retain their own visibility values, and are shown or hidden accordingly when the parent is next shown.

windowWindowreadonlyThe window that this element belongs to.
windowBoundsBoundsreadonlyThe bounds of this element relative to the top-level parent window.

Methods

bool addEventListener (eventName:String, handler:Function [, capturePhase:bool=false])
Registers an event handler for a particular type of event occuring in this element.

ParameterTypeDescription
eventNameString

The name of the event.

Event names are listed in the JavaScript Tools Guide.

handlerFunction

The function that handles the event.

This can be the name of a function defined in the extension, or a locally defined handler function to be executed when the event occurs. A handler function takes one argument, the UIEvent object.

capturePhasebool

When true, the handler is called only in the capturing phase of the event propagation. (default: false)

Default is false, meaning that the handler is called in the bubbling phase if this object is an ancestor of the target, or in the at-target phase if this object is itself the target.

Event dispatchEvent ()
Simulates the occurrence of an event in this target.

A script can create a UIEvent object for a specific event and pass it to this method to start the event propagation for the event.

void hide ()
Hides this element.

void notify (eventName:String)
Sends a notification message, simulating the specified user interaction event.

ParameterTypeDescription
eventNameString

The name of the control event handler to call.

One of: onClick, onChange, onChanging. By default, simulates the onChange event for an edittext control, an onClick event for controls that support that event.

void onChange ()
An event-handler callback function, called when the user has finished dragging the position indicator, or has clicked the control.

void onChanging ()
An event-handler callback function, called when the content of the element is in the process of changing

The handler is called for any motion of the position indicator while this control has the input focus.

void onShortcutKey ()
An event-handler callback function, called when the element's shortcutKey sequence is typed in the active window.

In Windows only.

bool removeEventListener (eventName:String, handler:Function [, capturePhase:bool=false])
Unregisters an event handler for a particular type of event occuring in this element.

All arguments must be identical to those that were used to register the event handler.

ParameterTypeDescription
eventNameStringThe name of the event.
handlerFunctionThe function that handles the event.
capturePhaseboolWhether to call the handler only in the capturing phase of the event propagation. (default: false)

void show ()
Shows this element.

When a window or container is hidden, its children are also hidden, but when it is shown again, the children retain their own visibility states.

Contents :: Index