Macro Language Reference > Macros > System > clipboards
  
clipboards
Description
Provides the ability to assign cut/copy/paste keystrokes to twenty clipboards and includes a dialog for managing clipboards.
 
Example 223. Examples of clipboard actions
Clear clipboards 1,2 and 3:
clipboards *,1,2,3
Load all defined clipboards into the default clipboards file:
clipboards 1,"{@}sclip.3l"
Load clipboards 1,2 and 3 from the default clipboards file:
clipboards 1,"{@}sclip.3l",1,2,3
Save all clipboards into the file specified by the user via the Save Clipboards dialogue:
clipboards s
Syntax
clipboards *:L? ( ( l:s ) | ( s:s ) )? file:s? clip:n?
clipboards
[no parameter]
Invoke the Clipboards Explorer dialog box.
*
Clear clipboards
l
Load clipboard definitions from file
s
Save all clipboards into the file specified via the Clipboards dialog box.
file
The filename for load and save actions: if this is not supplied, a Load or Save dialog box will be displayed to allow the user to select a file.
clip
One or more clipboard(s) to which the action should be applied: defined in a comma separated list. If clipboards are not specified, the action is performed for all clipboards.
Additional Information
The multiple clipboards are completely separate from PTC ALD existing clipboards and are loaded with content when PTC ALD starts. The content is sourced from a file called sclip.3l, which is located in the PTC ALD executable directory. If this file does not exist, no content is loaded into the clipboards. This file is in the multiple clipboards format which is also compatible with the PTC ALD library format. For example, the data from clipboard files can be loaded into a document as tags using tdldtag.
The dialog box has a list on the left hand side that displays all currently available clipboards; clicking on a clipboard from this list will display its contents in the Contents and Raw tab text areas. The Contents text area displays a description of the clipboard and its contents in an easy to read format, but will not display the content of graphics types or encrypted clipboards. The Raw tab text area displays the raw clipboard data.
Clicking the Clear button will immediately clear the currently selected clipboard. Clicking the Copy to Windows button will copy the content of the currently selected clipboard to the Windows system clipboard (this last feature is, obviously, specific to Windows versions of PTC ALD ).
For all clipboards the Load and Save buttons will open a dialog box allowing the user to select a file that will then be used to either load or save all clipboard definitions. The default clipboard filename is sclip.3l. The Done button exits the dialog box.