TransferHandler (Платформа Java SE 7)

java.lang. Объект
- javax.swing. TransferHandler

Все Реализованные Интерфейсы:

Сериализуемый
```
public class TransferHandler
extends Object
implements Serializable
```
Этот класс используется, чтобы обработать передачу a Transferable к и от компонентов Swing. Transferable используется, чтобы представить данные, которые передаются через сокращение, копию, или вставку к/от буферу обмена. Это также используется в операциях перетаскивать-и-отбрасывать, чтобы представить перетаскивание от компонента, и спад до компонента. Swing обеспечивает функциональность, которая автоматически поддерживает сокращение, копию, и привязку клавиатуры вставки, которая использует функциональность, обеспеченную реализацией этого класса. Swing также обеспечивает функциональность, которая автоматически поддерживает, перетаскивают и отбрасывают, который использует функциональность, обеспеченную реализацией этого класса. Разработчик Swing может сконцентрироваться на определении семантики передачи прежде всего, устанавливая transferHandler свойство на компоненте Swing.
Этот класс реализуется, чтобы обеспечить поведение по умолчанию передачи компонентного свойства просто, определяя имя свойства в конструкторе. Например, чтобы передать цвет переднего плана от одного компонента до другого или через буфер обмена или через работу перетаскивания и отбрасывания a TransferHandler может быть создан со строкой "передний план". Созданный в поддержке будет использовать цвет, возвращенный getForeground как источник передачи, и setForeground для цели передачи.
Пожалуйста, см., Как Использовать, Перетаскивают и Отбрасывание и Передача данных, раздел в Учебном руководстве по Java, для получения дополнительной информации.

С тех пор:

1.4

Вложенная Сводка Класса

