combobox.insert - Function

Insert an item into the combobox.

Synopsis
insert(newitem, index, select)

Arguments

newitem	The thing to insert
	Allowed:	A string
index	Its new location
	Allowed:	Any index <= largest index + 1
	Default:	F
select	Select this item
	Allowed:	T or F
	Default:	F

Returns
T

Description
If index is F then the current autoinsertorder determines which and of the list of items this item is added at. If an index is specified, all of the existing items from that index to the end are moved to the next location (i.e. an insert at location 5 results in the indexes of 5 to the end being now 6 to the new end). This may cause the index of the current selection to change. As with the glishtk listbox, the index numbers here are 0-relative (i.e. the first item is item number 0). ``selected'' translates to the index of the current selection, ``end'' translates to the last item in the combobox. insert() returns a fail if the index is out of range (more than 1 larger than the current largest index). If select is T, this item will be selected after insertion.

Next: combobox.insertentry - Function Up: combobox - Tool Previous: combobox.delete - Function Contents Index

	Package	display
	Module	widgets
	Tool	combobox