ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Various properties
  • Image associated with a report control or block
  • Image scanned in a report
  • Image of a tab or tab pane
  • Image of icon displayed in the Action Bar
  • Limitations
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
The Image property gets and sets the background image associated with an element.
Universal Windows 10 AppiPhone/iPadIOS Widget In a report, the Image property gets and sets the background image of a control or block.
WINDEV Mobile In a window, the Image property gets and sets 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 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 in the options of check boxes and radio buttons in Vista style,
  • used in background image of a Calendar control.
  • AndroidiPhone/iPadIOS Widget used for the markers of a Map control.
  • Android used in icon in an Action Bar (property available from Android version 4.0 (Ice cream sandwich, API level 14)).
  • AndroidiPhone/iPadIOS Widget used to represent an infinite progress bar.
Remark: These images are defined in the editor in the description of the control, window or page ("General" or "Details" tab).
Example
Syntax
Universal Windows 10 AppiPhone/iPadIOS Widget

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.
Universal Windows 10 AppiPhone/iPadIOS Widget

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.
Universal Windows 10 AppAndroidiPhone/iPadIOS Widget

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.
  • Android used for the markers of a Map control.
  • Android used in icon in an Action Bar.
  • AndroidiPhone/iPadIOS Widget used to represent an infinite progress bar.
<Element used>: Control name or window name
Name of the element to be used.
Universal Windows 10 AppAndroidiPhone/iPadIOS Widget

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.
  • Android used for the markers of a Map control.
  • Android used in icon in an Action Bar.
  • AndroidiPhone/iPadIOS Widget used to represent an infinite progress bar.
Remarks
Universal Windows 10 AppiPhone/iPadIOS Widget

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.
Universal Windows 10 AppiPhone/iPadIOS Widget

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.
Android

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 change the image displayed in the tab button (next to the text), simply specify the index of the tab to be modified:
TAB_Tab[1].Image = "Example.jpg"
Android

Image of icon displayed in the Action Bar

The Image property changes the icon displayed in the Action Bar of the window. If the Image property corresponds to an empty string (""), the application icon will be used (default behavior).
Caution: this property is available from Android version 4.0 (Ice cream sandwich, API level 14). The Image property will have no effect if it is used with an earlier version.

Limitations

Universal Windows 10 AppiPhone/iPadIOS Widget In a report, the Image property cannot be used on:
  • a report.
  • a bar code.
  • a Check Box control.
Authorized image formats:
  • WINDEV Mobile The following image formats can be displayed: BMP, ICO, JPEG and GIF.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/08/2023

Send a report | Local help