org.gnu.gtk

Class Clipboard

public class Clipboard extends GObject

Deprecated: This class is part of the java-gnome 2.x family of libraries, which, due to their inefficiency and complexity, are no longer being maintained and have been abandoned by the java-gnome project. This class may in the future have an equivalent in java-gnome 4.0, try looking for org.gnome.gtk.Clipboard. You should be aware that there is a considerably different API in the new library: the architecture is completely different and most notably internals are no longer exposed to public view.

The Clipboard object represents a clipboard of data shared between different processes or between different widgets in the same process.

TODO: This requires gdk.Selections

TODO: callback functions

Method Summary
voidclear()
Clear the contents of the clipboard.
static Clipboardget(Atom atom)
Returns the clipboard object for the given selection.
SelectionDatagetContents(Atom atom)
Requests the contents of the clipboard as SelectionData
DisplaygetDisplay()
Gets the Display associated with clipboard.
static ClipboardgetForDisplay(Display display, Atom atom)
PixbufgetImage()
StringgetText()
Requests the contents of the clipboard as text.
booleanisImageAvailable()
booleanisTextAvailable()
voidsetCanStore(TargetEntry[] targets)
voidsetImage(Pixbuf pixbuf)
voidsetText(String text)
Set the contents of the clipboard.
voidstore()

Method Detail

clear

public void clear()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Clear the contents of the clipboard.

get

public static Clipboard get(Atom atom)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Returns the clipboard object for the given selection. See Clipboard for complete details.

Parameters: atom a Atom which identifies the clipboard to use

Returns: the appropriate clipboard object. If no clipboard already exists, a new one will be created. Once a clipboard object has been created, it is persistent for all time and cannot be freed.

getContents

public SelectionData getContents(Atom atom)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Requests the contents of the clipboard as SelectionData

Parameters: atom an Atom representing the form into which the clipboard owner should convert the selection

Returns: a newly-allocated SelectionData object or NULL if retrieving the given target failed TODO: write the JNI

getDisplay

public Display getDisplay()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Gets the Display associated with clipboard.

Returns: the Display associated with clipboard

getForDisplay

public static Clipboard getForDisplay(Display display, Atom atom)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Parameters: display the display for which the clipboard is to be retrieved or created atom a Atom which identifies the clipboard to use

Returns: he appropriate clipboard object. If no clipboard already exists, a new one will be created. Once a clipboard object has been created, it is persistent for all time and cannot be freed.

getImage

public Pixbuf getImage()

getText

public String getText()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Requests the contents of the clipboard as text.

isImageAvailable

public boolean isImageAvailable()

isTextAvailable

public boolean isTextAvailable()

setCanStore

public void setCanStore(TargetEntry[] targets)

setImage

public void setImage(Pixbuf pixbuf)

setText

public void setText(String text)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Set the contents of the clipboard.

store

public void store()