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

Preview.CreateWithControl

Creates a new preview on the given window covering the area of the given control.

Component Version macOS Windows Linux Server iOS SDK
Preview 13.3 ✅ Yes ✅ Yes ❌ No ❌ No ❌ No
MBS( "Preview.CreateWithControl"; WindowRef; ControlName { ; DX; DY; classID } )   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
ControlName The name of the control on your FileMaker form.
e.g. you can place a rectangle there to define the position.
"mymedia"
DX Available in MBS FileMaker Plugin 14.3 or newer.
A delta to move drop area more to left or right.
0 Optional
DY Available in MBS FileMaker Plugin 14.3 or newer.
A delta to move drop area more to top or bottom.
0 Optional
classID Available in MBS FileMaker Plugin 14.3 or newer.
The class UUID for the preview handler to use.
Optional

Result

Returns reference number or error.

Description

Creates a new preview on the given window covering the area of the given control.
A way to display a PDF Viewer in FileMaker independent of an interactive container.
Available on Windows 10 and newer.

If you use a register (tab controls) on the window, be aware that the preview actually is in front of the register (tab controls). You may hide the preview if another register is visible.

Use Preview.Release later to destroy the text view.
Preview reference numbers are starting at 92000 and counting up for each new text view.

When creating on a card window, please pass reference to parent window or just 0 for front window. On MacOS you may need to pass delta y value to adjust position.

If you create a control on a new window, you may do window update command in your script first to have FileMaker actually build the window with controls and display it. A short script pause or using FM.RunScriptLater with 0.1 delay can help having all controls draw themselves. Then you can use this command to put our control on top. We use GetLayoutObjectAttribute() to query left, top, width and height and this gives empty value if control is not yet here.

Creation fails to pick the right window in case the window is selected by name and the window name is not unique. In that case better work with window reference numbers or just pass 0 for current front window.

On macOS, this uses QuickLook preview, so you can show other file types if needed.

See HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\PreviewHandlers in the registry for available preview handlers for Windows beside PDF Viewer one.

Examples

Create with placeholder control:

# let FileMaker draw layout
Pause/Resume Script [ Duration (seconds): ,1 ]
#
# now add control
Set Variable [ $$preview ; Value: MBS( "Preview.CreateWithControl"; 0; "placeholder") ]
#
If [ MBS("IsError") ]
    Show Custom Dialog [ "Failed to create preview contr…" ; $$preview ]
    Set Variable [ $$preview ; Value: "" ]
End If
#
# load content
If [ not IsEmpty ( PDF Viewer::PDF Container ) ]
    Set Variable [ $r ; Value: MBS( "Preview.LoadContainer"; $$preview; PDF Viewer::PDF Container ) ]
    If [ MBS("IsError") ]
        Show Custom Dialog [ "Failed to load container" ; $r ]
    End If
Else If [ not IsEmpty ( PDF Viewer::PDF Path ) ]
    Set Variable [ $r ; Value: MBS( "Preview.LoadFile"; $$preview; PDF Viewer::PDF Path ) ]
    If [ MBS("IsError") ]
        Show Custom Dialog [ "Failed to load file" ; $r ]
    End If
End If

Load the RTF preview handler:

Set Variable [ $$preview ; Value: MBS( "Preview.CreateWithControl"; 0; "placeholder"; 0; 0; "{a42c2ccb-67d3-46fa-abe6-7d2f3488c7a3}") ]

See also

Release notes

  • Version 14.3
    • Added DX, DY and ClassID parameters to Preview.CreateWithControl and Preview.Create functions.

Example Databases

Blog Entries

This function checks for a license.

Created 12nd June 2023, last changed 3th June 2024


Preview.Create - Preview.GetAutoResizingMask