Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

WebView.SetPrintParameter

Sets print parameters for WebView.Print method.

Component Version macOS Windows Linux Server iOS SDK
WebView 2.1 ✅ Yes ✅ Yes ❌ No ❌ No ✅ Yes
MBS( "WebView.SetPrintParameter"; ParameterName; ParameterValue )   More

Parameters

Parameter Description Example
ParameterName The name of the parameter.
For MacOS, can be horizontallyCentered, verticallyCentered, showPrintPanel, orientation, printer, bottomMargin, topMargin, leftMargin or rightMargin.
orientation
ParameterValue The value for the given parameter: A boolean value for horizontallyCentered, verticallyCentered and showPrintPanel. "portrait" or "landscape" for orientation. The printer name for printer. A number for bottomMargin, topMargin, leftMargin or rightMargin. portrait

Result

Returns OK or an error message.

Description

Sets print parameters for WebView.Print method.
If showPrintPanel (Default 1) if set to 0, then no print window is shown. verticallyCentered and horizontallyCentered define if content is centered. If printer name is not valid, it will be ignored.

Parameters for iOS: jobName and orientation.
Parameters for Windows with Edge: orientation, shouldPrintBackgrounds, paperWidth, paperHeight, bottomMargin, topMargin, leftMargin and rightMargin.
Parameters for macOS with WebKit 2: horizontallyCentered, verticallyCentered, showPrintPanel, orientation, papername, printer, paperWidth, paperHeight, bottomMargin, topMargin, leftMargin, rightMargin, shouldPrintBackgrounds and MinimumFontSize.

Use WebView.GetPrintParameter to query values.

Examples

Sets bottom margin to 5 points:

Set Variable [$r; Value: MBS("WebView.SetPrintParameter"; "bottomMargin"; 5) ]

Use square paper size:

Set Variable [$r; Value:MBS("WebView.SetPrintParameter"; "paperWidth"; 800)]
Set Variable [$r; Value:MBS("WebView.SetPrintParameter"; "paperHeight"; 800)]

Use A4 paper:

Set Variable [$r; Value: MBS("WebView.SetPrintParameter"; "paperName"; "iso-a4") ]

Set landscape:

Set Variable [$r; Value: MBS("WebView.SetPrintParameter"; "orientation"; "landscape") ]

The paper size to match A4:

Set Variable [$r; Value: MBS("WebView.SetPrintParameter"; "paperWidth"; 576) ]
Set Variable [$r; Value: MBS("WebView.SetPrintParameter"; "paperHeight"; 842) ]

See also

Release notes

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 12nd February 2024


WebView.SetPreferences - WebView.SetPrivateBrowsing