| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
DragDrop.CreateWithWindow
Creates a new drop area which covers the whole window.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| DragDrop | 2.4 | ✅ Yes | ✅ Yes | ❌ No | ❌ No | ❌ No |
Deprecated
This function was deprecated. Use DragDrop.AttachToWindow instead.
Parameters
| Parameter | Description | Example |
|---|---|---|
| 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 |
Result
Returns Drop Area ID on success.
Description
Creates a new drop area which covers the whole window.Use DragDrop.Release later to destroy the drop area.
If you use a register (tab controls) on the window, be aware that the drop area actually is in front of the register (tab controls). So you need to check in the script which register page is current and should get the dropped files.
Drag & Drop reference numbers are starting at 31000 and counting up for each new drop area.
Added Windows support for MBS Plugin 8.1 for FileMaker 16 or newer. On Windows the control can't be transparent, so you may not want to use this function on Windows.
Not recommended for Windows. Better use DragDrop.CreateWithControl.
Examples
Setup drop area:
Set Variable [ $DragDrop ; Value: MBS( "DragDrop.CreateWithWindow"; 0 ) ]
# we accept emails here
Set Variable [ $r ; Value: MBS( "DragDrop.RegisterDropTypes"; $DragDrop; "Emails") ]
# Script trigger
Set Variable [ $r ; Value: MBS( "DragDrop.SetDragActionHandler"; $DragDrop; Get ( FileName ); "Trigger") ]
# copy cursor
Set Variable [ $r ; Value: MBS( "DragDrop.SetCursor"; $DragDrop; 2 ) ]
# Backgound is a picture
Set Variable [ $r ; Value: MBS( "DragDrop.SetImage"; $DragDrop; DragDrop::MyPicture) ]
See also
- DragDrop.AttachToWindow
- DragDrop.CreateWithControl
- DragDrop.CreateWithSize
- DragDrop.RegisterDropTypes
- DragDrop.Release
- DragDrop.SetCursor
- DragDrop.SetDragActionHandler
- DragDrop.SetImage
- ImageView.CreateWithWindow
- Window.FindByIndex
Release notes
- Version 11.2
- Deprecated DragDrop.CreateWithWindow in favor of DragDrop.AttachToWindow function.
- Version 11.0
- Changed DragDrop.CreateWithControl, DragDrop.CreateWithSize, DragDrop.CreateWithWindow to return an error if the control can't be created properly.
Example Databases
Blog Entries
- MBS FileMaker Plugin, version 11.2pr4
- MBS FileMaker Plugin, version 10.6pr1
- Accept file drops in Filemaker with MBS Plugin
FileMaker Magazin
This function checks for a license.
Created 18th August 2014, last changed 20th April 2021