Вложенные Классы
Модификатор и Тип	Класс и Описание
`static class`	`TransferHandler. DropLocation` Представляет расположение, где отброшенные данные должны быть вставлены.
`static class`	`TransferHandler. TransferSupport` Этот класс инкапсулирует все соответствующие детали буфера обмена, или перетащите и отбросьте передачу, и также учитывает настройку аспектов опыта перетаскивания и отбрасывания.

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static int`	`КОПИЯ` `int` представление "копии" передает действие.
`static int`	`COPY_OR_MOVE` `int` представление исходной возможности действия или "копии" или "перемещения".
`static int`	`ССЫЛКА` `int` представление "ссылки" передает действие.
`static int`	`ПЕРЕМЕСТИТЬСЯ` `int` представление "перемещения" передает действие.
`static int`	`НИ ОДИН` `int` представление никакого действия передачи.

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`TransferHandler()` Конструктор удобства для подклассов.
	`TransferHandler(String property)` Создает обработчик передачи, который может передать свойство Bean Java от одного компонента до другого через буфер обмена или перетаскивание и отбросить работу.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`boolean`	`canImport(JComponent comp, DataFlavor[] transferFlavors)` Указывает, примет ли компонент импорт данного набора разновидностей данных до того, чтобы фактически пытаться импортировать это.
`boolean`	`canImport(TransferHandler.TransferSupport support)` Этот метод неоднократно вызывают во время работы перетаскивания и отбрасывания, чтобы позволить разработчику конфигурировать свойства, и возвращать приемлемость передач; с возвращаемым значением `true` указание, что передача представляется данным `TransferSupport` (который содержит все детали передачи), является приемлемым в текущее время, и значение `false` отклонение передачи.
`protected Transferable`	`createTransferable(JComponent c)` Создает a `Transferable` использовать в качестве источника для передачи данных.
`void`	`exportAsDrag(JComponent comp, InputEvent e, int action)` Причины Swing перетаскивают поддержку, которая будет инициироваться.
`protected void`	`exportDone(JComponent source, Transferable data, int action)` Вызванный после того, как данные были экспортированы.
`void`	`exportToClipboard(JComponent comp, Clipboard clip, int action)` Вызывает передачу от данного компонента до данного буфера обмена.
`static Action`	`getCopyAction()` Возвраты `Action` это выполняет операции копии к буферу обмена.
`static Action`	`getCutAction()` Возвраты `Action` это выполняет операции сокращения к буферу обмена.
`Изображение`	`getDragImage()` Возвраты перетащить изображение.
`Точка`	`getDragImageOffset()` Возвращает смещение привязки для изображения, чтобы перетащить.
`static Action`	`getPasteAction()` Возвраты `Action` это выполняет операции вставки от буфера обмена.
`int`	`getSourceActions(JComponent c)` Возвращает тип действий передачи, поддерживаемых источником; любая комбинация битового "ИЛИ" `COPY`, `MOVE` и `LINK`.
`Значок`	`getVisualRepresentation(Transferable t)` Возвращает объект, который устанавливает вид передачи.
`boolean`	`importData(JComponent comp, Transferable t)` Вызывает передачу в компонент от буфера обмена или работы отбрасывания DND.
`boolean`	`importData(TransferHandler.TransferSupport support)` Заставляет передачу происходить от буфера обмена или работы перетаскивания и отбрасывания.
`void`	`setDragImage(Image img)` Наборы перетащить параметр изображения.
`void`	`setDragImageOffset(Point p)` Устанавливает смещение привязки для изображения, чтобы перетащить.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - НИ ОДИН
```
public static final int NONE
```
    int представление никакого действия передачи.
    
    См. Также:
    Постоянные Значения полей
  - КОПИЯ
```
public static final int COPY
```
    int представление "копии" передает действие. Это значение используется, когда данные копируются в буфер обмена или копируются в другом месте в работе перетаскивания и отбрасывания.
    
    См. Также:
    Постоянные Значения полей
  - ПЕРЕМЕСТИТЬСЯ
```
public static final int MOVE
```
    int представление "перемещения" передает действие. Это значение используется, когда данные перемещаются в буфер обмена (то есть сокращение) или перемещаются в другое место в работе перетаскивания и отбрасывания.
    
    См. Также:
    Постоянные Значения полей
  - COPY_OR_MOVE
```
public static final int COPY_OR_MOVE
```
    int представление исходной возможности действия или "копии" или "перемещения".
    
    См. Также:
    Постоянные Значения полей
  - ССЫЛКА
```
public static final int LINK
```
    int представление "ссылки" передает действие. Это значение используется, чтобы определить, что данные должны быть соединены в работе перетаскивания и отбрасывания.
    
    С тех пор:
    
    1.6
    
    См. Также:
    DnDConstants.ACTION_LINK, Постоянные Значения полей
- Деталь конструктора
  - TransferHandler
```
public TransferHandler(String property)
```
    Создает обработчик передачи, который может передать свойство Bean Java от одного компонента до другого через буфер обмена или перетаскивание и отбросить работу.
    
    Параметры:
    property - имя свойства, чтобы передать; это может быть null если нет никакого свойства, связанного с обработчиком передачи (подкласс, который выполняет некоторый другой вид передачи, например),
  - TransferHandler
```
protected TransferHandler()
```
    Конструктор удобства для подклассов.
- Деталь метода
  - getCutAction
```
public static Action getCutAction()
```
    Возвраты Action это выполняет операции сокращения к буферу обмена. Когда выполняющийся, это действие работает на JComponent источник ActionEvent вызывая exportToClipboard, с a MOVE действие, на компоненте TransferHandler.
    
    Возвраты:
    Action для того, чтобы выполнить сокращения к буферу обмена
  - getCopyAction
```
public static Action getCopyAction()
```
    Возвраты Action это выполняет операции копии к буферу обмена. Когда выполняющийся, это действие работает на JComponent источник ActionEvent вызывая exportToClipboard, с a COPY действие, на компоненте TransferHandler.
    
    Возвраты:
    Action для того, чтобы выполнить копии к буферу обмена
  - getPasteAction
```
public static Action getPasteAction()
```
    Возвраты Action это выполняет операции вставки от буфера обмена. Когда выполняющийся, это действие работает на JComponent источник ActionEvent вызывая importData, с содержанием буфера обмена, на компоненте TransferHandler.
    
    Возвраты:
    Action для того, чтобы выполнить вставки от буфера обмена
  - setDragImage
```
public void setDragImage(Image img)
```
    Наборы перетащить параметр изображения. Изображение должно быть подготовлено к тому, что оно представило к моменту вызова. Изображение сохранено ссылкой из-за некоторых причин производительности.
    
    Параметры:
    img - изображение, чтобы перетащить
  - getDragImage
```
public Image getDragImage()
```
    Возвраты перетащить изображение. Если нет никакого изображения, чтобы перетащить, возвращенное значение null.
    
    Возвраты:
    ссылка на перетащить изображение
  - setDragImageOffset
```
public void setDragImageOffset(Point p)
```
    Устанавливает смещение привязки для изображения, чтобы перетащить. Это не может быть null.
    
    Параметры:
    p - a Point объект, который соответствует координатам смещения привязки изображения относительно левого верхнего угла изображения
  - getDragImageOffset
```
public Point getDragImageOffset()
```
    Возвращает смещение привязки для изображения, чтобы перетащить.
    
    Возвраты:
    a Point объект, который соответствует координатам смещения привязки изображения относительно левого верхнего угла изображения. Точка (0,0) возвраты по умолчанию.
  - exportAsDrag
```
public void exportAsDrag(JComponent comp,
                InputEvent e,
                int action)
