PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK

  • Modifying the image
  • Modifying the background image in a report
  • 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
..BackgroundImage is used to find out and modify the background image of an element: window, page, control or report.
Notes:
  • WINDEVWINDEV Mobile The background image of a window or control is defined in the description window of element ("General" or "Image" tab).
  • The background image of a report is defined in the description window of report ("Background" tab).
Versions 15 and later
Android This property is now available for the Android applications.
New in version 15
Android This property is now available for the Android applications.
Android This property is now available for the Android applications.
Versions 17 and later
iPhone/iPad This property is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This property is now available for the iPhone/iPad applications.
iPhone/iPad This property is now available for the iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This property is now available in Windows Store apps mode.
New in version 18
Universal Windows 10 App This property is now available in Windows Store apps mode.
Universal Windows 10 App This property is now available in Windows Store apps mode.
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.
Versions 22 and later
WEBDEV - Browser code This property is now available in browser code.
WEBDEV - Server code This property is now available for WEBDEV sites.
PHP This property is now available for the PHP sites.
New in version 22
WEBDEV - Browser code This property is now available in browser code.
WEBDEV - Server code This property is now available for WEBDEV sites.
PHP This property is now available for the PHP sites.
WEBDEV - Browser code This property is now available in browser code.
WEBDEV - Server code This property is now available for WEBDEV sites.
PHP This property is now available for the PHP sites.
Example
WINDEV
// Modify the background image of "WIN_EditCustomer" window
WIN_EditCustomer..BackgroundImage = "C:\MyImages\Image.gif"
Versions 20 and later
// Before printing Page_header
// Modify the background image of report
// Use a different page found in a PDF
MyReport..BackgroundImagePrinted = True
MyReport..BackgroundImage = PDFExtractPage("Form.pdf", 2)
New in version 20
// Before printing Page_header
// Modify the background image of report
// Use a different page found in a PDF
MyReport..BackgroundImagePrinted = True
MyReport..BackgroundImage = PDFExtractPage("Form.pdf", 2)
// Before printing Page_header
// Modify the background image of report
// Use a different page found in a PDF
MyReport..BackgroundImagePrinted = True
MyReport..BackgroundImage = PDFExtractPage("Form.pdf", 2)
Syntax

Finding out the background image of a control, window or report Hide the details

<Current image> = <Object name>..BackgroundImage
<Current image>: Character string
Name and path of background image. This background image can correspond to:
  • WINDEVWINDEV Mobile The background image associated with a window (except for the MDI parent windows).
  • WINDEVWINDEV Mobile The background image associated with the MDI area of an MDI parent window.
  • WINDEVWINDEV Mobile The image associated with the border of a button.
  • WINDEVWINDEV Mobile The background image associated with a progress bar or slider.
  • Versions 20 and later
    The background image of a report.
    New in version 20
    The background image of a report.
    The background image of a report.
  • Versions 21 and later
    WINDEV The background image of a Shape control.
    New in version 21
    WINDEV The background image of a Shape control.
    WINDEV The background image of a Shape control.
  • Versions 21 and later
    WINDEV The background image of a Repositionable Note control.
    New in version 21
    WINDEV The background image of a Repositionable Note control.
    WINDEV The background image of a Repositionable Note control.
  • Versions 22 and later
    WEBDEV - Server codeWEBDEV - Browser codePHP The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.
    New in version 22
    WEBDEV - Server codeWEBDEV - Browser codePHP The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.
    WEBDEV - Server codeWEBDEV - Browser codePHP The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.
  • Versions 22 and later
    WEBDEV - Browser code The background image of dashboard Widgets.
    New in version 22
    WEBDEV - Browser code The background image of dashboard Widgets.
    WEBDEV - Browser code The background image of dashboard Widgets.
<Object name>: Character string (with or without quotes)
Name of object to use.

Modifying the background image of a control, window or report Hide the details

<Object name>..BackgroundImage = <New image>
<Object name>: Character string (with or without quotes)
Name of object to use.
<New image>: Character string
Name and path (full, relative or UNC) of new background image. This image can correspond to:
  • WINDEVWINDEV Mobile The background image associated with a window (except for the MDI parent windows).
  • WINDEVWINDEV Mobile The background image associated with the MDI area of an MDI parent window.
  • WINDEVWINDEV Mobile The image associated with the border of a button.
  • WINDEVWINDEV Mobile The background image associated with a progress bar or slider.
  • Versions 20 and later
    The background image of a report.
    New in version 20
    The background image of a report.
    The background image of a report.
  • Versions 21 and later
    WINDEV The background image of a Shape control.
    New in version 21
    WINDEV The background image of a Shape control.
    WINDEV The background image of a Shape control.
  • Versions 21 and later
    WINDEV The background image of a Repositionable Note control.
    New in version 21
    WINDEV The background image of a Repositionable Note control.
    WINDEV The background image of a Repositionable Note control.
  • Versions 22 and later
    WEBDEV - Server codeWEBDEV - Browser codePHP The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.
    New in version 22
    WEBDEV - Server codeWEBDEV - Browser codePHP The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.
    WEBDEV - Server codeWEBDEV - Browser codePHP The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.
  • Versions 22 and later
    WEBDEV - Browser code The background image of dashboard Widgets.
    New in version 22
    WEBDEV - Browser code The background image of dashboard Widgets.
    WEBDEV - Browser code The background image of dashboard Widgets.
