API
RCC.PhotoGrid.Version
versionReturns the plug-in version string.
Use this for diagnostics, support, and confirming the installed plug-in build.
versiondiagnosticssupport
API
RCC.PhotoGrid.CreateWithControl
createCreates an overlay anchored to a named FileMaker layout object and returns a gridID.
The plug-in evaluates GetLayoutObjectAttribute for the named object in the current calculation context.
createoverlaylayout objectgridIDGetLayoutObjectAttribute
RCC.PhotoGrid.CreateWithControl ( windowName ; objectName )
API
RCC.PhotoGrid.SetFrameWithControl
positioningMoves an existing overlay to match a named layout object.
Use this when the placeholder object changes or when you want to rebind an existing grid to a different object.
positioninglayout objectoverlay
RCC.PhotoGrid.SetFrameWithControl ( gridID ; objectName )
API
RCC.PhotoGrid.SetFrame
positioningManual positioning escape hatch using FileMaker work-area coordinates.
Useful for debugging or layouts where named object geometry is not the right fit.
positioningmanualcoordinates
RCC.PhotoGrid.SetFrame ( gridID ; left ; top ; width ; height )
API
RCC.PhotoGrid.Refresh
refreshRe-resolves the saved object frame after window, layout, sidebar, or panel changes.
Prefer the window-scoped form in multi-window FileMaker solutions.
refreshresizemulti-windowlayout
RCC.PhotoGrid.Refresh ( gridID )
RCC.PhotoGrid.Refresh ( windowName ; gridID )
API
RCC.PhotoGrid.SetData
jsonLoads the JSON array of photo/file items into the grid.
Bad JSON returns an ERROR string. The grid accepts images, videos, PDFs, documents, folders, and generic file hints.
jsondatafound setthumbnailselection
RCC.PhotoGrid.SetData ( gridID ; json )
API
RCC.PhotoGrid.LoadDemoData
demoLoads generated placeholder records for a quick smoke test.
Use this before wiring your found-set JSON.
demotestsmoke test
RCC.PhotoGrid.LoadDemoData ( gridID )
API
RCC.PhotoGrid.GetSelectedIDs
selectionReturns selected IDs as FileMaker return-delimited text.
Selection is cached natively after every click, Shift-click, or Option/Alt-click.
selectionidsreturn-delimited
RCC.PhotoGrid.GetSelectedIDs ( gridID )
API
RCC.PhotoGrid.ShowImage
viewerShows a full-resolution browser-displayable image in the viewer.
Use the window-scoped form when callback scripts may run from multiple FileMaker windows.
viewerimagedataURLlazy loading
RCC.PhotoGrid.ShowImage ( gridID ; dataURL ; title )
RCC.PhotoGrid.ShowImage ( windowName ; gridID ; dataURL ; title )
API
RCC.PhotoGrid.ShowQuickLook
viewerShows a full-resolution file using browser image display or native Quick Look.
Best for PDFs, videos, and files that should preview without converting to a thumbnail-only image.
viewerQuick Lookpdfvideofile
RCC.PhotoGrid.ShowQuickLook ( gridID ; dataURL ; title )
RCC.PhotoGrid.ShowQuickLook ( windowName ; gridID ; dataURL ; title )
API
RCC.PhotoGrid.GetOpenRequest
callbackReturns the most recent open/click request JSON.
Prefer Get ( ScriptParameter ) inside callbacks. Use this as a fallback.
callbackopenclickfallback
RCC.PhotoGrid.GetOpenRequest ( gridID )
RCC.PhotoGrid.GetOpenRequest ( windowName ; gridID )
API
Click script registration
single clickRegisters single-click, double-click, and legacy open scripts.
SetOpenScript remains a deprecated alias for SetDoubleClickScript. If a click script is not declared, selection still works but no script runs.
single clickdouble clickopencallbackdeprecated
RCC.PhotoGrid.SetSingleClickScript ( gridID ; scriptName )
RCC.PhotoGrid.SetDoubleClickScript ( gridID ; scriptName )
RCC.PhotoGrid.SetOpenScript ( gridID ; scriptName )
API
Drop, delete, and save script registration
dropRegisters scripts for file drop import, context-menu delete, and Save Changes.
SetDeleteScript also enables the built-in Delete context-menu action.
dropdeletesavecontext menucallback
RCC.PhotoGrid.SetDropScript ( gridID ; scriptName )
RCC.PhotoGrid.SetDeleteScript ( gridID ; scriptName )
RCC.PhotoGrid.SetSaveScript ( gridID ; scriptName )
API
iPhone/camera import
iPhoneOpens the native macOS Image Capture import window and calls a FileMaker script with imported files.
SetIPhoneImportScript is preferred. If unset, ImportFromIPhone falls back to the grid's drop script. Windows returns an error for ImportFromIPhone.
iPhonecameraImage CapturemacOSimport
RCC.PhotoGrid.SetIPhoneImportScript ( gridID ; scriptName )
RCC.PhotoGrid.ImportFromIPhone ( gridID )
API
Context menu and display options
optionsControls built-in menu actions, visible chrome, initial modes, widget presets, and thumbnail sizing.
Use JSON booleans for simple states or object values for visible/enabled control.
optionscontext menudisplayminimalHorizontalView
RCC.PhotoGrid.SetContextMenuOptions ( gridID ; optionsJSON )
RCC.PhotoGrid.SetDisplayOptions ( gridID ; optionsJSON )
API
RCC.PhotoGrid.SetDragExportScript
drag exportRegisters the script called after a drag-out operation receives a Finder/Desktop destination.
Use the payload IDs to find records, then export each container to destinationFileMakerPath.
drag exportFinderDesktopfile promise
RCC.PhotoGrid.SetDragExportScript ( gridID ; scriptName )
API
Debug and lifecycle
debugInspect grid state or close one/all overlays.
Close overlays on layout unload, file close, or solution shutdown when you do not want them to persist.
debugcloselifecyclecleanup
RCC.PhotoGrid.GetDebugStatus ( gridID )
RCC.PhotoGrid.Close ( gridID )
RCC.PhotoGrid.CloseAll