ImageList_New

<< Click to Display Table of Contents >>

Navigation:  ThinBASIC Modules > UI (User Interface) > CONTROLS > Control Types > ImageList Control > ImageList Control Commands >

ImageList_New

 

Description

 

Creates a new ImageList structure and return its handle.

 

Syntax

 

iList = ImageList_New(ICON | BITMAP, Width, Height, ColorDepth [, InitialItems])

 

Returns

 

Number

The handle of the created ImageList, or zero if the operation failed.

 

Parameters

 

Name

Type

Optional

Meaning

ICON | BITMAP

Keyword

No

If you specify BITMAP, each image you add will be stored as a single bitmap.

If you specify ICON, each image you add will be stored as two bitmaps in order to support transparent areas.

Width

Number

No

Width of each image in pixels

Height

Number

No

Height of each image in pixels

ColorDepth

Number

No

Specifies the color depth in bits per pixel: 4, 8, 16, 24, 32

A depth of 4 offers 16 colors, 8 offers 256 colors, ...

InitialItems

Number

Yes

Specifies the initial size (number of objects) of the ImageList.

ImageList can grow beyond this number.

 

If InitialItems is <= 0, 1 will be assumed

 

Remarks

 

Restrictions

 

See also

 

Examples