Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Clipboard extends Object
FlavorListener
s может быть зарегистрирован на экземпляре Буфера обмена class, который будет уведомлен об изменениях набору DataFlavor
s доступный на этом буфере обмена (см. addFlavorListener(java.awt.datatransfer.FlavorListener)
).
Модификатор и Тип | Поле и Описание |
---|---|
protected Transferable |
содержание |
protected ClipboardOwner |
владелец |
Конструктор и Описание |
---|
Clipboard(String name)
Создает объект буфера обмена.
|
Модификатор и Тип | Метод и Описание |
---|---|
void |
addFlavorListener(FlavorListener listener)
Регистрирует указанное
FlavorListener получить FlavorEvent s от этого буфера обмена. |
DataFlavor[] |
getAvailableDataFlavors()
Возвращает массив
DataFlavor s, в котором может быть обеспечено текущее содержание этого буфера обмена. |
Передаваемый |
getContents(Object requestor)
Возвращает передаваемый объект, представляющий текущее содержание буфера обмена.
|
Объект |
getData(DataFlavor flavor)
Возвращает объект, представляющий текущее содержание этого буфера обмена в указанном
DataFlavor . |
FlavorListener[] |
getFlavorListeners()
Возвращает массив весь
FlavorListener s в настоящий момент зарегистрированный на этом Clipboard . |
Строка |
getName()
Возвращает имя этого объекта буфера обмена.
|
boolean |
isDataFlavorAvailable(DataFlavor flavor)
Возвраты, может ли текущее содержание этого буфера обмена быть обеспечено в указанном
DataFlavor . |
void |
removeFlavorListener(FlavorListener listener)
Удаляет указанное
FlavorListener так, чтобы это больше не получило FlavorEvent s от этого Clipboard . |
void |
setContents(Transferable contents, ClipboardOwner owner)
Устанавливает текущее содержание буфера обмена к указанному передаваемому объекту и регистрирует указанного владельца буфера обмена как владельца нового содержания.
|
protected ClipboardOwner owner
protected Transferable contents
public Clipboard(String name)
Toolkit.getSystemClipboard()
public String getName()
Toolkit.getSystemClipboard()
public void setContents(Transferable contents, ClipboardOwner owner)
Если есть существующий владелец, отличающийся от параметра owner
, тот владелец уведомляется, что это больше не содержит владение содержания буфера обмена через вызов ClipboardOwner.lostOwnership()
на том владельце. Реализация setContents()
свободно не вызвать lostOwnership()
непосредственно от этого метода. Например, lostOwnership()
может быть вызван позже различный поток. То же самое применяется к FlavorListener
s зарегистрированный на этом буфере обмена.
Броски метода IllegalStateException
если буфер обмена в настоящий момент недоступен. Например, на некоторых платформах, системный буфер обмена недоступен, в то время как к нему получает доступ другое приложение.
contents
- передаваемый объект, представляющий контент буфера обменаowner
- объект, которому принадлежит контент буфера обменаIllegalStateException
- если буфер обмена в настоящий момент недоступенToolkit.getSystemClipboard()
public Transferable getContents(Object requestor)
null
. Проситель Объекта параметра в настоящий момент не используется. Броски метода IllegalStateException
если буфер обмена в настоящий момент недоступен. Например, на некоторых платформах, системный буфер обмена недоступен, в то время как к нему получает доступ другое приложение.requestor
- объект, запрашивающий данные клипа (не используемый)IllegalStateException
- если буфер обмена в настоящий момент недоступенToolkit.getSystemClipboard()
public DataFlavor[] getAvailableDataFlavors()
DataFlavor
s, в котором может быть обеспечено текущее содержание этого буфера обмена. Если есть нет DataFlavor
s доступный, этот метод возвращает массив нулевой длиной.DataFlavor
s, в котором может быть обеспечено текущее содержание этого буфера обменаIllegalStateException
- если этот буфер обмена в настоящий момент недоступенpublic boolean isDataFlavorAvailable(DataFlavor flavor)
DataFlavor
.flavor
- требуемый DataFlavor
для содержанияtrue
если текущее содержание этого буфера обмена может быть обеспечено в указанном DataFlavor
; false
иначеNullPointerException
- если flavor
null
IllegalStateException
- если этот буфер обмена в настоящий момент недоступенpublic Object getData(DataFlavor flavor) throws UnsupportedFlavorException, IOException
DataFlavor
. class возвращенного объекта определяется представлением class flavor
.flavor
- требуемый DataFlavor
для содержанияDataFlavor
NullPointerException
- если flavor
null
IllegalStateException
- если этот буфер обмена в настоящий момент недоступенUnsupportedFlavorException
- если требуемый DataFlavor
не доступноIOException
- если данные в требуемом DataFlavor
не может быть полученDataFlavor.getRepresentationClass()
public void addFlavorListener(FlavorListener listener)
FlavorListener
получить FlavorEvent
s от этого буфера обмена. Если listener
null
, никакое исключение не выдается, и никакое действие не выполняется.listener
- слушатель, который будет добавленremoveFlavorListener(java.awt.datatransfer.FlavorListener)
, getFlavorListeners()
, FlavorListener
, FlavorEvent
public void removeFlavorListener(FlavorListener listener)
FlavorListener
так, чтобы это больше не получило FlavorEvent
s от этого Clipboard
. Этот метод не выполняет функции, и при этом он не выдает исключение, если слушатель, определенный параметром, не был ранее добавлен к этому Clipboard
. Если listener
null
, никакое исключение не выдается, и никакое действие не выполняется.listener
- слушатель, который будет удаленaddFlavorListener(java.awt.datatransfer.FlavorListener)
, getFlavorListeners()
, FlavorListener
, FlavorEvent
public FlavorListener[] getFlavorListeners()
FlavorListener
s в настоящий момент зарегистрированный на этом Clipboard
.FlavorListener
s или пустой массив, если никакие слушатели в настоящий момент не регистрируютсяaddFlavorListener(java.awt.datatransfer.FlavorListener)
, removeFlavorListener(java.awt.datatransfer.FlavorListener)
, FlavorListener
, FlavorEvent
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92