Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 9.3   9.4   9.5   10.0   10.1   10.2   10.3   10.4   10.5   10.6    Statistic    FMM    Blog  

WebView.Create

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

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
WebView 7.4 Yes No 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; "http://www.mbs-plugins.com") ]

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; "http://www.mbs-plugins.com") ]
# 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

Example Databases

Blog Entries

Release notes

Created 26th August 2017, last changed 5th November 2020


WebView.CopyFormattedText   -   WebView.CreateWithControl

Feedback: Report problem or ask question.




Links
MBS Xojo tutorial videos