chemaxon.marvin.modules.datatransfer
Class ClipboardHandler

java.lang.Object
  chemaxon.marvin.modules.datatransfer.ClipboardHandler

public final class ClipboardHandler
extends java.lang.Object

Facade of the Clipboard handling in Marvin.

Utility class that can be used to transfer Molecule or other data from Marvin to the system clipboard using cut/copy/paste operations.

Since:

Marvin 5.3 11/25/2009

Author:

Istvan Fajth

Field Summary

static java.lang.String	BMP_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	CDX_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	CXSMILES_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	DEFAULT_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	EMF_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	GIF_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	IUPAC_INCHI_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	IUPAC_INCHIKEY_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	IUPAC_NAME_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	JPG_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	MDL_MOL_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	MDL_RXN_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	MRV_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	OLE_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	PDF_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	PNG_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	PS_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	SKC_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	SMILES_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	STRING_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4
static java.lang.String	TIFF_TRANSFERABLE_NAME Deprecated. will be deleted in 5.4

Method Summary

static void	addTransferable(java.lang.String name, java.lang.String className, java.lang.Integer priority, java.lang.Integer inputPriority, boolean isdefault, boolean copyAsTransferable) Deprecated. use addTransferable(String, String, Integer, Integer, boolean, boolean, boolean) instead.
static void	addTransferable(java.lang.String name, java.lang.String className, java.lang.Integer priority, java.lang.Integer inputPriority, boolean isdefault, boolean copyAsTransferable, boolean dndTransferable) Add a TransferableDescriptor to the registry, and constructing it by the given parameters.
static void	addTransferable(TransferableDescriptor d) Add a TransferableDescriptor to the MTransferable Registry.
static void	clearClipboard() Clears the clipboard by creating an empty Transferable and placing it on the clipboard.
static java.awt.datatransfer.Clipboard	getClipboard() Returns the default Toolkit's system clipboard if available, otherwise returns a new singleton clipboard instance.
static java.lang.Runnable	getClipboardClearerTask() Deprecated. see setWorkOnBackground(boolean)
static java.util.List<java.lang.String>	getCopyAsTransferableNames() Returns the format's names that are available in the current environment as transfer types for the Copy As dialog.
static java.util.List<java.lang.String>	getCopyAsTransferFormatIds() Deprecated. changed the method name to getCopyAsTransferableNames()
static java.lang.Object	getDataFromClipboardOLE() Deprecated. this method will not be available after 5.4
static java.lang.String	getDefaultTransferFormatId() Deprecated. since 5.3.3
static java.lang.Runnable	getImageToClipboardTask(java.awt.Image img) Deprecated. see setWorkOnBackground(boolean)
static java.util.logging.Logger	getLog() Returns the Logger of the Clipboard handler subsystem.
static java.lang.Runnable	getMoleculeToClipboardTask(Molecule mol, java.util.Properties props, java.lang.String formatId) Deprecated. see setWorkOnBackground(boolean)
static java.lang.Object	getObjectFromClipboard() Returns the current content of the clipboard if the data can be imported in any of data formats supported by MolImporter.
static java.lang.Object	getObjectFromTransferable(java.awt.datatransfer.Transferable transfer) Returns the content of Transferable if the data can be imported in any of data formats supported by MolImporter.
static java.lang.Runnable	getOLEToClipboardTask(Molecule mol, java.util.Properties props) Deprecated. see setWorkOnBackground(boolean)
static java.lang.String	getStringFromClipboard() Returns the String data from the clipboard contents, if the clipboard contains a Transferable that provides support to DataFlavor.stringFlavor
static java.lang.Runnable	getStringToClipboardTask(java.lang.String str) Deprecated. see setWorkOnBackground(boolean)
static java.awt.datatransfer.Transferable	getTransferableFor(Molecule mol, java.util.Properties props) Creates a MTransferable object to the given Molecule with the given properties.
static java.awt.datatransfer.Transferable	getTransferableFor(Molecule mol, java.util.Properties props, java.lang.String fmt) Creates a MTransferable to the given Molecule with the given properties in the given format.
static boolean	getWorkOnBackGround() Returns whether the subsystem works on the current thread or on a background thread.
static boolean	isClearClipboardBeforeExport() Returns whether the subsystem clears the clipboard before a copy operation.
static boolean	isSupportedTransferFormat(java.lang.String fmtId) Checks whether the given format is available in the current environment or not.
static void	putImageToClipboard(java.awt.Image img) Places the given Image to the clipboard.
static void	putMoleculeToClipboard(Molecule mol, java.util.Properties props) Places a Molecule object to the clipboard which is represented as a Transferable being configured to support all the default Transfer types of Marvin.
static void	putMoleculeToClipboard(Molecule mol, java.util.Properties props, java.lang.String fmt) Places a Molecule object to the clipboard which is represented as a Transferable configured to support the transfer types of the specified format identifier.
static void	putOLEToClipboard(Molecule mol, java.util.Properties props) Deprecated. use simply putMoleculeToClipboard(Molecule, Properties)
static void	putStringToClipboard(java.lang.String str) Places the given String to the clipboard as a StringSelection.
static void	releasePermanentResources() Releases all clipboard related native libraries and resources.
static void	removeOLESupport() Removing the support of OLE transfer format.
static TransferableDescriptor	removeTransferable(java.lang.String name) Removes a TransferableDescriptor to the MTransferable Registry by name.
static TransferableDescriptor	removeTransferable(TransferableDescriptor d) Removes a TransferableDescriptor to the MTransferable Registry.
static void	setClearClipboardBeforeExport(boolean b) Sets whether the subsystem should clear the clipboard before a copy operation.
static void	setWorkOnBackground(boolean b) Starts or stops the background worker thread and ensures the required state for the type of work.
static void	startPermanentResources() Starts all the permanent native resources that have to be started to do fast and reliable copy in Marvin.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String DEFAULT_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