```
    Причины Swing перетаскивают поддержку, которая будет инициироваться. Это вызывают различные реализации UI в javax.swing.plaf.basic пакет, если dragEnabled свойство устанавливается на компоненте. Это могут вызвать пользовательские реализации UI, чтобы использовать Swing, перетаскивают поддержку. Этот метод может также вызвать расширение Swing, записанное как подкласс JComponent чтобы использовать в своих интересах Swing перетаскивают поддержку.
    Передача будет не обязательно завершена при возврате этого вызова (то есть вызов не блокирует ожидание отбрасывания). Передача будет иметь место посредством реализации Swing java.awt.dnd механизм, не требуя никакого дальнейшего усилия от разработчика. exportDone метод вызовут, когда передача завершилась.
    
    Параметры:
    comp - компонент, содержащий данные, которые будут переданы; если позволить совместно использовать TransferHandlers
    e - событие, которое инициировало передачу
    action - действие передачи первоначально требуют; также COPY, MOVE или LINK; система DnD может изменить действие, используемое в течение перетащить работы
  - exportToClipboard
```
public void exportToClipboard(JComponent comp,
                     Clipboard clip,
                     int action)
                       throws IllegalStateException
```
    Вызывает передачу от данного компонента до данного буфера обмена. Этот метод вызывают сокращение по умолчанию и действия копии, зарегистрированные в карте действия компонента.
    Передача будет иметь место, используя java.awt.datatransfer механизм, не требуя никакого дальнейшего усилия от разработчика. Любая передача данных будет полна и exportDone метод вызовут с действием, которое произошло перед этим методом возвраты. Если буфер обмена недоступен, пытаясь поместить данные в это, IllegalStateException брошенный Clipboard.setContents(Transferable, ClipboardOwner) будет propogated через этот метод. Однако, exportDone будет сначала вызван с действием NONE для непротиворечивости.
    
    Параметры:
    comp - компонент, содержащий данные, которые будут переданы; если позволить совместно использовать TransferHandlers
    clip - буфер обмена, чтобы передать данные в
    action - действие передачи требуют; это должно быть значением также COPY или MOVE; выполняемая работа является пересечением возможностей передачи, данных getSourceActions и требуемым действием; пересечение может привести к действию NONE если требуемое действие не поддерживается
    
    Броски:
    
    IllegalStateException - если буфер обмена в настоящий момент недоступен
    См. Также:
    Clipboard.setContents(Transferable, ClipboardOwner)
  - importData
```
public boolean importData(TransferHandler.TransferSupport support)
```
    Заставляет передачу происходить от буфера обмена или работы перетаскивания и отбрасывания. Transferable чтобы быть импортированными и компонент, чтобы передать содержатся в пределах TransferSupport.
    В то время как вызовы реализации перетаскивания и отбрасывания canImport чтобы определить пригодность передачи прежде, чем вызвать этот метод, реализация вставки не делает. Также, нельзя предположить, что передача является приемлемой после звонка в этот метод для вставки. Этому рекомендуют это canImport явно вызовите, чтобы покрыть этот случай.
    Отметьте: TransferSupport объект, который передают к этому методу, только допустим для продолжительности вызова метода. Это неопределено, что оценивает это, может содержать после этого метода возвраты.
    
    Параметры:
    support - объект, содержащий детали передачи, нет null.
    
    Возвраты:
    истина, если данные были вставлены в компонент, ложь иначе
    
    Броски:
    
    NullPointerException - если support null
    С тех пор:
    
    1.6
    
    См. Также:
    canImport(TransferHandler.TransferSupport)
  - importData
```
public boolean importData(JComponent comp,
                 Transferable t)
