Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> eclipse >> swt >> [ dnd overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

org.eclipse.swt.dnd
Class Clipboard  

java.lang.Object
  org.eclipse.swt.dnd.Clipboard

---

public class Clipboard

extends java.lang.Object

The Clipboard provides a mechanism for transferring data from one application to another or within an application.

IMPORTANT: This class is not intended to be subclassed.

---

Field Summary
private  org.eclipse.swt.widgets.Display	display
(package private) static long	GTKCLIPBOARD
(package private) static long	GTKPRIMARYCLIPBOARD
private static long	TARGET

 

Constructor Summary

Clipboard(org.eclipse.swt.widgets.Display display)           Constructs a new instance of this class.

 

Method Summary
private  int[]	_getAvailableTypes()
protected  void	checkSubclass()           Checks that this class can be subclassed.
protected  void	checkWidget()           Throws an SWTException if the receiver can not be accessed by the caller.
void	dispose()           Disposes of the operating system resources associated with the clipboard.
java.lang.String[]	getAvailableTypeNames()           Returns a platform specific list of the data types currently available on the system clipboard.
TransferData[]	getAvailableTypes()           Returns an array of the data types currently available on the system clipboard.
java.lang.Object	getContents(Transfer transfer)           Retrieve the data of the specified type currently available on the system clipboard.
(package private)  long	gtk_clipboard_wait_for_contents(long clipboard, long target)
boolean	isDisposed()           Returns true if the clipboard has been disposed, and false otherwise.
void	setContents(java.lang.Object[] data, Transfer[] dataTypes)           Place data of the specified type on the system clipboard.

 

Methods inherited from class java.lang.Object

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

 

Field Detail

display

private org.eclipse.swt.widgets.Display display

---

GTKCLIPBOARD

static long GTKCLIPBOARD

---

GTKPRIMARYCLIPBOARD

static long GTKPRIMARYCLIPBOARD

---

TARGET

private static long TARGET

Constructor Detail

Clipboard

public Clipboard(org.eclipse.swt.widgets.Display display)

Constructs a new instance of this class. Creating an instance of a Clipboard may cause system resources to be allocated depending on the platform. It is therefore mandatory that the Clipboard instance be disposed when no longer required.

Method Detail

checkSubclass

protected void checkSubclass()

Checks that this class can be subclassed.

The SWT class library is intended to be subclassed only at specific, controlled points. This method enforces this rule unless it is overridden.

IMPORTANT: By providing an implementation of this method that allows a subclass of a class which does not normally allow subclassing to be created, the implementer agrees to be fully responsible for the fact that any such subclass will likely fail between SWT releases and will be strongly platform specific. No support is provided for user-written classes which are implemented in this fashion.

The ability to subclass outside of the allowed SWT classes is intended purely to enable those not on the SWT development team to implement patches in order to get around specific limitations in advance of when those limitations can be addressed by the team. Subclassing should not be attempted without an intimate and detailed understanding of the hierarchy.

---

checkWidget

protected void checkWidget()

Throws an SWTException if the receiver can not be accessed by the caller. This may include both checks on the state of the receiver and more generally on the entire execution context. This method should be called by widget implementors to enforce the standard SWT invariants.

Currently, it is an error to invoke any method (other than isDisposed()) on a widget that has had its dispose() method called. It is also an error to call widget methods from any thread that is different from the thread that created the widget.

In future releases of SWT, there may be more or fewer error checks and exceptions may be thrown for different reasons.

---

dispose

public void dispose()

Disposes of the operating system resources associated with the clipboard. The data will still be available on the system clipboard after the dispose method is called.

NOTE: On some platforms the data will not be available once the application has exited or the display has been disposed.

---

getContents

public java.lang.Object getContents(Transfer transfer)

Retrieve the data of the specified type currently available on the system clipboard. Refer to the specific subclass of Tramsfer to determine the type of object returned.

The following snippet shows text and RTF text being retrieved from the clipboard:

    Clipboard clipboard = new Clipboard(display);
    TextTransfer textTransfer = TextTransfer.getInstance();
    String textData = (String)clipboard.getContents(textTransfer);
    if (textData != null) System.out.println("Text is "+textData);
    RTFTransfer rtfTransfer = RTFTransfer.getInstance();
    String rtfData = (String)clipboard.getContents(rtfTransfer);
    if (rtfData != null) System.out.println("RTF Text is "+rtfData);
    clipboard.dispose();
    

---

isDisposed

public boolean isDisposed()

Returns true if the clipboard has been disposed, and false otherwise.

This method gets the dispose state for the clipboard. When a clipboard has been disposed, it is an error to invoke any other method using the clipboard.

Since:

3.0

---

setContents

public void setContents(java.lang.Object[] data,
                        Transfer[] dataTypes)

Place data of the specified type on the system clipboard. More than one type of data can be placed on the system clipboard at the same time. Setting the data clears any previous data of the same type from the system clipboard and also clears data of any other type currently on the system clipboard.

NOTE: On some platforms, the data is immediately copied to the system clipboard but on other platforms it is provided upon request. As a result, if the application modifes the data object it has set on the clipboard, that modification may or may not be available when the data is subsequently requested.

The following snippet shows text and RTF text being set on the clipboard:

 	Clipboard clipboard = new Clipboard(display);
		String textData = "Hello World";
		String rtfData = "{\\rtf1\\b\\i Hello World}";
		TextTransfer textTransfer = TextTransfer.getInstance();
		RTFTransfer rtfTransfer = RTFTransfer.getInstance();
		clipboard.setContents(new Object[]{textData, rtfData}, new Transfer[]{textTransfer, rtfTransfer});
		clipboard.dispose();
 

---

getAvailableTypes

public TransferData[] getAvailableTypes()

Returns an array of the data types currently available on the system clipboard. Use with Transfer.isSupportedType.

Since:

3.0

---

getAvailableTypeNames

public java.lang.String[] getAvailableTypeNames()

Returns a platform specific list of the data types currently available on the system clipboard.

Note: getAvailableTypeNames is a utility for writing a Transfer sub-class. It should NOT be used within an application because it provides platform specific information.

---

_getAvailableTypes

private int[] _getAvailableTypes()

---

gtk_clipboard_wait_for_contents

long gtk_clipboard_wait_for_contents(long clipboard,
                                     long target)

---

Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> eclipse >> swt >> [ dnd overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---