Macro Language Reference > Macros > Application > tcut
  
tcut
Description
Cuts selected frames, text or graphics into the appropriate clipboard file, removing them from your document. When in Page Mode the selected frame, frames or groups of frames are cut to the frame clipboard (clip.3p). By default only the frames' attributes are cut, not their contents: if you want to copy (but not, in fact, cut) their contents as well you should use the extended switch listed below.
 
Example 15. Cut selected text to a file in PTC ALD format
The macro below cuts selected text to a file in PTC ALD format. Used with a filename parameter, tcut provides you with a simple way of maintaining several 'boilerplate' clipboards, which can then be accessed using the tpaste macro.
tcut "c:/3d/test.3t"
Syntax
tcut cut:n? filename:s? extended:n?
tcut
[no parameter]
The mode in which PTC ALD is set will determine what items can be cut using the tcut macro. Items are cut to their respective clipboards as follows:
Text Mode: selected text is cut to the text clipboard clip.3t
Page Mode: selected frame, frames or groups of frames are cut to the frame clipboard clip.3p
Graphics Mode: selected graphics are cut to the graphics clipboard clip.3o
cut
10
Delete word in front of cursor
11
Delete word behind cursor
filename
The name of a file in PTC ALD format (e.g. .3p, .3t, or .3o) to which you want to cut your selection.
extended
0
When cutting frames only the frame attributes are cut (default).
1
When cutting frames the frame attributes are cut and any dependant contents are copied. All tags directly attached to the frame are recursively searched to find any other tags that will be required to reproduce the frame and its contents in another document.
Additional Information
In all cases, the tag itself is not cut - if you want to delete a tag altogether you must use a ttagdel action.
On Windows systems, there is only one global clipboard which applies to Page, Text and Graphic Modes. This clipboard is context sensitive and responds to cut/copy/paste operations in a sensible way.