- Modifying the image
- Modifying the background image in a report
- Limitations
BackgroundImage (Property) In french: ImageFond
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: The background image associated with a window (except for the MDI parent windows).  The background image associated with the MDI area of an MDI parent window.  The image associated with the border of a button.  The background image associated with a progress bar or slider. Versions 20 and laterThe background image of a report. New in version 20The background image of a report. The background image of a report. Versions 21 and later The background image of a Shape control. New in version 21 The background image of a Shape control. The background image of a Shape control. Versions 21 and later The background image of a Repositionable Note control. New in version 21 The background image of a Repositionable Note control. The background image of a Repositionable Note control. Versions 22 and later  The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control. New in version 22  The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.   The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control. Versions 22 and later The background image of dashboard widgets. New in version 22 The background image of dashboard widgets. The background image of dashboard widgets.
<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: The background image associated with a window (except for the MDI parent windows).  The background image associated with the MDI area of an MDI parent window.  The image associated with the border of a button.  The background image associated with a progress bar or slider. Versions 20 and laterThe background image of a report. New in version 20The background image of a report. The background image of a report. Versions 21 and later The background image of a Shape control. New in version 21 The background image of a Shape control. The background image of a Shape control. Versions 21 and later The background image of a Repositionable Note control. New in version 21 The background image of a Repositionable Note control. The background image of a Repositionable Note control. Versions 22 and later  The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control. New in version 22  The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control.   The background image of pages, iFrames, Cells, Supercontrols, Control templates, Menu option, Popup control. Versions 22 and later The background image of dashboard widgets. New in version 22 The background image of dashboard widgets. 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. 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 laterModifying 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 starting from the next page break.
In a report other than a form: - the image is drawn in "homothetic" mode.
- this property has an effect only in actual print jobs, in the report viewer and in PDF exports. It has no effect for the other types of export (RTF, XLS, HTML, XML).
Remarks: - 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.
- The BackgroundImagePrinted property can be used to print the background image of the report. If this property is set to:
- False (default value), the print job can be done on pre-printed paper for example. The background image appears only in the report viewer.
- True, the background image is also printed (or exported to PDF).
Remark: You can also configure this behavior via the "Behavior in print jobs" option in the "Background" tab of the report description window.
New in version 20Modifying 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 starting from the next page break.
In a report other than a form: - the image is drawn in "homothetic" mode.
- this property has an effect only in actual print jobs, in the report viewer and in PDF exports. It has no effect for the other types of export (RTF, XLS, HTML, XML).
Remarks: - 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.
- The BackgroundImagePrinted property can be used to print the background image of the report. If this property is set to:
- False (default value), the print job can be done on pre-printed paper for example. The background image appears only in the report viewer.
- True, the background image is also printed (or exported to PDF).
Remark: You can also configure this behavior via the "Behavior in print jobs" option in the "Background" tab of the report description window.
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 starting from the next page break.
In a report other than a form: - the image is drawn in "homothetic" mode.
- this property has an effect only in actual print jobs, in the report viewer and in PDF exports. It has no effect for the other types of export (RTF, XLS, HTML, XML).
Remarks: - 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.
- The BackgroundImagePrinted property can be used to print the background image of the report. If this property is set to:
- False (default value), the print job can be done on pre-printed paper for example. The background image appears only in the report viewer.
- True, the background image is also printed (or exported to PDF).
Remark: You can also configure this behavior via the "Behavior in print jobs" option in the "Background" tab of the report description window.
Limitations Versions 22 and later New in version 22
This page is also available for…
|
|
|