VxList


Create a List allowing titles and labels

Syntax

VxList object_name [-title title ] [-label label ] VtListArgs

Description

Creates a VtList, allowing -title and -label. Returns the widget name of the List created.

Parameters

object_name
The widget hierarchy of the List.

-title
Creates a Form around the List widget and attaches a Label above it. The Label is attached to the top side of the Form. The List widget is attached to the left, right and bottom sides of the Form and also to the bottom side of the Label.

-label
Creates a Form around the List widget and attaches a Label to the left side of it. The Label is attached to the top and bottom of the Form. The List widget is attached to the right, top and bottom sides of the Form.

VtListArgs
Any argument(s) legal for VtList.

Example

The following code produces a List with a title.

set app [VtOpen "Demo"]
set form [VtFormDialog $app.form -title "VxList Demo"]

set list [VxList $form.list \
	-title "Which fruit do you like?" \
	-rows 6 \ 
	-columns 25 \
	-selection MULTIPLE \
	-itemList {Apple Banana Kumquat Mango Grape Pineapple Grapefruit} ]

VtShowDialog $form
VtMainLoop

This code produces the following:

Notes

Returns the widget name of the list created. To get the widgetName of the Label or Form that is created using this command use VxGetVar. For example:

VxGetVar $widgetName "form"
or
VxGetVar $widgetName "label"