4D Doc Center : SET FILE TO PASTEBOARD

Home

4D v14.3

SET FILE TO PASTEBOARD


SET FILE TO PASTEBOARD ( file {; *} )

Parameter	Type	Description
file	String	File name or complete pathname of file
*	Operator	If passed = add; If omitted = replace

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.