| Barry MacDonnell's
Toolbox for WordPerfect
Macros, tips, and
templates for Corel® WordPerfect® for Windows®
| Page updated May 1, 2016
|CLIPPER - A macro that copies or moves material from one or more open documents to a separate document|
See also Splitter
The Clipper.wcm macro lets you
• select material (with
your mouse or keyboard) in the current document (or any open document; see Features below),
• automatically clip (i.e., copy or move) it to a separate temporary
document with a mouse click, then
• return you back to the original
document so you can make another selection.
Several options are available from a pop up menu (see below).
[Tip: To split the current document into several new documents on disk, see Splitter.]
• A small pop-up dialog [image] or "clipper tool" remains on screen until dismissed, to allow multiple clips while the macro is active.
• You can have up to eight (8) open documents on screen from which to clip material; the macro will open and use a new temporary document to hold all your clips in one place.
[Update July 2012: If you use WordPerfect X6 (or later) in multiple-instance mode (i.e., separate windows), you must use Clipper on documents that are only open in the same instance of WordPerfect in which you launched Clipper. See Limitations below.]
• Clipped material is appended to previous selections (i.e., in sequential order) in the separate document. Each clip is separated with hard returns, short dashes, or full-length (custom) lines, depending on which menu choice you make when you start Clipper.
• You can navigate forward and backward in the current document, or even open and/or switch between other source documents, whenever Clipper is active.
• Starting with version 1.16 you can also clip material from inside text boxes, text box captions, and graphic captions.
the macro (see the Downloading... link in the left sidebar if you are
not familiar with getting and using a macro from a site like this).
 The macro will display an initial menu and then it lets you clip material from the following areas -
• body text (including text to which a style has been applied)
• headers and footers
• footnotes and endnotes
• text boxes (including their captions, if any)
• graphic image captions
• WordPerfect comments
• [WordPerfect X6 and later:] any document in the same WordPerfect window from which the macro was started (see Limitations below)
Note: Other areas of the document cannot be processed. For example, if you try to edit and select material inside a watermark or a style code the macro will display an error message and then quit (previously stored clips in the temporary document are not affected). These items are part of a group of several WordPerfect "substructures" that are not designed to be "click-to-edit" from the main document screen during typical document editing.
Menu options let you -
• either copy -or- move the selected material to the new temporary document
• add redline attributes to selections in the current document (and optionally remove all redline first from the current document)
• clip material as unformatted ("plain") text -or- clip it with all attributes (bold, italic, etc.) and any graphics and/or highlighting [open Reveal Codes to ensure you select and clip any desired leading/trailing format codes, such as back tabs or style codes]
• set the type of separator between clips -- e.g., hard returns, a short dashed line, or a full length graphic line (also see Tips below)
• set the position of the Copy or Move dialog box ("clipper tool") on your screen
Note: Menu default choices and the style of the custom line can be set at the top of the macro code in the redlined User Modification Area of the macro code.
 As noted above, a small pop-up dialog [image] or "clipper tool" remains on screen until dismissed, to allow multiple clips while the macro is active. Depending on your initial menu choice it will be labeled "COPY" or "MOVE". Just click the "Add to List" button to copy (or move) the selected material to the separate clippings document.
 When you have finished clipping click the "Done" button on the clipper tool dialog. The macro will return to the separate clippings document, which you can then save to disk.
WordPerfect X6 introduced the ability to open multiple instances of itself (a/k/a separate windows), each containing up to 9 documents. Each such instance is in a separate program window (often lying one on top of the other).
However, when Clipper was written the macro language did not appear to provide a means to determine when the cursor is in a separate window. Hence, this macro will not clip anything from any window that is different from the one where the macro was started. If you try to do it, you probably will see an error message and you probably will find some duplicate entries in the clip list -- i.e., the last entry stored on the Windows clipboard will be re-used as the "clip".
This limitation might change in the future, probably depending on Corel implementing new macro commands, but for now it is best to clip material only from open documents in the same program window from which you started the macro. An alternative to Clipper: WordPerfect has a built-in feature, Edit>Append, that can append sequential selections of copied text to previous selections on the Windows clipboard. Simply copy the first selection with the usual Edit>Copy (or <Ctrl+C>) and then make subsequent copies with Edit>Append. When you paste the material in another location or another document, the clips will be pasted together as one.
Unlike Clipper, however, the Edit>Append feature doesn't let you separate the clips, or move them (cut-and-paste) out of one document and into another (you have to delete the original selections).
Note that the Edit>Append feature can be assigned to a keystroke combination such as <Alt+C>. See here.
While Clipper is active you can view your clips in the temporary document any time. The easiest way is to click on its Document tab on the Appl;ication Bar. (This can be enabled with View, Application Bar.)
☼ Text boxes and box captions:
If you want to clip material from a text box, box caption, or graphic caption, double-click on the box to get inside the box, then make your selection. If you simply select the entire box or graphic from the main screen you will need to also select some adjacent text, or Clipper will not "see" the box or image.
☼ Using the clips with indexes:
Clipper can be used to copy words and phrases into a separate (new) document, which can then be saved and used as a concordance file to help index a document. Use the options to copy the clipped material as plain text and separate the items with a single hard return. The document could also be added to an existing concordance such as one created with the WordList macro, to create a comprehensive concordance file. Related tip: You can also quickly convert normal spaces in selected phrases into hard spaces with the Hspacer macro to keep the selected words together in the index.
☼ Removing redline:
You can play the macro at a later time to remove all redline attributes from a document that you might have added with option 2 above or that you might have added by the usual methods (e.g., Format, Font, Redline): Simply enable the checkbox, "Remove existing redline codes," play the macro, then exit from the macro. This merely does the same thing as using Find and Replace to remove all [Redln] codes in the document.
Redine can also be removed or changed to other attributes (bold, underline, italic, highlighting, etc.) with the Replace Codes macro at http://wptoolbox.com/otherauthors.html#ronhirsch
☼ Changing the dashed line after Clipper plays:
If you used the short dashed line (- - - - -) option to separate all clipped text in the new document, you can use Edit> Find and Replace to change these separators to something else, such as a symbol (using Ctrl+w to insert a symbol in the Replace field): Select the first dashed line with mouse or keyboard, then bring up the Find and Replace dialog (the selected dashed line should then be seen in the Find field). Enter a replacement character or string of characters or symbol, then click Replace All.
☼ Menu defaults:
Your prreferred choices can be set at the top of the macro code in the User Modification Area of the macro code.