ExClipboard (NetBeans Utilities API) - NetBeans API Javadoc 5.0.0

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.openide.util.datatransfer
Class ExClipboard

java.lang.Object
  java.awt.datatransfer.Clipboard
      org.openide.util.datatransfer.ExClipboard

public abstract class ExClipboard
extends Clipboard

Extended clipboard that supports listeners that can be notified about changes of content. Also contains support for attaching content convertors.

Nested Class Summary

static interface ExClipboard.Convertor
          Convertor that can convert the contents of a clipboard to additional flavors.

Field Summary

Fields inherited from class java.awt.datatransfer.Clipboard

contents, owner

Constructor Summary

ExClipboard(String name)
          Make a new clipboard.

Method Summary

void addClipboardListener(ClipboardListener list)
          Add a listener to clipboard operations.

Transferable convert(Transferable t)
          Method that takes a transferable, applies all convertors, and creates a new transferable using the abilities of the convertors.

protected void fireClipboardChange()
          Fires event about change of content in the clipboard.

protected abstract ExClipboard.Convertor[] getConvertors()
          Obtain a list of convertors assigned to this clipboard.

void removeClipboardListener(ClipboardListener list)
          Remove a listener to clipboard operations.

void setContents(Transferable contents, ClipboardOwner owner)


static void transferableAccepted(Transferable t, int action)
          Notifies the transferable that it has been accepted by a drop.

static void transferableOwnershipLost(Transferable t)
          Notifies the transferable that it has lost ownership in clipboard.

static void transferableRejected(Transferable t)
          Notifies the transferable that it has been rejected by a drop.

Methods inherited from class java.awt.datatransfer.Clipboard

getContents, getName

Methods inherited from class java.lang.Object

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

Constructor Detail

ExClipboard

public ExClipboard(String name)

Make a new clipboard.
Parameters:: name - name of the clipboard

Method Detail

addClipboardListener

public final void addClipboardListener(ClipboardListener list)

Add a listener to clipboard operations.

Parameters:: list - the listener

removeClipboardListener

public final void removeClipboardListener(ClipboardListener list)

Remove a listener to clipboard operations.

Parameters:: list - the listener

fireClipboardChange

protected final void fireClipboardChange()

Fires event about change of content in the clipboard.

getConvertors

protected abstract ExClipboard.Convertor[] getConvertors()

Obtain a list of convertors assigned to this clipboard.

Returns:: the convertors

convert

public Transferable convert(Transferable t)

Method that takes a transferable, applies all convertors, and creates a new transferable using the abilities of the convertors.

This method is used when the contents of the clipboard are changed and also can be used by Drag & Drop to process transferables between source and target.

Note that it is possible for the results to vary according to order of the convertors as specified by getConvertors(). For example, the input transferable may contain flavor A, and there may be a convertor from A to B, and one from B to C; flavor B will always be available, but flavor C will only be available if the convertor list is in the order that these were mentioned. Since the standard clipboard implementation searches for convertors in lookup as well as manifests, ordering might be specified between a set of layer-supplied convertors by means of folder ordering attributes.

Parameters:: t - input transferable
Returns:: new transferable

transferableAccepted

public static void transferableAccepted(Transferable t,
                                        int action)

Notifies the transferable that it has been accepted by a drop. Works only for ExTransferable, other types of transferables are not notified.

Parameters:: t - transferable to notify its listeners; action - which action has been performed

transferableRejected

public static void transferableRejected(Transferable t)

Notifies the transferable that it has been rejected by a drop. Works only for ExTransferable, other types of transferables are not notified.

Parameters:: t - transferable to notify its listeners

setContents

public void setContents(Transferable contents,
                        ClipboardOwner owner)

transferableOwnershipLost

public static void transferableOwnershipLost(Transferable t)

Notifies the transferable that it has lost ownership in clipboard. Works only for ExTransferable, other types of transferables are not notified.

Parameters:: t - transferable to notify its listeners