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

WebView.Create

Creates a new web view inside the window with the given rectangle.

Component Version macOS Windows Linux Server iOS SDK
WebView 7.4 ✅ Yes ✅ Yes ❌ No ❌ No ✅ Yes
MBS( "WebView.Create"; WindowRef; x; y; w; h { ; Version } )   More

Parameters

Parameter Description Example Flags
WindowRef Window Reference is the unique OS level window ID. You can obtain this by using the Window.FindByTitle or Window.FindByIndex functions. Pass zero to access the frontmost window. 0
x The left coordinate in the window. 0
y The top coordinate in the window. 0
w The width of the drop area in the window. 600
h The height of the drop area in the window. 400
Version Available in MBS FileMaker Plugin 10.3 or newer.
The WebKit version you need.
Pass 1 for WebKit 1.x or 2 for WebKit 2.x.
Default is zero, which prefers WebKit 1 on MacOS.		 0 Optional

Result

Returns webviewer reference number or error.

Description

Creates a new web view inside the window with the given rectangle.
If you create WebKit 1.x view, you can use all the PDF/Image rendering functions, download delegate and callback functions, which don't work in WebKit 2.x.
But if you use WebKit 2.x, you can use script message handler or user scripts, which are not supported in WebKit 1.x.

The view is released automatically when window closes.
Web viewers created via WebView.Create or WebView.CreateWithControl are independent of FileMaker, so they don't reload with a record change. They also don't print with the layout and stay if you change the layout.

Added iOS support in version 10.3 using WebKit 2.x.
Added Windows support in version 10.3 using IE engine.

Please call WebView.Close later to close it.

Examples

Create WebView:

Set Variable [ $x ; Value: 40 ]
Set Variable [ $y ; Value: 80 ]
Set Variable [ $w ; Value: 970 ]
Set Variable [ $h ; Value: 440 ]

Set Variable [ $$web ; Value: MBS("WebView.Create"; 0; $x; $y; $w; $h) ]
Set Variable [ $r ; Value: MBS( "WebView.LoadURL"; $$web; "https://www.mbsplugins.de/filemaker") ]

Print via WebKit 1.x web viewer:

# Create WebViewer Copy in file WebViewer Print

# Create web view in version 1 for WebKit
Set Variable [ $$web ; Value: MBS("WebView.Create"; 0; 40; 80; 970; 440; 1) ]
# Load som eURL
Set Variable [ $r ; Value: MBS( "WebView.LoadURL"; $$web; "https://www.monkeybreadsoftware.com/filemaker/") ]
# wait for website to load
Loop
    Exit Loop If [ MBS( "WebView.IsLoading"; $$web ) ≠ 1 ]
    Pause/Resume Script [ Duration (seconds): ,1 ]
End Loop
# set print parameters
Set Variable [ $r ; Value: MBS("WebView.SetPrintParameter"; "shouldPrintBackgrounds"; 0) ]
Set Variable [ $r ; Value: MBS("WebView.SetPrintParameter"; "leftMargin"; 30) ]
Set Variable [ $r ; Value: MBS("WebView.SetPrintParameter"; "topMargin"; 30) ]
Set Variable [ $r ; Value: MBS("WebView.SetPrintParameter"; "rightMargin"; 30) ]
Set Variable [ $r ; Value: MBS("WebView.SetPrintParameter"; "bottomMargin"; 30) ]
# get a file path
Set Variable [ $Path ; Value: MBS( "Path.AddPathComponent"; MBS( "Folders.UserDesktop" ); "test.pdf") ]
# print to PDF
Set Variable [ $r ; Value: MBS("WebView.PrintToFile"; $$web; $Path) ]

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 26th August 2017, last changed 25th January 2024


WebView.CopyFormattedText - WebView.CreateWithControl