Image (Property)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Image associated with a report control or block
Image scanned in a report
Image in a menu option
Image of a tab or tab pane
Images of checkmarks in the check boxes and radio buttons
Image of icon displayed in the Action Bar
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Image (Property)

In french: Image

..Image is used to find out and modify the background image associated with an element.

In a report, ..Image is used to find out and modify the background image associated with a control or with a block.

In a window, ..Image is used to find out and modify the image:

displayed in the icon bar of an MDI parent window (WINDEV only),
associated with the caption of a button,
associated with a tab pane or with a tab,
associated with the toolbar panes or with the button of a toolbar pane,
associated with the caption of a menu option,
used as cursor in a progress bar or in a slider (except round sliders),
used as checkmark for the check boxes and for the radio buttons (WinDev only),
used in the options of the check boxes and radio buttons in Vista style,
used in background image of a Calendar control.
Versions 17 and later
used in a Rating control.
New in version 17
used in a Rating control.
used in a Rating control.
Versions 17 and later
used for the markers of a Map control.
New in version 17
used for the markers of a Map control.
used for the markers of a Map control. used for the markers of a Map control.
Versions 17 and later
used in icon in an Action Bar (property available from Android version 4.0 (Ice cream sandwich, API level 14)).
New in version 17
used in icon in an Action Bar (property available from Android version 4.0 (Ice cream sandwich, API level 14)).
used in icon in an Action Bar (property available from Android version 4.0 (Ice cream sandwich, API level 14)).
Versions 17 and later
used for a grouping when the grouping of a ribbon is closed.
New in version 17
used for a grouping when the grouping of a ribbon is closed.
used for a grouping when the grouping of a ribbon is closed.
Versions 20 and later
used to represent an infinite progress bar.
New in version 20
used to represent an infinite progress bar.
used to represent an infinite progress bar.

In a page, ..Image is used to find out and modify 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.

The modification is available for the "Automatic" or "Dynamic" controls only ("Details" tab of control description). The modification is available for the "Automatic" or "Dynamic" controls only ("GUI" tab of control description).

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

Versions 16 and later

This property is now available for the Windows Phone applications.

New in version 16

This property is now available for the Windows Phone applications.

Versions 15 and later

This property is now available for the Android applications.

New in version 15

This property is now available for the Android applications.

Versions 17 and later

This property is now available for the iPhone/iPad applications.

New in version 17

This property is now available for the iPhone/iPad applications.

Versions 18 and later

This property is now available in Windows Store Apps mode.

This property is now available for the reports in the iPhone/iPad applications.

This property is now available for the tabs and for the tab panes.

New in version 18

This property is now available in Windows Store Apps mode.

This property is now available for the reports in the iPhone/iPad applications.

This property is now available for the tabs and for the tab panes.

This property is now available in Windows Store Apps mode.

This property is now available for the reports in the iPhone/iPad applications.

This property is now available for the tabs and for the tab panes.

Versions 21 and later

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

New in version 21

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

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 Name>..Image

<Result>: Character string

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

<Element Name>: Character string (with or without quotes)

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

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

<Element Name>..Image = <New Image>

<Element Name>: Character string (with or without quotes)

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

<Current Image> = <Element Name>..Image

<Current Image>: Character string

Name and path of the image:
displayed in the icon bar of an MDI parent window,
associated with a check box or with a radio button,
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.
Versions 17 and later
associated with a Rating control.
New in version 17
associated with a Rating control.
associated with a Rating control.
Versions 17 and later
used for the markers of a Map control.
New in version 17
used for the markers of a Map control.
used for the markers of a Map control.
Versions 17 and later
used in icon in an Action Bar.
New in version 17
used in icon in an Action Bar.
used in icon in an Action Bar.
Versions 17 and later
associated with a closed grouping of a ribbon.
New in version 17
associated with a closed grouping of a ribbon.
associated with a closed grouping of a ribbon.
Versions 20 and later
used to represent an infinite progress bar.
New in version 20
used to represent an infinite progress bar.
used to represent an infinite progress bar.

<Element Name>: Character string (with or without quotes)

Name of element to use.

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

<Element Name>..Image = <New Image>

<Element Name>: Character string (with or without quotes)

Name of element to use.

<New Image>: Character string

