gImage (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Inserting images
Image height (List Box or Combo Box control)
Image in the title of a column in a Table control
Component

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

gImage (Function)

In french: gImage

Builds a sequence of characters containing an image.

This sequence of characters is used to insert an image:

in an element of a List Box or Combo Box control.
in the title bar and/or status bar of a window.
in a Static control.
in a Text column found in a Table control.

The inserted image can be:

a standard image,
an image made of several drawings. This image will have been divided beforehand (by LoadImage or by LoadImageSheet).

Versions 22 and later

This function is now available in the code of stored procedures.

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

This function is now available for the WEBDEV sites in Windows.

New in version 22

This function is now available in the code of stored procedures.

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

This function is now available for the WEBDEV sites in Windows.

This function is now available in the code of stored procedures.

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

This function is now available for the WEBDEV sites in Windows.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

New in version 21

This function is now available in Universal Windows 10 App mode.

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

This function is now available in Universal Windows 10 App mode.

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

Example

// Add the "C:\MyImages\Image.BMP" image to the "LIST_Customer" control
ListAdd(LIST_Customer, gImage("C:\MyImages\Image.BMP"))

// Add an image made of several drawings
// Split into 10 rows and 2 columns
// Load the "C:\MyImages\DecImage.BMP" image in memory
LoadImage(IDImage, "C:\MyImages\DecImage.BMP", 10, 2)
FOR DrawingRank = 1 TO 10*2
ListAdd(LIST_Customer, gImage(IDImage, DrawingRank))
END

// Add the "\MyImages\Image.BMP" image to the "LIST_Customer" control
ListAdd(LIST_Customer, gImage("\MyImages\Image.BMP"))

// Add an image made of several drawings
// Split into 10 rows and 2 columns
// Load the "\MyImages\DecImage.BMP" image in memory
LoadImage(IDImage, "\MyImages\DecImage.BMP", 10, 2)
FOR DrawingRank = 1 TO 10*2
ListAdd(LIST_Customer, gImage(IDImage, DrawingRank))
END

// Add an image to the title of a column in a Table control
TABLE_MyTable.COL_MyColumn..Title = gImage("MyImage.BMP") + "My title"

Syntax

Inserting a standard image Hide the details

<Result> = gImage(<Image name>)

<Result>: Character string

Sequence of characters in the following format: <Image identifier>, <Drawing rank>.
This sequence of characters can be:
used in ListAdd, ListInsert or ListModify.
assigned to a Static control.
used in the title bar or status bar of a window.
used in a Text column found in a Table control.
This sequence of characters is not interpreted by the controls in WEBDEV. This function can be used to format the string returned by a WEBDEV Webservice consumed by a WINDEV or WINDEV Mobile application.

<Image name>: Character string

Name and full (or relative) path of the image to insert. A UNC path can be used.
Name and full path of the image to insert.
Name of Image control containing the image to insert.

Inserting an image made of several drawings Hide the details

<Result> = gImage(<Image identifier> , <Drawing rank>)

<Result>: Character string

Sequence of characters in the following format: <Image identifier>, <Drawing rank>.
This sequence of characters can be:
used in ListAdd, ListInsert or ListModify.
assigned to a Static control.
used in the title bar or status bar of a window.
used in a Text column found in a Table control.
This sequence of characters is not interpreted by the controls in WEBDEV. This function can be used to format the string returned by a WEBDEV Webservice consumed by a WINDEV or WINDEV Mobile application.

<Image identifier>: Integer

Identifier of the image (included between 1 and 9) corresponding to the identifier of the image divided and loaded in memory by LoadImage or LoadImageSheet.

<Drawing rank>: Integer

Number of the drawing cut. The set of drawings constitutes the image. This number is included between 1 and the result of the multiplication performed between <Number of columns> and <Number of rows> used in LoadImage or LoadImageSheet.

Remarks

Inserting images

gImage can be used to insert an image:
- into the title and status bars of a window or into a Static control.
- into a Table control. In this case, the image must be inserted into a text column.
To display a text over an image:
- Insert an image with gImage,
- Describe the background color of the text with gBackground associated with the Transparent constant,
- Display the text.
  For example:
  
  ListAdd(LIST_ListView, gImage(ImagePath) + gBackground(Transparent) + gCoord(0, 0) + ...
  "Text")
Versions 17 and later
If a row of a Combo Box control displays an image via gImage, when this row is selected, the image is re-used in the main row.
New in version 17
If a row of a Combo Box control displays an image via gImage, when this row is selected, the image is re-used in the main row.
If a row of a Combo Box control displays an image via gImage, when this row is selected, the image is re-used in the main row.

Image height (List Box or Combo Box control)

The height of the image displayed in an element of a List Box or Combo Box control is truncated to the number of pixels specified when the control was created ("Style" tab of the control description).

Image in the title of a column in a Table control

..TitleImage is used to add an image to the title of a column in a Table control.

Component

Until version 21, gImage was available in the wdxxxobj component. From version 22, this function is now available in the wdxxxmdl component.

Business / UI classification : Neutral code

Component : wd250mdl.dll