Vicon Shogun banner

Description

Adds a string that is specified by itemString to the drop list user control that is specified by userControlID.

Strings are added to the end of the drop list, unless the -insert flag is provided, in which case, the string is inserted at the index specified. If the -sort flag is provided with the createDropList command, the strings in the drop list appear in alphabetical order, and the -insert flag has no visible effect.

Functional area

User Window

Command syntax

Syntax

addDropListItem userControlID "itemString"[-insert integer]

Arguments

NameTypeRequiredComments
itemStringstringyesString to add to the drop list.
userControlIDintyesID of user control to operate on.

Flags

NameFlag argumentsArgument typeExclusive toComments
insert1integer

Return value

integer

Examples

// Add items to a Drop List User Control.
int $windowId;
int $controlId;
// First create a User Window to place the Control on
$windowId = `createWindow "MyWindow"`;

// Create the User Control on the Window. Don't use the
// sort flag so we can demonstrate how to insert vs. append.
$controlId = `createDropList $windowId`;

// Add some items to the Drop List. Insert one as well
addDropListItem $controlId "Item 1";
addDropListItem $controlId "Item 2";
addDropListItem $controlId "Item 3";
addDropListItem $controlId "Inserted!" -insert 1;

// Set the current selection to the first item
selectDropListItem $controlId 0;

Additional info

Related commands