Image (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage properties

Various properties

Image

Presentation

Example

Image associated with a report control or block

Image scanned in a report

Limits

See also

Image (Property)

In french: Image

The Image property gets and sets the background image associated with an element.

In a report, the Image property gets and sets the background image of a control or block.

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

Example

// Modify the image associated with the caption of the "Help" button
BTN_Help.Image = "C:\MyImages\Help.ICO"

// Modify the image associated with a check box
CBOX_CheckBox.Image = "C:\MyImages\CheckBox_anim.gif"

// 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

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 control or with a window Hide the details

<Current image> = <Element used>.Image

<Current image>: Character string

Name and path of the image:
associated with the caption of a button,
associated with a tab pane or with a tab,
associated with the toolbar panes or with the pane button
associated with the caption of a menu option,
used as cursor in a progress bar or in a slider (except round sliders).
associated with the option of a Radio Button or Check Box control in Vista style.
used in background image of a Calendar control.

<Element used>: Control name or window name

Name of the element to be used.

Modifying the image associated with a control or with a window Hide the details

<Element used>.Image = <New image>

<Element used>: Control name or window name

Name of the element to be used.

<New image>: Character string

Name and path (full, relative or UNC) of the new image:
associated with the caption of a button,
associated with a tab pane or with a tab,
associated with the toolbar panes or with the pane button
associated with the caption of a menu option,
used as cursor in a progress bar or in a slider (except round sliders).
associated with the option of a Radio Button or Check Box control in Vista style.
used in background image of a Calendar control.

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: