CLIPTOFILE Verb - Copy Clipboard Data to New String File
Syntax
CLIPTOFILE fmt,file$[,ERR=lineref]
Description
For BBj-specific information, see the Clipboard
Verbs and Functions.
The CLIPTOFILE verb creates a string file, copies the fmt-parameter-specified
clipboard format data to the file, and closes the file. The application
is responsible for parsing the file data. For bitmapsTCB (format 8), Visual
PRO/5 creates the appropriate .bmp
file format that can then be processed by the 'IMAGE' mnemonic or another
application. If file$ already exists, an !ERROR=12
is generated. If the requested format is unavailable, an !ERROR=92 is
generated. In this case, the error code returned by windows and placed
in TCB(10) is unreliable. Visual PRO/5 sets TCB(10)
to 93 to indicate that although windows did not return an error code,
the operation failed.
|
Parameter |
Description |
|---|---|
|
fmt |
An unsigned integer that represnets a clipboard format registered by CLIPREGFORMAT(). |
|
file$ |
Name of a string file to be created by CLIPTOFILE. |
|
ERR=lineref |
Branch to be taken if an error occurs during execution. |