Image (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Image associated with a report control or block
Image scanned in a report
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Image (Property)

In french: Image

The Image property is used to identify and change the background image associated with an element.

In a report, the Image property is used to identify and change the background image associated with a control or with a block

In a page, the Image property is used to identify and change the image associated with:

an Image control,
a Web Camera control (server code only),
a fixed-image button (browser code only),
a Thumbnail control,
a Calendar control (background image).
Versions 18 and later
a Social Network control (whose image is customized).
New in version 18
a Social Network control (whose image is customized).
a Social Network control (whose image is customized).
Versions 20 and later
the markers of a Map control.
New in version 20
the markers of a Map control.
the markers of a Map control.

Remark: These images are defined in the editor in the description of the control, window or page ("General" or "Details" tab).

Example

// Modify the background image of "CustomerName" control
CustomerName.Image ="C:\MyImages\Image.BMP"

Syntax

Finding out the background image associated with a report element Hide the details

<Result> = <Element used>.Image

<Result>: Character string

Name and full path of the background image associated with the specified object.

<Element used>: Name of control or block.

Name of the element (control or block) to use.

Modifying the background image associated with a report element Hide the details

<Element used>.Image = <New image>

<Element used>: Name of control or block.

Name of the element (control or block) to use.

<New image>: Character string (with quotes)

Name and full path of the new background image associated with the specified object. A UNC path can be used.

Finding out the image associated with a page control Hide the details

<Current image> = <Control used>.Image

<Current image>: Character string

Name and path of the image.
In server code, the full image path is specified.
In browser code, the path of the image is specified in relation to the _WEB directory of the site (for example, http://localhost/REWALI7_WEB/AXP01020_4E97E1FF_FR.gif).

<Control used>: Control name

Name of control to use.

Modifying the image associated with a page control Hide the details

<Control used>.Image = <New image>

<Control used>: Control name

Name of control to use.

<New image>: Character string

Name and path (full, relative or UNC) of the new image:
Static image: Modification without effect
Dynamic image: path such as "image2.gif" (with "image2.gif" in the "_WEB\" sub-directory of the project)
Generated image: full path such as "c:\my image\image2.gif"

Remarks

Image associated with a report control or block

The image associated with an Image control can be known and/or modified in the report editor, in the "General" tab of the control description.
The background image of a control or block can be known and/or modified in the report editor, in the "Style" tab of the description window. All you have to do is select the "Background image" element.

Image scanned in a report

The Image property cannot be used to change the scanned image of a report. Indeed, the scanned image of a report is used to:

easily position the different controls in the report,
view the result in the print preview.

Limits

In a report, the Image property cannot be used on:

a report.
a bar code.
a Check Box control.

Authorized image formats:

The following image formats can be displayed: all the formats described in fGraphicFilter.

The Image property can only be used on:

an Image control.
a Web Camera control.
a Calendar control.
Versions 18 and later
a Social Network control (whose image is customized).
New in version 18
a Social Network control (whose image is customized).
a Social Network control (whose image is customized).
Versions 20 and later
a Map control marker.
New in version 20
a Map control marker.
a Map control marker.

The Image property can only be used on:

a fixed-image button.
an Image control.
Versions 20 and later
a Map control marker.
New in version 20
a Map control marker.
a Map control marker.