Monkeybread Software - MBS FileMaker Plugin: ImageView.CreateWithControl

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

ImageView.CreateWithControl

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

Component	Version	macOS	Windows	Server	FileMaker Cloud	FileMaker iOS SDK
ImageView	7.4	Yes	No	No	No	Yes

MBS( "ImageView.CreateWithControl"; WindowRef; ControlName { ; DX; DY } ) More

Parameters

Parameter Description Example value

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. For example "mymedia" if you assign this name to a media field. This is not the name of the field in the database! "mymedia"

DX Optional
A delta to move drop area more to left or right. 0

DY Optional
A delta to move drop area more to top or bottom. 0

Parameter	Description	Example value
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. For example "mymedia" if you assign this name to a media field. This is not the name of the field in the database!	"mymedia"
DX	Optional A delta to move drop area more to left or right.	0
DY	Optional A delta to move drop area more to top or bottom.	0

Result

Returns image view reference number or error.

Description

Creates a new image view on the given window covering the area of the given control.
Use ImageView.Release later to destroy the image view.

If you use a register (tab controls) on the window, be aware that the image view actually is in front of the register (tab controls). So you need to check in the script which register page is current and should show what image view. Or by a trigger you turn the visibility on and off.

Image view reference numbers are starting at 74000 and counting up for each new image view.

Examples

Create image view with control as placeholder:

# Query size of image
Set Variable [ $Image ; Value: MBS( "GMImage.NewFromContainer"; ImageView::ImageContainer ) ]
Set Variable [ $w ; Value: MBS( "GMImage.GetWidth"; $Image ) ]
Set Variable [ $h ; Value: MBS( "GMImage.GetHeight"; $Image ) ]
Set Variable [ $r ; Value: MBS( "GMImage.Release"; $Image ) ]

# We play half size for retina screen resolution
Set Variable [ $h ; Value: Round($h/2;0) ]
Set Variable [ $w ; Value: Round($w/2;0) ]

# We play half size for retina screen resolution
Set Variable [ $$ImageView ; Value: MBS("ImageView.CreateWithControl"; 0; "PlaceHolder") ]
Set Variable [ $r ; Value: MBS("ImageView.SetImage"; $$ImageView; ImageView::ImageContainer) ]

Example Databases

Mac and iOS/ImageView

Created 14th September 2017, last changed 21st December 2018

ImageView.Clear - ImageView.CreateWithSize