PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • 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
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
The Image property is used to identify and change the background image associated with an element.
Universal Windows 10 AppWindows MobileiPhone/iPad In a report, the Image property is used to identify and change the background image associated with a control or with a block
WINDEV Mobile In a window, the Image property is used to identify and change 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 the check boxes and radio buttons in Vista style,
  • used in background image of a Calendar control.
  • AndroidiPhone/iPad used for the markers of a Map control.
  • Versions 17 and later
    Android used in icon in an Action Bar (property available from Android version 4.0 (Ice cream sandwich, API level 14)).
    New in version 17
    Android used in icon in an Action Bar (property available from Android version 4.0 (Ice cream sandwich, API level 14)).
    Android used in icon in an Action Bar (property available from Android version 4.0 (Ice cream sandwich, API level 14)).
  • Versions 20 and later
    AndroidiPhone/iPad used to represent an infinite progress bar.
    New in version 20
    AndroidiPhone/iPad used to represent an infinite progress bar.
    AndroidiPhone/iPad used to represent an infinite progress bar.
PHP 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).
Versions 15 and later
Android This property is now available for Android applications.
New in version 15
Android This property is now available for Android applications.
Android This property is now available for Android applications.
Versions 17 and later
iPhone/iPad This property is now available for iPhone/iPad applications.
New in version 17
iPhone/iPad This property is now available for iPhone/iPad applications.
iPhone/iPad This property is now available for iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This property is now available in Windows Store apps mode.
iPhone/iPad This property is now available for reports in iPhone/iPad applications.
Android This property is now available for tabs and tab panes.
New in version 18
Universal Windows 10 App This property is now available in Windows Store apps mode.
iPhone/iPad This property is now available for reports in iPhone/iPad applications.
Android This property is now available for tabs and tab panes.
Universal Windows 10 App This property is now available in Windows Store apps mode.
iPhone/iPad This property is now available for reports in iPhone/iPad applications.
Android This property is now available for tabs and tab panes.
Versions 21 and later
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Example
JavaUser code (UMC)
// Modify the image associated with the caption of the "Help" button
BTN_Help.Image = "C:\MyImages\Help.ICO"
JavaUser code (UMC)
// Modify the image associated with a check box
CBOX_CheckBox.Image = "C:\MyImages\CheckBox_anim.gif"
JavaUser code (UMC)Ajax
// Modify the background image of "CustomerName" control
CustomerName.Image ="C:\MyImages\Image.BMP"
Syntax
Universal Windows 10 AppWindows MobileiPhone/iPadAjax

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 AppWindows MobileiPhone/iPadAjax

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.
Universal Windows 10 AppWindows MobileAndroidiPhone/iPadJavaUser code (UMC)

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.
  • Versions 17 and later
    Android used for the markers of a Map control.
    New in version 17
    Android used for the markers of a Map control.
    Android used for the markers of a Map control.
  • Versions 17 and later
    Android used in icon in an Action Bar.
    New in version 17
    Android used in icon in an Action Bar.
    Android used in icon in an Action Bar.
  • Versions 20 and later
    AndroidiPhone/iPad used to represent an infinite progress bar.
    New in version 20
    AndroidiPhone/iPad used to represent an infinite progress bar.
    AndroidiPhone/iPad used to represent an infinite progress bar.
<Element used>: Control name or window name
Name of element to use.
Universal Windows 10 AppWindows MobileAndroidiPhone/iPadJavaUser code (UMC)

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 element to use.
<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.
  • Versions 17 and later
    Android used for the markers of a Map control.
    New in version 17
    Android used for the markers of a Map control.
    Android used for the markers of a Map control.
  • Versions 17 and later
    Android used in icon in an Action Bar.
    New in version 17
    Android used in icon in an Action Bar.
    Android used in icon in an Action Bar.
  • Versions 20 and later
    AndroidiPhone/iPad used to represent an infinite progress bar.
    New in version 20
    AndroidiPhone/iPad used to represent an infinite progress bar.
    AndroidiPhone/iPad used to represent an infinite progress bar.
PHPAjax

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

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
Universal Windows 10 AppWindows MobileiPhone/iPad

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 AppWindows MobileiPhone/iPad

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.
Windows MobileUser code (UMC)

Image in a menu option

If an image is associated with a marked menu option, the image replaces the checkmark.
Windows MobileAndroidUser code (UMC)

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"
User code (UMC)

Images of checkmarks in the check boxes and radio buttons

The Image property is used to change the checkmark in 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 the 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
Android

Image of icon displayed in the Action Bar

The Image property is used to change 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.
New in version 17
Android

Image of icon displayed in the Action Bar

The Image property is used to change 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.
Android

Image of icon displayed in the Action Bar

The Image property is used to change 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.

Limits

Universal Windows 10 AppWindows MobileiPhone/iPad 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.
Windows Mobile The Image property 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.
Java The Image property only applies to the following elements:
  • Button.
  • Window.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment