PC SOFT

ONLINE HELP
 WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • 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
The BackgroundImage property is used to identify and modify the background color of an element: window, page, control or report.
Remarks:
  • The background image of a report is defined in the report description("Background" tab).
Versions 22 and later
PHP This property is now available for PHP sites.
New in version 22
PHP This property is now available for PHP sites.
PHP This property is now available for PHP sites.
Example
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> = <Element used>.BackgroundImage
<Current image>: Character string
Name and path of background image. This background image can correspond to:
  • 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 22 and later
    PHP The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.
    New in version 22
    PHP The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.
    PHP The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.
<Element used>: Name of control, window, page or report
Name of element used.

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

<Element used>.BackgroundImage = <New image>
<Element used>: Name of control, window, page or report
Name of element used.
<New image>: Character string
Name and path (full, relative or UNC) of new background image. This image can correspond to:
  • 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 22 and later
    PHP The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.
    New in version 22
    PHP The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.
    PHP The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.
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.
Remark: 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

The BackgroundImage property is available for all types of reports. The BackgroundImage property must be called before printing the page, for example in the event "Before printing the page header block".
For a report on form:
  • the BackgroundImage property replaces the background image chosen in edit mode. 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).
Remark: 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

The BackgroundImage property is available for all types of reports. The BackgroundImage property must be called before printing the page, for example in the event "Before printing the page header block".
For a report on form:
  • the BackgroundImage property replaces the background image chosen in edit mode. 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).
Remark: 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

The BackgroundImage property is available for all types of reports. The BackgroundImage property must be called before printing the page, for example in the event "Before printing the page header block".
For a report on form:
  • the BackgroundImage property replaces the background image chosen in edit mode. 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).
Remark: 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

Versions 22 and later
PHP In a page, the BackgroundImage property only applies to:
  • Pages,
  • iFrames,
  • Cells,
  • Supercontrols,
  • Control templates,
  • Menu option,
  • Popup control,
  • Versions 20 and later
    Reports.
    New in version 20
    Reports.
    Reports.
New in version 22
PHP In a page, the BackgroundImage property only applies to:
  • Pages,
  • iFrames,
  • Cells,
  • Supercontrols,
  • Control templates,
  • Menu option,
  • Popup control,
  • Versions 20 and later
    Reports.
    New in version 20
    Reports.
    Reports.
PHP In a page, the BackgroundImage property only applies to:
  • Pages,
  • iFrames,
  • Cells,
  • Supercontrols,
  • Control templates,
  • Menu option,
  • Popup control,
  • Versions 20 and later
    Reports.
    New in version 20
    Reports.
    Reports.
See also
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