```
    Вызывает передачу в компонент от буфера обмена или работы отбрасывания DND. Transferable представляет данные, которые будут импортированы в компонент.
    Отметьте: Swing теперь вызывает более новую версию importData это берет a TransferSupport, который поочередно вызывает этот метод (если компонент в TransferSupport a JComponent). Разработчики поощряются вызвать и переопределить более новую версию, поскольку она предоставляет больше информации (и единственная версия, которая поддерживает использование с a TransferHandler набор непосредственно на a JFrame или другой не -JComponent).
    
    Параметры:
    comp - компонент, чтобы получить передачу; если позволить совместно использовать TransferHandlers
    t - данные, чтобы импортировать
    
    Возвраты:
    истина, если данные были вставлены в компонент, ложь иначе
    См. Также:
    importData(TransferHandler.TransferSupport)
  - canImport
```
public boolean canImport(TransferHandler.TransferSupport support)
```
    Этот метод неоднократно вызывают во время работы перетаскивания и отбрасывания, чтобы позволить разработчику конфигурировать свойства, и возвращать приемлемость передач; с возвращаемым значением true указание, что передача представляется данным TransferSupport (который содержит все детали передачи), является приемлемым в текущее время, и значение false отклонение передачи.
    Для тех компонентов, которые автоматически выводят на экран расположение отбрасывания во время, перетаскивают и отбрасывают, признавая, что передача, по умолчанию, говорит им показывать расположение отбрасывания. Это может быть изменено, вызывая setShowDropLocation на TransferSupport.
    По умолчанию, когда передача принимается, выбранное действие отбрасывания состоит в том что выбрано пользователем через их перетаскиваемое жест. Разработчик может переопределить это и выбрать различное действие, от поддерживаемых исходных действий, вызывая setDropAction на TransferSupport.
    На каждом звонке canImport, TransferSupport содержит новое состояние. Также, любой набор свойств на этом должен быть установлен на каждом вызове. После отбрасывания, canImport вызывается одним заключительным временем прежде, чем вызвать в importData. Любой набор состояния на TransferSupport во время той последней возможности будет доступно в importData.
    Этот метод не вызывают внутренне в ответ на операции вставки. Также, этому рекомендуют это реализации importData явно вызовите этот метод для таких случаев и что этот метод быть подготовленными возвратить пригодность операций вставки также.
    Отметьте: TransferSupport объект, который передают к этому методу, только допустим для продолжительности вызова метода. Это неопределено, что оценивает это, может содержать после этого метода возвраты.
    
    Параметры:
    support - объект, содержащий детали передачи, нет null.
    
    Возвраты:
    true если импорт может произойти, false иначе
    
    Броски:
    
    NullPointerException - если support null
    С тех пор:
    
    1.6
    
    См. Также:
    importData(TransferHandler.TransferSupport), TransferHandler.TransferSupport.setShowDropLocation(boolean), TransferHandler.TransferSupport.setDropAction(int)
  - canImport
```
public boolean canImport(JComponent comp,
                DataFlavor[] transferFlavors)
