FormListControl.singleSelection Method
Indicates whether multiple items can be selected in a form list control.
Syntax
public boolean singleSelection([boolean value])
Run On
Client
Parameters
- value
Type: boolean
A Boolean data type that indicates whether multiple items can be selected in a form list control.
Return Value
Type: boolean
true if multiple items cannot be selected; otherwise, false.
Remarks
Call the singleSelection method before you add items to a form list control; otherwise, the items do not appear in the control.
Examples
The following example shows a call to the singleSelection method to specify that multiple items can be selected.
The while select statement retrieves account numbers from the CustTable table and then stores the data in a container. The items in the variable are added to the form list control by calling the FormListControl.addItem method.
static void testFormListControl(Args _args)
{
Args args;
Form form;
FormRun formRun;
FormBuildDesign formBuildDesign;
FormBuildDataSource formBuildDataSource;
FormBuildListControl formBuildListControl;
FormListControl formListControl;
FormListItem formListItem;
FormListColumn formListColumn1;
FormListColumn formListColumn2;
FormListColumn formListColumn;
DictTable dictTable;
int idx4;
str string;
container conAccountNum;
CustTable custTable;
int numAccounts;
int i;
int item;
int numItems;
boolean columnAdd;
// Create the form header.
form = new Form();
// Add data sources to the form.
dictTable = new DictTable(tableNum(custTable));
formBuildDataSource = form.addDataSource(dictTable.name());
formBuildDataSource.table(dictTable.id());
// Create the form design.
formBuildDesign = form.addDesign("Design");
formBuildDesign.caption("myForm");
// Add a form list control.
formBuildListControl =
formBuildDesign.addControl(FormControlType::ListView,"List");
idx4 = formBuildListControl.id();
args = new Args();
args.object(form);
// Create the run-time form.
formRun = classfactory.formRunClass(args);
formRun.run();
formRun.detach();
formListControl = formRun.control(idx4);
formListControl.viewType(FormListViewType::List);
formListControl.height(120);
formListControl.singleSelection(false);
// Add items to the form list control.
while select custTable
where custTable.AccountNum >=
"4000" && custTable.AccountNum <= "4040"
{
conAccountNum += [[custTable.AccountNum]];
}
numAccounts = conlen(conAccountNum);
for(i = 1; i <= numAccounts; i++)
{
string = conPeek(conAccountNum,i);
formListItem = new FormListItem(string);
item = formListControl.addItem(formListItem);
}
}