5.3 DUIM-Sheets Module

with-clipboard

Statement macro

Summary

Evaluates a body of code with a clipboard grabbed.

Signature

with-clipboard (clipboard = sheet) body end

Arguments

clipboard: A Dylan variable-name_bnf.
sheet: A Dylan variable-name_bnf.
body: A Dylan body_bnf.

Values

values: Instances of <object>.

Library

duim-sheets

Module

duim-sheets

Description

Evaluates body with the clipboard grabbed, returning the results to the clipboard.

The macro grabs a lock on the clipboard, using open-clipboard, and then executes body. Once the results of evaluating body have been sent to the clipboard, the clipboard lock is freed using close-clipboard. The clipboard argument is a Dylan variable-name_bnf used locally in the call to with-clipboard. The sheet argument is a Dylan variable-name_bnf that evaluates to the sheet associated with clipboard.

This macro is the easiest way of manipulating the clipboard from DUIM, since it removes the need to create and destroy a clipboard lock yourself.

You can add more than one format of your data to the clipboard within the scope of this macro. So, for example, you could place an arbitrary object onto the clipboard, for use within your own application, and a string representation for other tools applications to see.