Progress
External Program
Interfaces
CLIPBOARD System Handle
The CLIPBOARD system handle allows you to transfer data between the window system clipboard and your Progress application. Using the CLIPBOARD attributes, you can paste (read) data from the system clipboard to a Progress field or variable, and copy or cut (write) data from a field or variable to the clipboard. These cut, copy, and paste data transfers are the basic clipboard operations typically provided by the system clipboard to the user.
In Progress, you also have a choice of two data transfer modes to implement these operations — single-item transfers and multiple-item transfers. In single-item transfers, a single write to the clipboard immediately replaces all data in the clipboard, and a single read from the clipboard returns all data in the clipboard to the Progress application. In multiple-item transfers, you can format the data transfer into multiple rows of multiple items. Each write to the clipboard adds an item to a tab- and newline-separated list of clipboard items; each read from the clipboard returns one tab- or newline-separated item to your Progress application. This mode is especially useful to allow users to transfer aggregate units of data, in one step, between Progress and other applications (such as spreadsheets) that also support aggregate clipboard operations in a similar way.
These data transfers are accomplished with the help of the CLIPBOARD handle attributes listed in Table 3–1.
Table 3–1: CLIPBOARD Handle Attributes Attribute Type Readable Setable AVAILABLE-FORMATS CHARACTER – ITEMS-PER-ROW INTEGER MULTIPLE LOGICAL NUM-FORMATS INTEGER – TYPE CHARACTER – VALUE CHARACTER
The following sections provide an overview of the CLIPBOARD handle attributes. For a complete description of the CLIPBOARD handle and its attributes, see the CLIPBOARD Handle reference entry in the Progress Language Reference .
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |