org.gnu.gtk

Class Clipboard

public class Clipboard extends GObject

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()
Clear the contents of the clipboard.

get

public static Clipboard get(Atom atom)
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)
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()
Gets the Display associated with clipboard.

Returns: the Display associated with clipboard

getForDisplay

public static Clipboard getForDisplay(Display display, Atom atom)

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()
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)
Set the contents of the clipboard.

store

public void store()