The name of the transferable for default copy operation.

See Also:

Constant Field Values

OLE_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String OLE_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

OLE Transfer name and identifier.

See Also:

Constant Field Values

EMF_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String EMF_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

EMF Transfer name and identifier.

See Also:

Constant Field Values

JPG_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String JPG_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

JPG Transfer name and identifier.

See Also:

Constant Field Values

PNG_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String PNG_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

PNG Transfer name and identifier.

See Also:

Constant Field Values

MRV_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String MRV_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

MRV Transfer name and identifier.

See Also:

Constant Field Values

IUPAC_NAME_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String IUPAC_NAME_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

Name Transfer name and identifier.

See Also:

Constant Field Values

IUPAC_INCHI_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String IUPAC_INCHI_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

IUPAC InChI Transfer name and identifier.

See Also:

Constant Field Values

IUPAC_INCHIKEY_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String IUPAC_INCHIKEY_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

IUPAC InChIKey Transfer name and identifier.

See Also:

Constant Field Values

CDX_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String CDX_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

CDX Transfer name and identifier.

See Also:

Constant Field Values

SKC_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String SKC_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

SKC Transfer name and identifier.

See Also:

Constant Field Values

MDL_MOL_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String MDL_MOL_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

MDL molfile Transfer name and identifier.

See Also:

Constant Field Values

MDL_RXN_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String MDL_RXN_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

MDL rxnfile Transfer name and identifier.

See Also:

Constant Field Values

SMILES_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String SMILES_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

Smiles Transfer name and identifier.

See Also:

Constant Field Values

CXSMILES_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String CXSMILES_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

Chemaxon Extended Smiles Transfer name and identifier.

See Also:

Constant Field Values

STRING_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String STRING_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

Molecule source Transfer name and identifier.

See Also:

Constant Field Values

BMP_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String BMP_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

BMP Transfer name and identifier.

See Also:

Constant Field Values

PDF_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String PDF_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

PDF Transfer name and identifier.

