ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Standard functions / PDF functions
  • Properties specific to pdfParameter variables
  • WLanguage functions that use pdfParameter variables
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
pdfParameter (Variable type)
In french: pdfParamètre
The pdfParameter type defines all the characteristics of the PDF file to be generated. You can define and change the characteristics of this PDF file using different WLanguage properties.
Note: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
Example
// Display two full pages with scrolling and cover page
Params is pdfParameter
Params.Quality = iHighQuality
Params.Zoom = zoomFullWidth
Params.PageDisplayMode = dispTwoPage + dispEnableScrolling + dispWithCoverPage
iParameterPDF(Params)
iDestination(iGenericPDF)
iPrintReport(MyReport)

ShellExecute(iLastFile())
// Display a page with scrolling and set zoom to content
param is pdfParameter
param.Zoom = zoomFitVisible
param.PageDisplayMode = dispSinglePage + dispEnableScrolling
iParameterPDF(param)
iDestination(iGenericPDF, gsPDFName)
iPrintReport(RPT_Database)

ShellExecute(gsPDFName)
// Set page zoom to 100% and enable scrolling
param is pdfParameter
param.Zoom = 100
param.PageDisplayMode = dispEnableScrolling
iParameterPDF(param)
iDestination(iGenericPDF, gsPDFName)
iPrintReport(RPT_Database)

ShellExecute(gsPDFName)
Properties

Properties specific to pdfParameter variables

The following properties can be used to manage the settings of a PDF file:
Property nameType usedEffect
BookmarkBoolean
  • True if bookmarks are to be included in the PDF file. A bookmark is automatically defined for each page in the PDF file. Each bookmark has a name in the following format "Page <page number>" (e.g. "Page 1").
  • False otherwise.
ColorFormatInteger constantColor management in the PDF file:
  • pdfColor: Creating a color PDF file.
  • pdfNiveauGris: Creating a black & white PDF file.
ModificationPasswordCharacter string or Secret stringPassword used to allow a user to change properties of the PDF file.
New in version 2025
Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "Ansi or Unicode string".
To learn more about secret strings and how to use the vault, see Secret string vault.
OpeningPasswordCharacter string or Secret stringPassword required to open the PDF file.
New in version 2025
Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "Ansi or Unicode string".
To learn more about secret strings and how to use the vault, see Secret string vault.
PageDisplayModeInteger constantPage display mode in the PDF reader. Corresponds to a combination of the following constants:
  • affAvecCouverture: Considers the first page of the PDF file as a cover.. The first page is displayed on the right when the page display is in 2-page mode.
  • affWithScroll Display with dequeue: Displays pages in an uninterrupted vertical column occupying the width of a page. Scrolling can be enabled for both 1-page and 2-page display modes.
  • affDefault (Default value): Default display.
  • affDeuxPages: Display two pages at a time, side by side, from the PDF file in the PDF reader..
  • affUnePage: Display one page at a time of the PDF file in the PDF reader. Margins are not displayed.
ProtectionInteger constantsProtection options for the generated PDF file. Corresponds to the combination of the following constants:
  • Format options:
    • iPDFA or iPDFA1b: PDF in PDF/A-1b format. All the elements required to display or print the PDF file are included in the generated file. Therefore, the generated file is bigger.
      Note: This format has certain limitations:
      • Transparency of images not supported.
      • OpenType fonts not supported.
      • Use of embedded fonts.
    • iPDFA3b: PDF in PDF/A-3b format. All the elements required to display or print the PDF file are included in the generated file. Therefore, the generated file is bigger. You can add different types of files to the PDF file, such as XML, CSV, word processing, spreadsheet, etc.
      Note: This format has certain limitations:
      • Transparency of images not supported.
      • OpenType fonts not supported.
      • Use of embedded fonts.
  • Protection options:
    • iProtectionAucune: No PDF file protection.
    • iProtectionComment: Protection against adding or modifying comments.
    • iProtectionImpression: The PDF file cannot be printed.
    • iProtectionModification: The content of the PDF file cannot be modified.
    • iProtectionSélection: The contents of the PDF file cannot be copied or extracted from the file.
QualityInteger constantColor and grayscale compression quality:
  • iQualityAutomatic: Automatically calculated quality.
  • iHighQuality: High compression quality.
  • iLowQuality: Low compression quality.
  • iMaximumQuality: Maximum compression quality.
  • iMinimumQuality: Minimum compression quality.
  • iAverageQuality: Average compression quality.
UnicodeBoolean
  • True if the PDF is to be generated in Unicode format (if it contains Unicode characters),
  • False otherwise.
Note: If the PDF file is to be generated in Unicode format, the generated PDF will be larger.
VersionInteger constantVersion of the generated PDF:
  • iPDF14 PDF generated in PDF 1.4 format (default value).
  • iPDF15: PDF generated in PDF 1.5 format
  • iPDF16: PDF generated in PDF 1.6 format
  • iPDF17: PDF generated in PDF 1.7 format
ZoomInteger or Integer constantDefault zoom when the PDF file is opened:
  • Zoom value between 25% and 6400%,
  • zoomContent Zoom to display the page so that text and images occupy the full width of the viewer used.
  • zoomDefault Default zoom.
  • zoomFullPage Zoom to display an entire page.
  • zoomFullHeight Zoom to full page height.
  • zoomFullWidth Zoom to full page width.
  • zoomRealSize 100% zoom.
Remarks

WLanguage functions that use pdfParameter variables

iParameterPDFDefines the options for the generated PDF file.
PDFAddImageAdds an image to a page in an existing PDF file.
PDFAddWatermarkAdds a watermark to all or some pages of an existing PDF file.
Minimum version required
  • Version 27
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/05/2025

Send a report | Local help