Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

scrolllistbox - Tool

	Package	display
	Module	widgets

Postscript file available

A Tk listbox with optional scrollbars.

include "scrolllistbox.g"

Constructors

scrolllistbox	Construct a scrolllistbox

Functions

done	Destroy ourselves
hscrollbar	Turn on or off the horizontal scrollbar
listbox	Return the underlying listbox agent
seeoninsert	See the end after each insert?
vscrollbar	Turn on or off the vertical scrollbar

Description

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();