Sets the value of an item in a list.
For use with DataWindows and DataStores, see the SetItem method for DataWindows in the DataWindow Reference or the online Help.
To set the values of |
Use |
---|---|
A ListView control item |
|
A ListView control item and column |
|
A TreeView control item |
Sets data associated with a ListView item to the property values you specify in a ListViewItem variable.
ListView controls
listviewname.SetItem ( index, { column }, item )
Argument |
Description |
---|---|
listviewname |
The ListView for which you are setting item properties |
index |
The index number of the item for which you are setting properties |
column |
The index number of the column of the item for which you want to set properties |
item |
The ListViewItem variable containing property values you want to assign to a ListView item |
Integer. Returns 1 if it succeeds and -1 if an error occurs.
You can set properties for any ListView item with this syntax. If you do not specify a column, SetItem sets properties for the first column of an item. Only report views display multiple columns.
To add items to a ListView control, use the AddItem function. To add columns to a ListView control, use AddColumn. To set display values for the columns of a ListView item, use Syntax 2.
If you want to set column properties, such as alignment or width, use SetColumn. These column properties are independent of the ListViewItem objects.
To change pictures and other property values associated with a ListView item, use GetItem, change the property values, and use SetItem to apply the changes back to the ListView.
This example uses SetItem to change the state picture index for the selected lv_list ListView item:
listviewitem lvi_1
lv_list.GetItem(lv_list.SelectedIndex( ), lvi_1)
lvi_1.StatePictureIndex = 2
lv_list.SetItem(lv_list.SelectedIndex () , lvi_1)
Sets the value displayed for a particular column of a ListView item.
ListView control
listviewname.SetItem ( index, column, label )
Argument |
Description |
---|---|
listviewname |
The ListView control for which you are setting a display value |
index |
The index number of the item for which you are setting a display value |
column |
The index number of the column for which you want to set a display value |
label |
The string value or variable which you are assigning to the specified column of the specified ListView item |
Integer. Returns 1 if it succeeds and -1 if an error occurs.
You must include the column number as an argument, even if you are only assigning values to a single-column ListView control. To specify the properties for a ListView item, use Syntax 1.
This example assigns display values to three columns in a report view for three lv_list ListView items:
listviewitem l_lvi
integer li_count, li_index
FOR li_index = 1 to 3
li_count=li_count+1
lv_1ist.AddItem("Category " + String(li_index), 1)
NEXT
lv_list.AddColumn("Composition", Left! , 860)
lv_list.AddColumn(" Album", Left! , 610)
lv_list.AddColumn(" Artist", Left! , 710)
lv_list.SetItem(1 , 1 , "St. Thomas")
lv_list.SetItem(1 , 2 , "The Bridge")
lv_list.SetItem(1 , 3 , "Sonny Rollins")
lv_list.SetItem(2 , 1 , "So What")
lv_list.SetItem(2 , 2 , "Kind of Blue")
lv_list.SetItem(2 , 3 , "Miles Davis")
lv_list.SetItem(3 , 1 , "Goodbye, Porkpie Hat")
lv_list.SetItem(3 , 2 , "Mingus-Ah-Um")
lv_list.SetItem(3 , 3 , "Charles Mingus")
Sets the data associated with a specified item.
TreeView controls
treeviewname.SetItem ( itemhandle, item )
Argument |
Description |
---|---|
treeviewname |
The name of the TreeView control in which you want to set the data for a specific item |
itemhandle |
The handle associated with the item you want to change |
item |
The TreeView item you want to change |
Integer. Returns 1 if it succeeds and -1 if an error occurs.
Typically, you would call GetItem first, edit the data, and then call SetItem to reflect your changes in the TreeView control.
This example uses the ItemExpanding event to change the picture index and selected picture index of the current TreeView item:
treeviewitem l_tvi
long ll_tvi
ll_tvi = tv_list.FindItem(CurrentTreeItem! , 0)
tv_list.GetItem(ll_tvi , l_tvi)
l_tvi.PictureIndex = 5
l_tvi.SelectedPictureIndex = 5
tv_list.SetItem( ll_tvi, l_tvi )