ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage properties / Various properties
  • 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
  • Limitations
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
The Image property gets and sets the background image associated with an element.
WINDEV In a report, the Image property gets and sets the background image of a control or block.
WINDEV In a window, the Image property gets and sets the image:
  • WINDEV 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),
  • WINDEV used as checkmark for check boxes and radio buttons (WINDEV only),
  • used in the options of check boxes and radio buttons in Vista style,
  • used in background image of a Calendar control.
  • WINDEV used in a Rating control.
  • WINDEV used for the markers of a Map control.
  • WINDEV used for a group when the group of a ribbon is closed.
  • WINDEV used to represent an infinite progress bar.
Note: These images are defined in the editor in the field, window or page description ("General" or "Detail" tab).
Example
WINDEVJavaUser code (UMC)
// Modify the image associated with the caption of the "Help" button
BTN_Help.Image = "C:\MyImages\Help.ICO"
WINDEVJavaUser code (UMC)
// Modify the image associated with a check box
CBOX_CheckBox.Image = "C:\MyImages\CheckBox_anim.gif"
WINDEVJavaUser code (UMC)
// Modify the background image of "CustomerName" control
CustomerName..Image ="C:\MyImages\Image.BMP"
Syntax
WINDEV

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

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.
WINDEVJavaUser 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:
  • WINDEV displayed in the icon bar of an MDI parent window,
  • WINDEV 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.
  • WINDEV associated with a Rating control.
  • WINDEV associated with a closed group in a ribbon.
  • WINDEV used to represent an infinite progress bar.
<Element used>: Control name or window name
Name of the element to be used.
WINDEVJavaUser 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 the element to be used.
<New image>: Character string
Name and path (full, relative or UNC) of the new image:
  • WINDEV displayed in the icon bar of an MDI parent window,
  • WINDEV 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.
  • WINDEV associated with a Rating control.
  • WINDEV associated with a closed group in a ribbon.
  • WINDEV used to represent an infinite progress bar.
Remarks
WINDEV

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

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

Image in a menu option

If an image is associated with a marked menu option, the image replaces the checkmark.
WINDEVUser 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 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"
WINDEVUser code (UMC)

Images of checkmarks in the check boxes and radio buttons

The Image property changes the checkmark in check boxes and radio buttons. This property corresponds to the "Check mark image" option in the "Detail" tab of the field description.
If the check mark image is not to be animated: the image used should be made up of the two or three states of the check mark: 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.

Limitations

WINDEV In a report, the Image property cannot be used on:
  • a report.
  • a bar code.
  • a Check Box control.
Authorized image formats:
  • WINDEV The following image formats can be displayed: all those described in function fGraphicFilter.
WINDEV The Image property 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,
  • a Rating control.
  • a Map control marker.
  • an infinite Progress Bar control.
Java The Image property can only be used with the following elements:
  • Button.
  • Window.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 10/04/2024

Send a report | Local help