This information is for Vicon Shogun 1.7. For up-to-date help, see the latest Shogun documentation.

Vicon Shogun banner


Selects an item in the list box user control that is specified by userControlId. Selected items appear highlighted in the list.

If the -multi flag was specified with the createListBox command, this command adds to the current list box selection. Otherwise, the command replaces the current selection.

To remove selection, pass a -1 as the index argument.

Functional area

User Window

Command syntax


selectListBoxItem userControlID index


indexintyesZero based index of the item to select.
userControlIdintyesID of user control to operate on.



Return value



// Select an item in a List Box User Control.
int $windowId;
int $controlId;
int $index;

// First create a User Window to place the Control on
$windowId = `createWindow "MyWindow"`;

// Create the User Control on the Window.
$controlId = `createListBox $windowId`;

// Add some items to the List Box.
addListBoxItem $controlId "Item 1";
$index = `addListBoxItem $controlId "Item 2"`;
addListBoxItem $controlId "Item 3";

// Select the item whose index we just got.
selectListBoxItem $controlId $index;

Additional information

Related commands