SET FILE TO PASTEBOARD
SET FILE TO PASTEBOARD ( file {; *} )
| Parameter | Type | Description | |
|---|---|---|---|
| file | Text | → | File name or complete pathname of file |
| * | Operator | → | If passed = add; If omitted = replace |
This command is not thread-safe, it cannot be used in preemptive code.
Description
The SET FILE TO PASTEBOARD command adds the complete pathname of the file passed in the file parameter. This command can be used to set up interfaces allowing the drag and drop of 4D objects to files on the desktop for example.
In the file parameter, you can pass either a complete pathname or a simple file name (without a pathname). In the latter case, the file must be located next to the database structure file.
The command accepts the star * as an optional parameter. By default, when this parameter is omitted, the command replaces the contents of the pasteboard by the last pathname specified by file. If you pass this parameter, the command adds the file to the pasteboard. This way it can contain a "stack" of file pathnames. In both cases, if data other than pathnames was present in the pasteboard, it is erased.
Note: The pasteboard is in read-only mode during the On Drag Over form event. It is therefore not possible to use this command in that context.