Description
Adds a bitmap, icon, or cursor to the state image list.
Applies to
ListView and TreeView controls
Syntax
controlname.AddStatePicture ( picturename )
|
Argument |
Description |
|---|---|
|
controlname |
The name of the ListView or TreeView control to which you are adding a bitmap, cursor, or icon |
|
picturename |
The file path or URL address of the bitmap, icon, or cursor you are adding |
Return value
Integer.
Returns the picture index if it succeeds and -1 if an error occurs.
Usage
For ListViews in large icon view, the state picture is a picture displayed to the left of the large picture, by default in a smaller size. For TreeViews, the state picture is displayed to the left of the regular picture and the item is moved to the right to make room for it.
If you specify either StatePictureWidth or StatePictureHeight, the picture is scaled to the size specified by that property.
When a you add a bitmap, specify the color in the bitmap that will be transparent by setting the StatePictureMaskColor property before calling AddPicture. You can change the StatePictureMaskColor property between calls.
Examples
This example adds the file star.ico to the state picture index of the ListView lv_files:
//Add state picture
integer index
index = lv_files.AddStatePicture("star.ico")See also