See Also:

Constant Field Values

PS_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String PS_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

PS Transfer name and identifier.

See Also:

Constant Field Values

TIFF_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String TIFF_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

JPG Transfer name and identifier.

See Also:

Constant Field Values

GIF_TRANSFERABLE_NAME

@Deprecated
public static final java.lang.String GIF_TRANSFERABLE_NAME

Deprecated. will be deleted in 5.4

GIF Transfer name and identifier.

See Also:

Constant Field Values

Method Detail

getLog

public static java.util.logging.Logger getLog()

Returns the Logger of the Clipboard handler subsystem. By default the Logger won't create log.

Returns:

the Logger.

setWorkOnBackground

public static void setWorkOnBackground(boolean b)

Starts or stops the background worker thread and ensures the required state for the type of work. If it previously worked in the background then waits for the previously submitted tasks to finish.
It defaults to false.

Parameters:

b - true means working in the background, false means working on the current thread.

getWorkOnBackGround

public static boolean getWorkOnBackGround()

Returns whether the subsystem works on the current thread or on a background thread.

Returns:

true if it works on the current thread false otherwise.

setClearClipboardBeforeExport

public static void setClearClipboardBeforeExport(boolean b)

Sets whether the subsystem should clear the clipboard before a copy operation. The default value is true.

Parameters:

b - true or false

isClearClipboardBeforeExport

public static boolean isClearClipboardBeforeExport()

Returns whether the subsystem clears the clipboard before a copy operation.

Returns:

true if the clipboard is cleared before a copy operation false otherwise.

putStringToClipboard

public static void putStringToClipboard(java.lang.String str)

Places the given String to the clipboard as a StringSelection. When processing on a background thread, this method will continuously try to put the String to the clipboard until the operation has succeeded.

Parameters:

str - the String to be placed to the clipboard

Throws:

java.lang.IllegalStateException - if the clipboard is currently unavailable, and running on the current thread.

putImageToClipboard

public static void putImageToClipboard(java.awt.Image img)

Places the given Image to the clipboard. When processing on a background thread, this method will continuously try to put the String to the clipboard until the operation has succeeded.

Parameters:

img - the Image to be placed to the clipboard

Throws:

java.lang.IllegalStateException - if the clipboard is currently unavailable, and running on the current thread.

putMoleculeToClipboard

public static void putMoleculeToClipboard(Molecule mol,
                                          java.util.Properties props)

Places a Molecule object to the clipboard which is represented as a Transferable being configured to support all the default Transfer types of Marvin. When processing on a background thread, this method will continuously try to put the String to the clipboard until the operation has succeeded.

Parameters:

mol - the Molecule to be placed to the clipboard

props - display properties of the Molecule, this parameter will be used when transferring Molecule images to clipboard, and can be one of, or the union of properties stored in UserSettings, and in the result of MDocument.getGUIPropertyContainer()

Throws:

java.lang.IllegalStateException - if the clipboard is currently unavailable, and running on the current thread.

See Also:

ImageExportUtil

putMoleculeToClipboard

public static void putMoleculeToClipboard(Molecule mol,
                                          java.util.Properties props,
                                          java.lang.String fmt)

Places a Molecule object to the clipboard which is represented as a Transferable configured to support the transfer types of the specified format identifier. When processing on a background thread, this method will continuously try to put the String to the clipboard until the operation has succeeded.

Parameters:

mol - the Molecule to be placed to the clipboard

props - display properties of the Molecule, this parameter is useful when transferring Molecule images to clipboard, and can be one of, or the union of properties stored in UserSettings, and in the result of MDocument.getGUIPropertyContainer()

fmt - format identifier in which the data will be represented on the clipboard. It can be null in which case the Molecule will be transferred in the default formats.

Throws:

java.lang.IllegalStateException - if the clipboard is currently unavailable, and running on the current thread.

See Also:

ImageExportUtil

removeOLESupport

public static void removeOLESupport()

