<vscrollbar>

This tag creates a vertical scrollbar. If you do not specify a scrolltarget the scrollbar will automatically be aligned to the right and size its height to its parent's height. It is expected that the parent view be smaller than the scrolltarget and set clip=true. The scrolling effect is produced by moving the scrolltarget while its visible region is clipped by the parent view.

If you would like the target view to start scrolled, simply set its y position to a negative number. For example, y=-10 will cause the view to be scrolled 10 pixels.

Note: If you have no horizontal scrollbars in your application, using the <vscrollbar> tag will make the applications slightly smaller, than if you were to use <scrollbar axis="y">.

Example 1. Simple scrollbar

<canvas height="160" bgcolor="silver">
  <view name="main" x="20" y="20" bgcolor="white"
        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>
    <vscrollbar/>
  </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.