/
getListViewItemText
getListViewItemText
Description
Gets a List View item value.
This command returns the value of the text at a list view row and column location. Row and column index values are zero-based.
Functional area
User Window
Command syntax
Syntax
getListViewItemText userControlID itemRow itemColumn |
Arguments
Name | Type | Required | Comments |
---|---|---|---|
userControlID | integer | yes | ID of the user control to operate on |
itemRow | integer | yes | Zero based row index of the item in the list view |
itemColumn | integer | yes | Zero based column index of the item in the list view |
Flags
None
Return value
string
Returns the string value of the list view item
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 columns string $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
setListViewItemText
setListViewItemText
More like this
getListViewSelItems
getListViewSelItems
More like this
selectListViewItem
selectListViewItem
More like this
getNumListViewItems
getNumListViewItems
More like this
setListViewColumns
setListViewColumns
More like this
setListViewItemCheck
setListViewItemCheck
More like this