Remarks

Modifying the image

When changing the image, the image is sought in the application library (WDL file) then on disk at the specified location.
Note: If an attempt is made to replace the image found in the WDL by an image with the same name found on disk, the change of image is not performed.
Versions 20 and later

Modifying the background image in a report

..BackgroundImage is available for all types of reports. ..BackgroundImage must be called before printing the page, for example in the event "Before printing the page header block".
For a report on form,
  • ..BackgroundImage replaces the background image chosen in edit. All types of images supported in the reports are available (PDF, SVG, JPG, PNG, etc.).
  • the image is saved by page: therefore, a different background image can be specified for each printed page.
  • when the property is assigned, the new background image will be printed from the next page skip.
In a report other than form:
  • the image is drawn in "homothetic".
  • this property has an effect in the actual print, in the print preview and in PDF export. It has no effect for the other types of export (RTF, XLS, HTML, XML).
Note: The management of margins specified in the "Background" tab of the report description ("Ignore the physical margins of the printer") is ignored: the physical margins are systematically ignored.
New in version 20

Modifying the background image in a report

..BackgroundImage is available for all types of reports. ..BackgroundImage must be called before printing the page, for example in the event "Before printing the page header block".
For a report on form,
  • ..BackgroundImage replaces the background image chosen in edit. All types of images supported in the reports are available (PDF, SVG, JPG, PNG, etc.).
  • the image is saved by page: therefore, a different background image can be specified for each printed page.
  • when the property is assigned, the new background image will be printed from the next page skip.
In a report other than form:
  • the image is drawn in "homothetic".
  • this property has an effect in the actual print, in the print preview and in PDF export. It has no effect for the other types of export (RTF, XLS, HTML, XML).
Note: The management of margins specified in the "Background" tab of the report description ("Ignore the physical margins of the printer") is ignored: the physical margins are systematically ignored.

Modifying the background image in a report

..BackgroundImage is available for all types of reports. ..BackgroundImage must be called before printing the page, for example in the event "Before printing the page header block".
For a report on form,
  • ..BackgroundImage replaces the background image chosen in edit. All types of images supported in the reports are available (PDF, SVG, JPG, PNG, etc.).
  • the image is saved by page: therefore, a different background image can be specified for each printed page.
  • when the property is assigned, the new background image will be printed from the next page skip.
In a report other than form:
  • the image is drawn in "homothetic".
  • this property has an effect in the actual print, in the print preview and in PDF export. It has no effect for the other types of export (RTF, XLS, HTML, XML).
Note: The management of margins specified in the "Background" tab of the report description ("Ignore the physical margins of the printer") is ignored: the physical margins are systematically ignored.

Limits

WINDEVWINDEV Mobile In a window, ..BackgroundImage only applies to the:
  • windows,
  • buttons,
  • progress bars,
  • sliders,
  • Versions 20 and later
    reports.
    New in version 20
    reports.
    reports.
  • Versions 21 and later
    WINDEV Shape controls in a window.
    New in version 21
    WINDEV Shape controls in a window.
    WINDEV Shape controls in a window.
  • Versions 21 and later
    WINDEV Repositionable Note controls in a window.
    New in version 21
    WINDEV Repositionable Note controls in a window.
    WINDEV Repositionable Note controls in a window.
Java ..BackgroundImage only applies the following elements:
  • Button.
  • Window.
Versions 22 and later
WEBDEV - Server codeWEBDEV - Browser codePHP In a page, ..BackgroundImage only applies to the:
  • Pages,
  • iFrames,
  • Cells,
  • Supercontrols,
  • Control templates,
  • Menu option,
  • Popup control,
  • Versions 20 and later
    Reports.
    New in version 20
    Reports.
    Reports.
  • WEBDEV - Browser code Dashboard widget.
New in version 22
WEBDEV - Server codeWEBDEV - Browser codePHP In a page, ..BackgroundImage only applies to the:
  • Pages,
  • iFrames,
  • Cells,
  • Supercontrols,
  • Control templates,
  • Menu option,
  • Popup control,
  • Versions 20 and later
    Reports.
    New in version 20
    Reports.
    Reports.
  • WEBDEV - Browser code Dashboard widget.
WEBDEV - Server codeWEBDEV - Browser codePHP In a page, ..BackgroundImage only applies to the:
  • Pages,
  • iFrames,
  • Cells,
  • Supercontrols,
  • Control templates,
  • Menu option,
  • Popup control,
  • Versions 20 and later
    Reports.
    New in version 20
    Reports.
    Reports.
  • WEBDEV - Browser code Dashboard widget.
Minimum version required
  • Version 9
This page is also available for…
Comments
Video BackgroundImage
https://youtu.be/mZCAUmMzZDA

https://windevdesenvolvimento.blogspot.com/2019/03/dicas-2058-windev-comandos-52.html

// BTN_ALTERAR_FUNDO_BACKGROUNDIMAGE
WIN_COMANDOS2..BackgroundImage = "C:\TEMP\011_ErpMatos_1.png"
amarildo
28 Mar. 2019