Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

synclistboxes.insert - Function

	Package	display
	Module	widgets
	Tool	synclistboxes

insert values into the listboxes

Synopsis
insert(values)

Arguments

values		insert these values
		Allowed:	A vector or matrix of strings

Description
In order to remain in sync, the listboxes must always each have the same number of items as the other listboxes. This is enforced by making the delete event apply to all listboxes and requiring that the insert event value have a integer multiple of nboxes elements. For a single vector there must be exactly nboxes elements. Each element is then placed in each listbox in order. To place multiple elements in each listbox using a single insert event, the value of that event should have a shape equal to [nboxes, nelements]. In other words, to place 7 elements into each of 3 listboxes the insert value must have a shape of [3, 7].

Insertions are currently all done at the end of the listboxes.

Example

# slb is a previously created synclistboxes having 2 listboxes
# insert 9 elements.
somevals := array(' ',2,9);
somevals[1,] := "one two three four five six seven eight nine";
somevals[2,] := "red orange yellow lightgrey blue brown peach mauve gold";
slb->insert(somevals);