LoadImageSheet (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Numbered drawings
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

LoadImageSheet (Function)

In french: ChargePlancheImage

Loads an image set in memory so that it can be used later by gImage.

Example

// L'image MULTI.BMP est composée de 130 composantes
// Le cadre autour de chacune de ces composantes ne sera pas affiché
LoadImageSheet(2, "MULTI.BMP", 16, 16)
// Affichage des images dans une liste graphique
FOR Indice = 1 TO 10*13
ListAdd(LISTE_ListeGrahique, gImage(2, Indice))
END

Syntax

<Result> = LoadImageSheet(<Image identifier> , <Image name> , <Image width> , <Image height> [, <Border>])

<Result>: Boolean

True if the image set was loaded in memory,
False otherwise.

<Image identifier>: Integer

Identifier of image loaded in memory (included between 1 and 9). If this identifier is already used, the loaded image replaces the previous image. This identifier will be used by gImage.

<Image name>: Character string

Name and full (or relative) path of image to load. A UNC path can be used.

<Image width>: Integer

Width of an image found in the image set.

<Image height>: Integer

Height of an image found in the image sheet.

<Border>: Optional character

"C" if no border must be displayed around each drawing. By default, a 1-pixel border is displayed around each drawing found in the image sheet.

Remarks

Numbered drawings

The image sets includes several drawings organized in rows and columns. All these drawings must have the same size and they can be enclosed in a 1-pixel border.

Drawings are numbered from 1 to <Number of rows> * <Number of columns> from left to right and from top to bottom.

Remarks:

Unlike LoadImage, if the number of drawings changes in the image, the images displayed will not be truncated and the corresponding code will not have to be modified.
Versions 21 and later
The gImageExists function allows to know if an Image has been loaded in memory by the LoadImage or LoadImageSheetfunction.
New in version 21
The gImageExists function allows to know if an Image has been loaded in memory by the LoadImage or LoadImageSheetfunction.
The gImageExists function allows to know if an Image has been loaded in memory by the LoadImage or LoadImageSheetfunction.

Limits

The LoadImageSheet function must not be used in the project code. Indeed, this function must be used in the window where the image must be handled.

Component: wd270obj.dll