Home | Tips | Library | Other Authors | Other WP Sites | Writer's Links | Contact | Site Map | Donate

Barry MacDonnell's
Toolbox for WordPerfect

Macros, tips, and templates for Corel® WordPerfect® for Windows®
© Copyright 1996-2017 by Barry MacDonnell. All Rights Reserved.

Page updated May 1, 2016

CLIPPER - A macro that copies or moves material from one or more open documents to a separate document

Download CLIPPER.ZIP (v1.16; 11/14/12; 21,386 bytes)

Compatible with WordPerfect 8 and later versions.

WordPerfect 11 users: See important information about using macros in the first release of WP11 (11.0.0.233) at the top of this page.

Downloading, Documentation, Modifications, and Support

See also Splitter

Purpose

The Clipper.wcm macro lets you

•  select material (with your mouse or keyboard) in the current document (or any open document; see Features below), and

•  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.]

Features

•  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.

Operation and options 

[1] Play 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).

[2] 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.

[3] 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.

[4] 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.

Limitations

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.

Alternative

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.

Tips

☼  Viewing the progress of your clips:
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.