Applies to
ListView, TreeView controls
Description
PowerBuilder stores ListView images in several indexed arrays of images. State pictures are displayed to the left of ListView items and their pictures, if they have them.
You can associate a state image with a ListView control only with scripts.
You identify a specific image by its index number.
Usage
In a painter
To specify State images:
-
Select the State tab page from the ListView control's Properties view.
-
Do one of the following:
-
In the rows provided in the Picture Name field, type the complete path or URL address and name of the files containing the desired pictures.
-
Use the Browse button.
-
Select one or more pictures from the Stock Pictures list.
-
-
Use the row numbers from this Picture Name list as the index number when setting the State picture index in scripts.
In scripts
The StatePictureName property takes a string value. You cannot use the StatePictureName property to update the image list during execution. Use the AddStatePicture function to add State pictures to a ListView control. For example:
integer index
index = lv_1.AddStatePicture("c:\ArtGal\ico\star.ico")
lv_1.StatePictureIndex = indexinteger index
listviewitem lvi_1
lv_1.GetItem(lv_1.SelectedIndex (), lvi_1)
index = lv_1.AddStatePicture("http://172.16.5.175/listview.jpg")
lvi_1.StatePictureIndex = index
lv_1.SetItem(lv_1.SelectedIndex (), lvi_1)
For more information about scripting ListView controls, see the section called “Using ListView controls” in Application Techniques.
