ControlListBox - a SuperWaba scrolling container widget

Introduction:

ControlListBox is 'yet another' scrollable container widget for SuperWaba programs that is a bit like a normal listbox, except that instead of being only able to add text items, you can add arbitrary controls.

Features:

• clean looking
• easy to use
• can arbitrarily append, insert and delete child controls
• scrolling is pixel-oriented, not item oriented
• scrollbar appears only when needed
• several scrolling methods

Anatomy:

  ControlListBox object (a Container subclass)
    |
    +-- viewport Container
    |    |
    |    +--- content Container
    |           |
    |           +-- whatever widgets you add()
    |
    +-- ScrollBar

      

Limitations:

• no horizontal scrolling

Roadmap:

• allow more styling (eg background colours)
• implement horizontal scrolling
• allow highlight-on-selection
• selection cursor
• (your ideas here?)

Demo page

If you want, you can see a ControlListBox widget in action, via a browser applet. Click here.

The applet is about 256k, and should load in less than a minute on most connections

Download:

You can download this tarball, which contains:

• The java source for the ControlListBox widget
• A demo program which uses this widget
• Full javadoc API documentation for the ControlListBox widget

Author:

Contact David -- rebirth at orcon dot net dot nz