AddStatePicture
PowerScript function
Description
Adds a bitmap, icon, or cursor to the state image list.
Applies to
ListView and TreeView controls
Syntax
|
1 |
controlname.AddStatePicture ( picturename ) |
|
Argument |
Description |
|---|---|
|
controlname |
The name of the ListView or TreeView control to which |
|
picturename |
The name of the bitmap, icon, or cursor you are |
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:
|
1 2 3 |
//Add state picture integer index index = lv_files.AddStatePicture("star.ico") |
See also