jfig.commands
Class PasteFromClipboardCommand

java.lang.Object
  jfig.commands.Command
      jfig.commands.PasteFromClipboardCommand

public class PasteFromClipboardCommand

extends Command

read objects from the system clipboard.

A PasteFromClipboardCommand reads the current contents of the system clipboard and tries to reconstruct any FIG objects from that. If the clipboard contains a valid FIG 3.1 or FIG 3.2 file, the objects are read from that file. If no valid FIG file is found, the contents of the clipboard is read as a simple ASCII text and converted to FigText objects, one FigText object per line. The resulting FIG objects are merged into a single FigCompound object, which is then merged with the current drawing. However, if the command is executed with a middle click, the temporary compound is automatically broken. (This two step technique has the advantage of allowing an undo...)

See Also:

CutToClipboardCommand, CopyToClipboardCommand

Field Summary

(package private) FigCompound	buffer
(package private) ConsoleMessage	console
(package private) java.awt.Point	endPoint
(package private) java.awt.Point	startPoint

Fields inherited from class jfig.commands.Command

editor, objectCanvas, ready

Constructor Summary

PasteFromClipboardCommand(FigBasicEditor editor, FigCanvas objectCanvas)

PasteFromClipboardCommand(FigBasicEditor editor, FigCanvas objectCanvas, ConsoleMessage _console)

Method Summary

void	execute() execute the current editor command
java.lang.String	getDescription() one-line description of this command
FigObject[]	getModifiedObjects() return an array-wrapped reference to the compound object (to be) pasted into the drawing.
void	mousePressed(FigCanvasEvent evt) react to a mouse click on the editor canvas
void	readClipboard() read the clipboard contents and fill the FigCompound "buffer" variable
java.lang.String	toString() return a (possibly verbose) description of this Command object
void	undo() undo this command

Methods inherited from class jfig.commands.Command

cancel, isReady, message, notifyEditor, statusMessage

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

buffer

FigCompound buffer

startPoint

java.awt.Point startPoint

endPoint

java.awt.Point endPoint

console

ConsoleMessage console

Constructor Detail

PasteFromClipboardCommand

public PasteFromClipboardCommand(FigBasicEditor editor,
                                 FigCanvas objectCanvas)

PasteFromClipboardCommand

public PasteFromClipboardCommand(FigBasicEditor editor,
                                 FigCanvas objectCanvas,
                                 ConsoleMessage _console)

Method Detail

getModifiedObjects

public FigObject[] getModifiedObjects()

return an array-wrapped reference to the compound object (to be) pasted into the drawing. The compound object reference may be null.

Overrides:

getModifiedObjects in class Command

execute

public void execute()

Description copied from class: Command

execute the current editor command

This method is empty for class Command.

Overrides:

execute in class Command

undo

public void undo()

Description copied from class: Command

undo this command

Try to undo this command as far as possible. Don't try to undo() a command that has never been execute()d before. This method is empty for class Command.

Overrides:

undo in class Command

mousePressed

public void mousePressed(FigCanvasEvent evt)

Description copied from class: Command

react to a mouse click on the editor canvas

This method provides the central callback from the editor to its current command object. Passing a FigCanvasEvent parameter, the editor provides information both about the screen coordinates and the world coordinates of the mouse event.

Naturally, mouse presses are ignored for class Command.

Overrides:

mousePressed in class Command

readClipboard

public void readClipboard()

read the clipboard contents and fill the FigCompound "buffer" variable

getDescription

public java.lang.String getDescription()

Description copied from class: Command

one-line description of this command

return a one-line desription of this command, e.g. to label the undo/redo buttons, if any

Overrides:

getDescription in class Command

toString

public java.lang.String toString()

Description copied from class: Command

return a (possibly verbose) description of this Command object

Overrides:

toString in class Command