Adobe 65030365 Scripting Guide - Page 491

ADOBE FRAMEMAKER SCRIPTING GUIDE 483 Function Summary Flags Meaning Constants.FF_VISIBLE_ONLY (0x0010) Cut only the visible portion of the selection. Constants.FF_DONT_DELETE_HIDDEN_TEXT (0x0004) Do not replace hidden text. Constants.FF_DONT_APPLY_ALL_ROWS (0x0040) Do no't apply condition setting on the Clipboard to all rows. If whole table is selected and the Clipboard contains condition setting, cancel the paste operation. Constants.FF_REPLACE_CELLS (0x0020) Replace selected cells with cells on the Clipboard. Constants.FF_INSERT_BELOW_RIGHT (0x0008) Add columns to the right of the current column or below the current row. When you use the Paste() method to paste table cells into a table, it does not work exactly like the interactive Paste command. The interactive Paste command automatically overwrites cells if the Clipboard contains less than an entire row or column. For example, if the insertion point is in a three-column table and the Clipboard contains a single cell, the interactive Paste command overwrites the cell containing the insertion point with the cell on the Clipboard. If two cells in the table are selected, the interactive Paste command overwrites both of them with the cell on the Clipboard. By default, the Paste() method does not overwrite any cells. If the Clipboard contains less than an entire row or column when you call Paste(), or if the current selection is less than an entire row, the Paste() method does nothing and returns Constants.FE_BadSelectionForOperation (-59).The method ensures that you do not inadvertently overwrite any cells. To make the Paste() method replace cells with the Clipboard contents, you must call it with the Constants.FF_REPLACE_CELLS (0x0020) flag set. The Constants.FF_INTERACTIVE (0x0001) flag takes precedence over other flags. If you specify Constants.FF_INTERACTIVE (0x0001)|Constants. FF_DONT_DELETE_HIDDEN_TEXT (0x0004) and the selection contains hidden text, FrameMaker prompts the user, and allows the user to choose whether to delete the hidden text or retain it. It is illegal to specify Constants.FF_REPLACE_CELLS (0x0020)| Constants.FF_INSERT_BELOW_RIGHT (0x0008). The method returns FE_Success on success. On failure, the method returns one of the following values to FA_errno: Error Constants.FE_BadOperation (-27) Constants.FE_BadDocId (-2) Constants.FE_BadSelectionForOperation (-59) Constants.FE_Canceled (-44) Reason Function call specified an illegal operation. Invalid document. Current text selection is invalid for this operation. User canceled the operation. Returns int Syntax Paste(flags) Last updated 9/26/2011