AddLargePicture PowerScript function
Description
Adds a bitmap, icon, or cursor to the large image list.
Controls
ListView controls
Syntax
|
1 |
<span>listviewname</span>.<span>AddLargePicture</span> ( <span>picturename</span> ) |
|
Argument |
Description |
|---|---|
|
listviewname |
The name of the ListView control to which |
|
picturename |
The name of the bitmap, icon, or cursor |
Return Values
Integer. Returns the picture index if
it succeeds and -1 if an error occurs.
Usage
When you add a large picture to a ListView, it is given the
next available picture index in the ListView. For example, if your
ListView has two pictures, the next picture you add will be assigned
picture index number 3.
Before you add large pictures, you can specify scaling for
the pictures by setting the LargePictureWidth and LargePictureHeight
properties. The dimensions in effect when you add the first picture
determine the scaling for all pictures. Changing the property values
after you add pictures has no effect.
If you do not specify values for LargePictureWidth and LargePictureHeight before
you add pictures, the dimensions of the first image determine the
scaling for all pictures you add.
When you add a bitmap, specify the color in the bitmap that
will be transparent by setting the LargePictureMaskColor property
before calling AddLargePicture. You can change
the LargePictureMaskColor property between calls.
Examples
This example adds the file folder.ico“to
the large picture index of the ListView lv_files:
|
1 |
// Add large picture |
|
1 |
integer index |
|
1 |
index = lv_files.<span>AddLargePicture</span>("folder.ico") |