```
    Указывает, примет ли компонент импорт данного набора разновидностей данных до того, чтобы фактически пытаться импортировать это.
    Отметьте: Swing теперь вызывает более новую версию canImport это берет a TransferSupport, который поочередно вызывает этот метод (только если компонент в TransferSupport a JComponent). Разработчики поощряются вызвать и переопределить более новую версию, поскольку она предоставляет больше информации (и единственная версия, которая поддерживает использование с a TransferHandler набор непосредственно на a JFrame или другой не -JComponent).
    
    Параметры:
    comp - компонент, чтобы получить передачу; если позволить совместно использовать TransferHandlers
    transferFlavors - доступные форматы данных
    
    Возвраты:
    истина, если данные могут быть вставлены в компонент, ложь иначе
    См. Также:
    canImport(TransferHandler.TransferSupport)
  - getSourceActions
```
public int getSourceActions(JComponent c)
```
    Возвращает тип действий передачи, поддерживаемых источником; любая комбинация битового "ИЛИ" COPY, MOVE и LINK.
    Некоторые модели не изменчивы, таким образом, работа передачи MOVE не должен рекламироваться в этом случае. Возврат NONE отключения передают от компонента.
    
    Параметры:
    c - компонент, содержащий данные, которые будут переданы; если позволить совместно использовать TransferHandlers
    
    Возвраты:
    COPY если свойство передачи может быть найдено, иначе возвраты NONE
  - getVisualRepresentation
```
public Icon getVisualRepresentation(Transferable t)
```
    Возвращает объект, который устанавливает вид передачи. Это полезно и для обеспечения обратной связи, выполняя перетащить работу и для того, чтобы представить передачу в реализации буфера обмена, у которой есть визуальное появление. Реализация Icon интерфейс не должен изменить графический клип или альфа-уровень. Реализация значка не должна быть прямоугольной или нарисовать весь ограничительный прямоугольник и логику, которая вызывает метод краски значков, не должен предположить, что все биты красятся. null допустимое возвращаемое значение для этого метода и указывает, что нет никакого визуального обеспеченного представления. В этом случае логика вызова свободна представить передаваемое однако, она хочет.
    Логика Swing по умолчанию не будет делать, смешанная альфа перетаскивает анимацию, если возврат null.
    
    Параметры:
    t - данные, которые будут переданы; эта стоимость, как ожидают, будет создана createTransferable метод
    
    Возвраты:
    null, указание там не является никаким визуальным представлением по умолчанию
  - createTransferable
```
protected Transferable createTransferable(JComponent c)
```
    Создает a Transferable использовать в качестве источника для передачи данных. Возвращает представление данных, которые будут переданы, или null если свойство компонента null
    
    Параметры:
    c - компонент, содержащий данные, которые будут переданы; если позволить совместно использовать TransferHandlers
    
    Возвраты:
    представление данных, которые будут переданы, или null если свойство, связанное с c null
  - exportDone
```
protected void exportDone(JComponent source,
              Transferable data,
              int action)
```
    Вызванный после того, как данные были экспортированы. Этот метод должен удалить данные, которые были переданы, если действие было MOVE.
    Этот метод реализуется, чтобы ничего не сделать с тех пор MOVE не поддерживаемое действие этой реализации (getSourceActions не включает MOVE).
    
    Параметры:
    source - компонент, который был источником данных
    data - Данные, которые были переданы или возможно нуль, если действие NONE.
    action - фактическое действие, которое выполнялось

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс TransferHandler

Вложенная Сводка Класса

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

НИ ОДИН

КОПИЯ

ПЕРЕМЕСТИТЬСЯ

COPY_OR_MOVE

ССЫЛКА

Деталь конструктора

TransferHandler

TransferHandler

Деталь метода

getCutAction

getCopyAction

getPasteAction

setDragImage

getDragImage

setDragImageOffset

getDragImageOffset

exportAsDrag

exportToClipboard

importData

importData

canImport

canImport

getSourceActions

getVisualRepresentation

createTransferable

exportDone