Name and path (full, relative or UNC) of the new image:
displayed in the icon bar of an MDI parent window,
associated with a check box or with a radio button,
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.
Versions 17 and later
associated with a Rating control.
New in version 17
associated with a Rating control.
associated with a Rating control.
Versions 17 and later
used for the markers of a Map control.
New in version 17
used for the markers of a Map control.
used for the markers of a Map control.
Versions 17 and later
used in icon in an Action Bar.
New in version 17
used in icon in an Action Bar.
used in icon in an Action Bar.
Versions 17 and later
associated with a closed grouping of a ribbon.
New in version 17
associated with a closed grouping of a ribbon.
associated with a closed grouping of a ribbon.
Versions 20 and later
used to represent an infinite progress bar.
New in version 20
used to represent an infinite progress bar.
used to represent an infinite progress bar.

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

<Current Image> = <Element Name>..Image

<Current Image>: Character string

Name and path of the image.
In server code, the full path of the image 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).

<Element Name>: Character string (without quotes)

Name of element to use.

Modifying the image associated with a page control Hide the details

<Control Name>..Image = <New Image>

<Control Name>: Character string (without quotes)

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 of block or control. All you have to do is select the "Background image" element.

Image scanned in a report

..Image cannot be used to modify 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.

Image in a menu option

If an image is associated with a marked menu option, the image replaces the checkmark.

Image of a tab or tab pane

To modify the image of a tab (which means the image of the tab buttons), use the following code:

TAB_Tab..Image = "Example.jpg"

To modify the image displayed in the tab button (beside the caption), specify the subscript of tab to modify:

TAB_Tab[1]..Image = "Example.jpg"

Images of checkmarks in the check boxes and radio buttons

..Image is used to change the checkmark associated with the check boxes and radio buttons. This property corresponds to the "Image of checkmarks" option found in the "Details" tab of the control description.

If the image of checkmark must not be animated: the image used must contain the two or three states of the checkmark: Checked, Unchecked and Undefined if necessary.

If the image of the checkmark is animated, the image used must be an image in GIF format containing the following images for each main status (Checked, Unchecked and Undefined):

Checkmark enabled (no animation)
Checkmark pressed (animation)
Checkmark grayed (no animation)
Checkmark hovered (animation)

Example of image used for an animated checkmark:

1. Images for the checked status.

2. Images for the unchecked status.

3. Images for the undefined status.

Versions 17 and later

Image of icon displayed in the Action Bar

..Image is used to change the icon displayed in the Action Bar of the window. If ..Image corresponds to an empty string (""), the icon of the application will be used (default case).

Caution: this property is available from Android version 4.0 (Ice cream sandwich, API level 14). ..Image will have no effect if it is used with an earlier version.

New in version 17

Image of icon displayed in the Action Bar

..Image is used to change the icon displayed in the Action Bar of the window. If ..Image corresponds to an empty string (""), the icon of the application will be used (default case).

Caution: this property is available from Android version 4.0 (Ice cream sandwich, API level 14). ..Image will have no effect if it is used with an earlier version.

Image of icon displayed in the Action Bar

..Image is used to change the icon displayed in the Action Bar of the window. If ..Image corresponds to an empty string (""), the icon of the application will be used (default case).

Caution: this property is available from Android version 4.0 (Ice cream sandwich, API level 14). ..Image will have no effect if it is used with an earlier version.

Limits

In a report, ..Image cannot be used on:

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

a chart.

Authorized image formats:

The following image formats can be displayed: all the formats described in fGraphicFilter.
The following image formats can be displayed: BMP, ICO, JPEG and GIF.

..Image can only be used on:

an MDI window,
a button,
a tab or a tab pane,
a toolbar pane or a pane button,
a menu option,
a progress bar,
a slider (except round sliders),
a check box,
a radio button,
a Calendar control,
Versions 17 and later
a Rating control.
New in version 17
a Rating control.
a Rating control.
Versions 20 and later
a Map control marker.
New in version 20
a Map control marker.
a Map control marker.
Versions 20 and later
an infinite Progress Bar control.
New in version 20
an infinite Progress Bar control.
an infinite Progress Bar control.

..Image can only be used on:

a Button control,
a tab or a tab pane,
a toolbar pane or a pane button,
a menu option,
a Progress Bar control,
a Slider control (excluding round sliders),
a Check Box control,
a Radio Button control,
a Calendar control.

..Image can only be used on:

an Image control or a clickable image.
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.

..Image can only be used on:

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

..Image only applies to the following elements:

Button.
Window.