Clipboard

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

<p>IMPORTANT: This class is <em>not</em> intended to be subclassed.</p>

@see <a href="http://www.eclipse.org/swt/snippets/#clipboard">Clipboard snippets</a> @see <a href="http://www.eclipse.org/swt/examples.php">SWT Example: ClipboardExample</a> @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>

Constructors

this
this(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.

Members

Functions

checkSubclass
void checkSubclass()

Checks that this class can be subclassed. <p> The SWT class library is intended to be subclassed only at specific, controlled points. This method enforces this rule unless it is overridden. </p><p> <em>IMPORTANT:</em> 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. </p><p> 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. </p>

checkWidget
void checkWidget()

Throws an <code>SWTException</code> 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 <em>should</em> be called by widget implementors to enforce the standard SWT invariants. <p> Currently, it is an error to invoke any method (other than <code>isDisposed()</code>) on a widget that has had its <code>dispose()</code> method called. It is also an error to call widget methods from any thread that is different from the thread that created the widget. </p><p> In future releases of SWT, there may be more or fewer error checks and exceptions may be thrown for different reasons. </p>

clearContents
void clearContents()

If this clipboard is currently the owner of the data on the system clipboard, clear the contents. If this clipboard is not the owner, then nothing is done. Note that there are clipboard assistant applications that take ownership of data or make copies of data when it is placed on the clipboard. In these cases, it may not be possible to clear the clipboard.

clearContents
void clearContents(int clipboards)

If this clipboard is currently the owner of the data on the specified clipboard, clear the contents. If this clipboard is not the owner, then nothing is done.

dispose
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.

getAvailableTypeNames
String[] getAvailableTypeNames()

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

getAvailableTypes
TransferData[] getAvailableTypes()

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

getAvailableTypes
TransferData[] getAvailableTypes(int clipboards)

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

getContents
Object getContents(Transfer transfer)

Retrieve the data of the specified type currently available on the system clipboard. Refer to the specific subclass of <code>Transfer</code> to determine the type of object returned.

getContents
Object getContents(Transfer transfer, int clipboards)

Retrieve the data of the specified type currently available on the specified clipboard. Refer to the specific subclass of <code>Transfer</code> to determine the type of object returned.

isDisposed
bool isDisposed()

Returns <code>true</code> if the clipboard has been disposed, and <code>false</code> otherwise. <p> 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. </p>

setContents
void setContents(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 from the system clipboard, regardless of type.

setContents
void setContents(Object[] data, Transfer[] dataTypes, int clipboards)

Place data of the specified type on the specified clipboard. More than one type of data can be placed on the specified clipboard at the same time. Setting the data clears any previous data from the specified clipboard, regardless of type.

Meta