/
setListViewItemCheck
setListViewItemCheck
Description
Enables you to set the checked state of a list view item. Only list views created with the -checkBoxes
flag should call this command.
Functional area
User Window
Command syntax
Syntax
setListViewItemCheck userControlID row checked |
Arguments
Name | Type | Required | Comments |
---|---|---|---|
userControlID | integer | yes | ID of the list view item to operate on |
row | integer | yes | Zero-based index of the row whose checked state will be set |
checked | boolean | yes | The new checked state. |
Flags
None
Return value
void
Examples
// Demonstrate usage of a List View User Control int $windowID, $listViewID, $formID; // Destroy window if it already exists if( `windowExists "ListViewTesting"` == true ) { destroyWindow "ListViewTesting"; } // Create window and list view and position them $windowID = `createWindow "ListViewTesting"`; $formID = `getTopLevelForm $windowID`; $listViewID = `createListView $windowID -form $formID -checkBoxes`; setControlAnchor $listViewID "left" "left" 3; setControlAnchor $listViewID "top" "top" 3; setControlAnchor $listViewID "right" "right" 3; setControlAnchor $listViewID "bottom" "bottom" 3; // Create the columnsstring $columns[3]; int $widths[3]; $columns[0] = "Name"; $columns[1] = "Age"; $columns[2] = "Gender"; $widths[0] = 150; $widths[1] = 50; $widths[2] = 100; setListViewColumns $listViewID $columns $widths; // Add some items to the list view. The text we supply is for the first // column. // We supply text for subsequent columns using setListViewItemText addListViewItem $listViewID "Bob"; addListViewItem $listViewID "Mary"; addListViewItem $listViewID "Jim"; addListViewItem $listViewID "Ann"; // Set additional details setListViewItemText $listViewID 0 1 "50"; setListViewItemText $listViewID 0 2 "Male"; setListViewItemText $listViewID 1 1 "32"; setListViewItemText $listViewID 1 2 "Female"; setListViewItemText $listViewID 2 1 "21"; setListViewItemText $listViewID 2 2 "Male"; setListViewItemText $listViewID 3 1 "44"; setListViewItemText $listViewID 3 2 "Female"; // Set the check box to true for the males. setListViewItemCheck $listViewID 0 true; setListViewItemCheck $listViewID 2 true; // Change Bob`s name setListViewItemText $listViewID 0 0 "Ken"; // Select Mary and Jim selectListViewItem $listViewID 2 true; selectListViewItem $listViewID 1 true; // Print out some of what we just did print( `getListViewSelItems $listViewID` ); print( `getListViewItemText $listViewID 1 2` ); print( `getListViewItemCheck $listViewID 1` ); print( `getListViewItemCheck $listViewID 0` ); layoutForm $formID;
Additional information
Related commands
, multiple selections available,
Related content
setListViewHandler
setListViewHandler
More like this
selectListViewItem
selectListViewItem
More like this
setListViewItemText
setListViewItemText
More like this
setListViewColumns
setListViewColumns
More like this
getListViewItemText
getListViewItemText
More like this
getListViewSelItems
getListViewSelItems
More like this