Removing the support of OLE transfer format.

getStringFromClipboard

public static java.lang.String getStringFromClipboard()

Returns the String data from the clipboard contents, if the clipboard contains a Transferable that provides support to DataFlavor.stringFlavor

Returns:

the String from the clipboard.

getObjectFromClipboard

public static java.lang.Object getObjectFromClipboard()

Returns the current content of the clipboard if the data can be imported in any of data formats supported by MolImporter. If the clipboard represents a Molecule, the returned object will be an instance of Molecule, if the clipboard represents a MacroMolecule used by MarvinSpace, then the returned object will be an instance of MacroMolecule, otherwise the function returns null.

Returns:

the molecule represented on the clipboard, null if molecule representation cannot be found

getObjectFromTransferable

public static java.lang.Object getObjectFromTransferable(java.awt.datatransfer.Transferable transfer)

Returns the content of Transferable if the data can be imported in any of data formats supported by MolImporter. If the clipboard represents a Molecule, the returned object will be an instanceof Molecule, if the clipboard represents a MacroMolecule used by MarvinSpace, then the returned object will be an instanceof MacroMolecule, otherwise the function returns null.

Parameters:

transfer - the Transferable which represents the data

Returns:

the molecule represented in the Transferable, null if molecule representation cannot be found

getTransferableFor

public static java.awt.datatransfer.Transferable getTransferableFor(Molecule mol,
                                                                    java.util.Properties props)

Creates a MTransferable object to the given Molecule with the given properties.

Parameters:

mol - the Molecule which has to be represented by the Transferable

props - display properties of the Molecule, this parameter will be used when transferring Molecule images to clipboard, and can be one of, or the union of properties stored in UserSettings, and in the result of MDocument.getGUIPropertyContainer()

Returns:

the Transferable created from the given data.

See Also:

ImageExportUtil

getTransferableFor

public static java.awt.datatransfer.Transferable getTransferableFor(Molecule mol,
                                                                    java.util.Properties props,
                                                                    java.lang.String fmt)

Creates a MTransferable to the given Molecule with the given properties in the given format.

Parameters:

mol - the Molecule which has to be represented by the Transferable

props - display properties of the Molecule, this parameter will be used when transferring Molecule images to clipboard, and can be one of, or the union of properties stored in UserSettings, and in the result of MDocument.getGUIPropertyContainer()

fmt - format identifier in which the data will be represented on the clipboard. It can be null in which case the Molecule will be transferred in the default formats. If null is given, the default will be used.

Returns:

the Transferable created from the given data.

See Also:

ImageExportUtil

isSupportedTransferFormat

public static boolean isSupportedTransferFormat(java.lang.String fmtId)

Checks whether the given format is available in the current environment or not.

Parameters:

fmtId - the format identifier

Returns:

true if the format is available

getCopyAsTransferableNames

public static java.util.List<java.lang.String> getCopyAsTransferableNames()

Returns the format's names that are available in the current environment as transfer types for the Copy As dialog.

Returns:

List list of the the copy as dialog format's names

clearClipboard

public static void clearClipboard()

Clears the clipboard by creating an empty Transferable and placing it on the clipboard.

getClipboard

public static java.awt.datatransfer.Clipboard getClipboard()

Returns the default Toolkit's system clipboard if available, otherwise returns a new singleton clipboard instance.

Returns:

the system clipboard or a local clipboard instance.

See Also:

Toolkit.getSystemClipboard()

removeTransferable

public static TransferableDescriptor removeTransferable(TransferableDescriptor d)

Removes a TransferableDescriptor to the MTransferable Registry.

Parameters:

d - the descriptor.

Returns:

the descriptor which has been removed.

removeTransferable

public static TransferableDescriptor removeTransferable(java.lang.String name)

Removes a TransferableDescriptor to the MTransferable Registry by name.

Parameters:

name - the name of the MTransferable

Returns:

the descriptor which has been removed.

addTransferable

public static void addTransferable(TransferableDescriptor d)

