Cut
Deletes the contents of the specified field in the current record and saves the contents to the Clipboard.
Options
-
Select entire contents deletes the contents of a field in the current record and saves it to the Clipboard. If you do not use Select entire contents, only the selected portion of the field's data is cut.
-
Go to target field specifies the field whose contents you want to cut.
Compatibility
Product | Supported |
FileMaker Pro | Yes |
FileMaker Go | Yes |
FileMaker WebDirect | Partial |
FileMaker Server | Yes |
FileMaker Cloud | Yes |
FileMaker Data API | Yes |
Custom Web Publishing | Yes |
Originated in version
6.0 or earlier
Description
This script step removes the contents of the field. If the field is not on the current layout, FileMaker Pro returns an error code which can be captured with the Get(LastError) function.
To duplicate the field information, use the Copy script step.
Notes
-
Contents that you cut or copy to the Clipboard are accessible to other applications.
-
With FileMaker WebDirect, the Cut script step does not place data onto the Clipboard.
-
If you manually select field data before you run this script step in FileMaker WebDirect, the script step performs as if you did not make a selection. To select field data before you run this script step in FileMaker WebDirect, use the Set Selection script step.
Example 1
Cuts the contents of the Email field in the current record.
Cut [Customers::Email]
Example 2
Prompts the user to either cut or copy the contents of the Email field.
Show Custom Dialog ["Do you want to cut or copy the customer's email address?"]
If [Get ( LastMessageChoice ) = 1]
Cut [Customers::Email]
Else If [Get ( LastMessageChoice ) = 2]
Copy [Customers::Email]
End If