Monkeybread Software - MBS FileMaker Plugin: WebView.SetPreferences

Topics All Mac OS X (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server (Not) Client Old Guides Examples
New in version: 7.0 7.1 7.2 7.3 7.4 7.5 8.0 8.1 8.2 8.3 Statistic

WebView.SetPreferences

Sets WebView preferences parameters.

Component	Version	macOS	Windows	Server	FileMaker Cloud	FileMaker iOS SDK
WebView	2.2	Yes	No	No	No	Yes

MBS( "WebView.SetPreferences"; WebViewerRef; ParameterName; ParameterValue )

Parameters

Parameter Description Example value

WebViewerRef Either the Web Viewer Object Name or the Web Viewer ID as returned by "WebView.FindByName" function. "web"

ParameterName The name of the parameter. isJavaEnabled

ParameterValue The value for the given parameter: A boolean value for allowsAnimatedImageLooping, allowsAnimatedImages, javaEnabled, javaScriptCanOpenWindowsAutomatically, javaScriptEnabled, loadsImagesAutomatically, plugInsEnabled, privateBrowsingEnabled, shouldPrintBackgrounds, tabsToLinks, userStyleSheetEnabled and usesPageCache. A number for cacheModel, defaultFixedFontSize, defaultFontSize, minimumFontSize or minimumLogicalFontSize. A string for cursiveFontFamily, defaultTextEncodingName, fantasyFontFamily, fixedFontFamily, sansSerifFontFamily, serifFontFamily or standardFontFamily. 0

Parameter	Description	Example value
WebViewerRef	Either the Web Viewer Object Name or the Web Viewer ID as returned by "WebView.FindByName" function.	"web"
ParameterName	The name of the parameter.	isJavaEnabled
ParameterValue	The value for the given parameter: A boolean value for allowsAnimatedImageLooping, allowsAnimatedImages, javaEnabled, javaScriptCanOpenWindowsAutomatically, javaScriptEnabled, loadsImagesAutomatically, plugInsEnabled, privateBrowsingEnabled, shouldPrintBackgrounds, tabsToLinks, userStyleSheetEnabled and usesPageCache. A number for cacheModel, defaultFixedFontSize, defaultFontSize, minimumFontSize or minimumLogicalFontSize. A string for cursiveFontFamily, defaultTextEncodingName, fantasyFontFamily, fixedFontFamily, sansSerifFontFamily, serifFontFamily or standardFontFamily.	0

Result

Returns OK or an error message.

Description

Sets WebView preferences parameters.
For WebKit 1.x you can pass empty WebViewerRef to access global preferences.

Available keys for WebKit 1.x (FileMaker till version 15 and WebView.Create): allowsAnimatedImageLooping, allowsAnimatedImages, cacheModel, cursiveFontFamily, defaultFixedFontSize, defaultFontSize, defaultTextEncodingName, fantasyFontFamily, fixedFontFamily, javaEnabled, javaScriptCanOpenWindowsAutomatically, javaScriptEnabled, loadsImagesAutomatically, minimumFontSize, minimumLogicalFontSize, plugInsEnabled, privateBrowsingEnabled, sansSerifFontFamily, serifFontFamily, shouldPrintBackgrounds, standardFontFamily, tabsToLinks, userStyleSheetEnabled or usesPageCache.

Available keys for WebKit 2.x (FileMaker 16): developerExtrasEnabled, logsPageMessagesToSystemConsoleEnabled, minimumFontSize, javaScriptEnabled, javaScriptCanOpenWindowsAutomatically, allowFileAccessFromFileURLs, allowUniversalAccessFromFileURLs , telephoneNumberDetectionIsEnabled, javaEnabled and plugInsEnabled.

Please check WebKit documentation for details.

Examples

set print background option:

MBS("WebView.SetPreferences"; $WebViewerRef; "shouldPrintBackgrounds", 1)

Disables image loading:

MBS("WebView.SetPreferences"; $WebViewerRef; "loadsImagesAutomatically", 1)

Disable Java:

MBS("WebView.SetPreferences"; $WebViewerRef; "javaEnabled"; 0)

Disable Plugins:

MBS("WebView.SetPreferences"; $WebViewerRef; "plugInsEnabled"; 0)

Set developer extras enabled state for webviewer:

Set Variable [$r; Value:MBS("WebView.SetPreferences"; "web"; "developerExtrasEnabled"; 1)]

Enable file URLs:

Set Variable [$r; Value:MBS("WebView.SetPreferences"; "web"; "allowFileAccessFromFileURLs"; 1)]

Example Databases

WebViewer/Web Preferences (Mac)

WebView.SetInternetExplorerVersion - WebView.SetPrintParameter