Add a TransferableDescriptor to the MTransferable Registry.

Parameters:

d - the descriptor.

addTransferable

@Deprecated
public static void addTransferable(java.lang.String name,
                                              java.lang.String className,
                                              java.lang.Integer priority,
                                              java.lang.Integer inputPriority,
                                              boolean isdefault,
                                              boolean copyAsTransferable)

Deprecated. use addTransferable(String, String, Integer, Integer, boolean, boolean, boolean) instead.

Add a TransferableDescriptor to the registry, and constructing it by the given parameters.

addTransferable

public static void addTransferable(java.lang.String name,
                                   java.lang.String className,
                                   java.lang.Integer priority,
                                   java.lang.Integer inputPriority,
                                   boolean isdefault,
                                   boolean copyAsTransferable,
                                   boolean dndTransferable)

Add a TransferableDescriptor to the registry, and constructing it by the given parameters.

Parameters:

name - of the MTransferable represented by the descriptor.

className - The representing class name of the MTransferable represented by the descriptor.

priority - priority on the Copy as dialog of the MTransferable represented by the descriptor.

inputPriority - priority used when importing with the help of the MTransferable represented by the descriptor.

isdefault - decides whether the MTransferable should be used in default copy.

copyAsTransferable - decides whether the MTrasnferable should be displayed in the copy as dialog.

dndTransferable - flag to indicate whether the transferable is used when importing data from a dropped object

releasePermanentResources

public static void releasePermanentResources()

Releases all clipboard related native libraries and resources. Waits background workers to finish before releasing.

startPermanentResources

public static void startPermanentResources()

Starts all the permanent native resources that have to be started to do fast and reliable copy in Marvin.

getCopyAsTransferFormatIds

@Deprecated
public static java.util.List<java.lang.String> getCopyAsTransferFormatIds()

Deprecated. changed the method name to getCopyAsTransferableNames()

Returns the format identifiers that are available in the current environment as transfer types for the Copy As dialog.

Returns:

List list of the the copy as dialog format's identifiers

getDefaultTransferFormatId

@Deprecated
public static java.lang.String getDefaultTransferFormatId()

Deprecated. since 5.3.3

The method is not used anymore

Returns:

empty string

getMoleculeToClipboardTask

@Deprecated
public static java.lang.Runnable getMoleculeToClipboardTask(Molecule mol,
                                                                       java.util.Properties props,
                                                                       java.lang.String formatId)

Deprecated. see setWorkOnBackground(boolean)

Parameters:

mol -

props -

formatId -

Returns:

a runnable

getOLEToClipboardTask

@Deprecated
public static java.lang.Runnable getOLEToClipboardTask(Molecule mol,
                                                                  java.util.Properties props)

Deprecated. see setWorkOnBackground(boolean)

Parameters:

mol -

props -

Returns:

a runnable

getStringToClipboardTask

@Deprecated
public static java.lang.Runnable getStringToClipboardTask(java.lang.String str)

Deprecated. see setWorkOnBackground(boolean)

Parameters:

str -

Returns:

a runnable

Throws:

java.lang.IllegalStateException

getImageToClipboardTask

@Deprecated
public static java.lang.Runnable getImageToClipboardTask(java.awt.Image img)

Deprecated. see setWorkOnBackground(boolean)

Parameters:

img -

Returns:

a runnable

getClipboardClearerTask

@Deprecated
public static java.lang.Runnable getClipboardClearerTask()

Deprecated. see setWorkOnBackground(boolean)

Returns:

a runnable

putOLEToClipboard

@Deprecated
public static void putOLEToClipboard(Molecule mol,
                                                java.util.Properties props)

Deprecated. use simply putMoleculeToClipboard(Molecule, Properties)

Parameters:

mol -

props -

getDataFromClipboardOLE

@Deprecated
public static java.lang.Object getDataFromClipboardOLE()

Deprecated. this method will not be available after 5.4

Returns:

the object