The scrolllistbox widget is a listbox with optional associated horizontal and vertical scrollbars. It has very nearly the same interface as the standard listbox widget.

The scrolllistbox widget supports all listbox widget events.

All events which are emitted by the underlying listbox are forwarded and will be seen to be emitted by the scrolllistbox.

Direct access to the underlying listbox is provided by the listbox function. This is necessary in order to support popup help on scrolllistboxes. Popup help uses the tlead argument in constructing the outframe. The value of that argument needs to be one of the underlying widgets hence the need to return a reference to the listbox used in scrolllistbox. Care should be taken in using this as it allows the user to destroy the underlying listbox.

Note that most of the functions listed here are actually events. These include hscrollbar, scrolllistbox, seeonsert, and vscrollbar. In addition to these events, any valid listbox event can be sent to the scrolllistbox.

Example

include 'scrolllistbox.g'   
f := frame()
slb := scrolllistbox(f)
slb->insert("one two three four five six seven eight nine")
# you decide you don't want the horizontal scrollbar
slb->hscrollbar(F)
# you decide you don't want the widget to always show the end
# after each insert event
slb->seeoninsert(F)
# you want to get the current selection(s), if any
s := slb->selection();

---

• scrolllistbox - Constructor
• scrolllistbox.listbox - Function
• scrolllistbox.done - Function
• scrolllistbox.hscrollbar - Function
• scrolllistbox.vscrollbar - Function
• scrolllistbox.seeoninsert - Function

---

Next: scrolllistbox - Constructor Up: widgets - Module Previous: saveregions.settable - Function   Contents   Index

Please send questions or comments about AIPS++ to aips2-request@nrao.edu.
Copyright © 1995-2000 Associated Universities Inc., Washington, D.C.
Return to AIPS++ Home Page
2006-10-15