Tcl/Tk in a Nutshell

Name

listbox

listbox pathName [option value...]

The listbox command creates a new listbox widget named pathName. A listbox is a widget that displays a list of strings, one per line. When first created, a new listbox has no elements. Elements can be added, deleted, and selected using methods described here.

Many listbox methods take index arguments to identify elements. Listbox indices are numbered starting at 0. Special index values are active, anchor, end, and @ x,y.

Standard Options

-background	-borderwidth	-cursor
-exportselection	-font	-foreground
-highlightbackground	-highlightcolor	-highlightthickness
-relief	-selectbackground	-selectborderwidth
-selectforeground	-setgrid	-takefocus
-xscrollcommand	-yscrollcommand

Widget-Specific Options

-height height (height, Height)

Desired height of listbox in lines. If zero or less, the height is made just large enough to hold all lines.

-selectmode mode (selectMode, SelectMode)

Specifies one of several styles understood by the default listbox bindings for manipulation of the element selection. Supported styles are single, browse, multiple, and extended. Any arbitrary string is allowed, but the programmer must extend the bindings to support it.

-width width (width, Width)

Desired width of listbox in characters. If zero or less, the width is made just large enough to hold the longest element.

Methods

pathName active index

Set the active element to the one at index.

pathName bbox index

Return a list of numbers in the format {x y width height} describing the bounding box ...