Name

scrollbar — Provides a standard scrollbar.

Synopsis

LZX: scrollbar
JavaScript: scrollbar
Type: Class
Access: public
Topic: Components.Laszlo Components
Declared in: lps/components/lz/scrollbar.lzx

Description

By default, the scrollbar tag creates a vertical scrollbar. Setting axis="x" produces a horizontal scrollbar. If you do not specify a scrolltarget, the scrollbars will also control their own layout: the vertical scrollbar will be aligned the the right of the parent view and horizontal scrollbar will be aligned to the bottom.

Typically one or two scrollbars and a single view that is the contents to be scrolled, the scrolltarget, are contained within a parent view with clip=true. The scrolling effect is produced by moving the scrolltarget while its visible region is clipped by the parent view.

Example 48. Simple scrollbar

          <canvas height="100">
          <view name="main" width="100" height="80" clip="true">
          <view name="contents">
          <text multiline="true">
          1<br/>2<br/>3<br/>4<br/>5<br/>6<br/>7<br/>8<br/>9<br/>10
          </text>
          </view>
          <scrollbar/>
          </view>
          </canvas>
        

In the example above, the scrolltarget is the 'contents' view. A scrollbar moves its scrolltarget along its axis. The attribute that is controlled by the scrollbar may be specified as the scrollattr, overriding the default value of x or y.

A scrollbar manipulates the x or y position of a target view that is clipped by its parent, creating a scrolling effect when the user clicks up/down arrows, clicks on the scroll track or drags the thumb.

Superclass Chain

node (LzNode) » view (LzView) » basecomponent » basescrollbar » scrollbar

Known Subclasses

Details

Properties (1)

disabledbgcolor
<attribute name="disabledbgcolor" value="null" />
public var disabledbgcolor;
If this is defined, it will be used as the scrollbar's background color when it is disabled. If not provided, the scrollbar will use the bgcolor of its closest parent that has a bgcolor defined.

LZX Synopsis

<class name="scrollbar" extends=" basescrollbar ">
  <attribute name=" disabledbgcolor " value="null" />
</class>

JavaScript Synopsis

public scrollbar extends  basescrollbar  {
  public var disabledbgcolor ;
}