| |
CImageSet:Insert
The Insert method adds a CImage to the image set prior to a specified index. For example, to add an image at the beginning of the set, before all other members, insert at position 1. A reference to the existing CImage is saved into the image set; no memory is allocated for a new image.
|
CImageSet:Insert( CImage, index ) |
CImage is the image object to insert.
index is a number that specifies the insertion
point, beginning at 1.
The CImage is inserted prior to the image set member existing at position index. This moves all the members down in the list in order to open up the new position at index. A reference to the target CImage is then saved at the new position.
Suppose a CImageSet exists with name S and that it contains 10 images. The following script fragment inserts a CImage I at index 5:
|
I = CImage:new() |
-- create a CImage |
|
local sPath, bOk = GetFileName() |
-- use the Open dialog to get a filename |
|
if ( not bOk ) then Exit() end |
-- exit the loop after hitting Cancel |
|
I:Open(sPath) |
-- load the image |
|
S:Insert( I, 5 ) |
-- Insert the new member at position 5 |
|
end |
|
|
Printf("Count=%d", S:Count() ) |
-- result: Count=11 |