Abstract

The ListBoxClass is a flexible and efficient boopsi gadget class which replaces the original GadTools LISTVIEW_KIND gadget and offers a lot more functionality. It's a subclass of the groupgclass and incorporates several other gadgets to build a full featured listview with vertical and horizontal scroll bars, a surrounding border and, of course, a ListView object.

The ListViewClass is a subclass of Intuition's gadgetclass which builds a plain listview gadget without any border or scroll bars. It handles selection of multiple items and it can be resized on the fly. The GFLG_REL#? attributes are fully supported and you can even display a list of images and other boopsi objects. Lists with multiple columns are possible but not yet implemented. Horizontal scrolling would also be easy to add. Usually you don't need to create objects from this class directly because the ListBoxClass will do it for you.

The LVDemo program demonstrates the usage of both classes. The ListViewClass is attached to scroll bars in the window borders. The demo is also a useful source of information on several Intuition and boopsi topics.

Introduction

I've started writing these classes because I needed a better ListView for XModule. Eventually it has now grown to a standalone project. While I was developing this class I had the idea to write some macros to replace the amiga.lib boopsi stubs, and so I made some useful header files that I'm now using in several other projects: BernieHeaders.lha [9KB].

Features

• Easy to use (almost a drop-in replacement for LISTVIEW_KIND)
• Can be resized and supports GREL_#? flags
• Multiple selection of items
• Notifies your boopsi sliders
• Multiple columns (TODO)
• Redraws quickly without clearing the display (improves solid window sizing)
• Horizontal scrolling (TODO)
• Items can be boopsi images as well as texts
• Using arrays instead of exec lists
• You can use boopsi label images instead of plain text
• You can use your own custom rendering hook
• You can use your own item-retriving callback hook
• List titles (TODO)
• Full Keyboard control (shift, alt and control key combos are supported)
• Asynchronous scrolling with inertia (TODO)
• OS 3.0 optimized (V39-only version also available)
• RTG friendly and optimized (no planar stuff in chunky bitmaps)
• Small code size! (less than 10KB)
• Written in C to be highly portable across compilers and CPUs
• Comes with source code with detailed comments
• Source code compiles with SAS/C, StormC and GCC
• Subclasses can be easlily derived from the base listview class

Source code

The full source code is distributed along with the binaries for educational pourposes. It will show you how to:

• Build a boopsi class on top of the gadgetclass
• Build a boopsi class on top of the groupgclass
• Write a boopsi gadget dispatcher with complex GM_DRAW and GM_HANDLEINPUT
• Use the boopsi sysiclass images
• Connect boopsi objects together using the icclass
• Overlay the buttongclass to make a scroll button
• Create a sizeable window with sliders
• Make a C program without startup
• Correctly opening/closing libraries, windows and other system resources

License

This software is distributed under the GNU General Public License.

Distribution You can download the binary and source code distribution archive right here:

BoopsiListView.lha V1.7 ALPHA [164KB]

BoopsiListView.lzx V1.7 ALPHA [118KB]

BoopsiListView (unpacked) V1.7 ALPHA

Three different binary versions are provided:

• LVDemo_Generic

  Works even on plain 68000 systems and includes OS 2.0 support

• LVDemo_020_OS30

  Optimized for 68020, no OS 2.0 support

• LVDemo_Trace

  Outputs debug messages with kprintf(), which you can view by hooking a terminal to the serial port or with a debug tool such as sushi or Sashimi.

Copyright © 1999,2007 by Bernie Innocenti
$Id: BLV.html,v 1.3 2000/01/12 19:48:53 bernie Exp $