Класс TransferHandler.TransferSupport
- Вмещающий класс:
TransferHandler
public static final class TransferHandler.TransferSupport extends Object
Основное назначение этого класса — предоставлять информацию, необходимую разработчику для определения пригодности передачи или импорта содержащихся в ней данных. Кроме того, этот класс служит контроллером для настройки свойств перетаскивания, например, отображать ли место сброса и какое действие сброса использовать.
Как правило, разработчикам не нужно создавать экземпляры этого класса. Вместо этого реализация DnD передает их определенным методам в TransferHandler.
- Начиная с:
- 1.6
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
TransferSupport |
Создает TransferSupport с isDrop() false для указанного компонента и Transferable. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Component |
getComponent() |
Возвращает целевой компонент этой передачи. |
DataFlavor[] |
getDataFlavors() |
Возвращает форматы данных этой передачи. |
int |
getDropAction() |
Возвращает действие, выбранное для сброса, если этот TransferSupport представляет собой операцию сброса. |
TransferHandler.DropLocation |
getDropLocation() |
Возвращает текущее (не- null) место сброса для компонента, если этот TransferSupport представляет собой операцию сброса. |
int |
getSourceDropActions() |
Возвращает действия сброса, поддерживаемые источником перетаскивания, если этот TransferSupport представляет собой операцию сброса. |
Transferable |
getTransferable() |
Возвращает Transferable, связанный с этой передачей. |
int |
getUserDropAction() |
Возвращает пользовательское действие сброса, если этот TransferSupport представляет собой операцию сброса. |
boolean |
isDataFlavorSupported |
Возвращает значение, указывающее, поддерживается ли указанный формат данных. |
boolean |
isDrop() |
Возвращает значение, указывающее, представляет ли этот TransferSupport операцию сброса. |
void |
setDropAction |
Устанавливает для передачи действие сброса — которая должна представлять собой операцию сброса, — указанное действие вместо действия сброса, выбранного пользователем по умолчанию. |
void |
setShowDropLocation |
Устанавливает, следует ли визуально обозначать место сброса для передачи, которая должна представлять собой операцию сброса. |
Подробное описание конструкторов
TransferSupport
public TransferSupport(Component component, Transferable transferable)
TransferSupport с isDrop() false для указанного компонента и Transferable.- Параметры:
-
component— целевой компонент -
transferable— передаваемый объект - Вызывает исключение:
-
NullPointerException— если один из параметров равенnull
Подробное описание методов
isDrop
public boolean isDrop()
TransferSupport операцию сброса.- Возвращает:
-
true, если это операция сброса, иfalseв противном случае.
getComponent
public Component getComponent()
- Возвращает:
- целевой компонент
getDropLocation
public TransferHandler.DropLocation getDropLocation()
null) место сброса для компонента, если этот TransferSupport представляет собой операцию сброса. Примечание. Для компонентов со встроенной поддержкой сброса это место будет подклассом DropLocation того же типа, который возвращает метод getDropLocation этого компонента.
Этот метод предназначен только для передач посредством перетаскивания. Его вызов, когда isDrop() равен false, приводит к IllegalStateException.
- Возвращает:
- место сброса
- Вызывает исключение:
-
IllegalStateException— если это не операция сброса - См. также:
setShowDropLocation
public void setShowDropLocation(boolean showDropLocation)
TransferHandler сообщил, что может принять импорт, представленный этим TransferSupport. С помощью этого метода можно принудительно всегда отображать или никогда не отображать место сброса. Этот метод предназначен только для передач посредством перетаскивания. Его вызов, когда isDrop() равен false, приводит к IllegalStateException.
- Параметры:
-
showDropLocation— следует ли обозначать место сброса - Вызывает исключение:
-
IllegalStateException— если это не операция сброса - См. также:
setDropAction
public void setDropAction(int dropAction)
COPY, MOVE или LINK. Этот метод предназначен только для передач посредством перетаскивания. Его вызов, когда isDrop() равен false, приводит к IllegalStateException.
- Параметры:
-
dropAction— действие сброса - Вызывает исключение:
-
IllegalStateException— если это не операция сброса -
IllegalArgumentException— если указано недопустимое действие - См. также:
getDropAction
public int getDropAction()
TransferSupport представляет собой операцию сброса. Если действие не было явно выбрано с помощью setDropAction, возвращается действие сброса, выбранное пользователем и предоставленное getUserDropAction.
Возможно, вам потребуется запросить это значение в методе importData класса TransferHandler, чтобы настроить обработку в зависимости от действия.
Этот метод предназначен только для передач посредством перетаскивания. Его вызов, когда isDrop() равен false, приводит к IllegalStateException.
- Возвращает:
- действие, выбранное для сброса
- Вызывает исключение:
-
IllegalStateException— если это не операция сброса - См. также:
getUserDropAction
public int getUserDropAction()
TransferSupport представляет собой операцию сброса. Пользовательское действие сброса выбирается, как описано в документации для DropTargetDragEvent и DropTargetDropEvent. С помощью метода setDropAction в качестве действия сброса можно выбрать другое действие.
Возможно, вам потребуется запросить это значение в методе canImport класса TransferHandler при определении пригодности сброса или выборе действия сброса, которое нужно явно задать.
Этот метод предназначен только для передач посредством перетаскивания. Его вызов, когда isDrop() равен false, приводит к IllegalStateException.
- Возвращает:
- действие сброса, выбранное пользователем
- Вызывает исключение:
-
IllegalStateException— если это не операция сброса - См. также:
getSourceDropActions
public int getSourceDropActions()
TransferSupport представляет собой операцию сброса. Действия источника представляют собой набор действий, поддерживаемых источником этой передачи, и задаются некоторой комбинацией побитового ИЛИ значений COPY, MOVE и LINK. Возможно, вам потребуется запросить это значение в методе canImport класса TransferHandler при определении пригодности сброса или выборе действия сброса, которое нужно явно задать. Чтобы определить, поддерживается ли источником определенное действие, выполните побитовое И между этим действием и действиями сброса источника, а затем сравните результат с исходным действием. Например:
boolean copySupported = (COPY & getSourceDropActions()) == COPY;
Этот метод предназначен только для передач посредством перетаскивания. Его вызов, когда isDrop() равен false, приводит к IllegalStateException.
- Возвращает:
- действия сброса, поддерживаемые источником перетаскивания
- Вызывает исключение:
-
IllegalStateException— если это не операция сброса - См. также:
getDataFlavors
public DataFlavor[] getDataFlavors()
- Возвращает:
- форматы данных этой передачи
isDataFlavorSupported
public boolean isDataFlavorSupported(DataFlavor df)
- Параметры:
-
df—DataFlavorдля проверки - Возвращает:
- значение, указывающее, поддерживается ли указанный формат данных.
getTransferable
public Transferable getTransferable()
Transferable, связанный с этой передачей. Примечание. Если нет необходимости получать Transferable напрямую, используйте один из других методов этого класса для получения сведений о передаче. Это может работать быстрее, чем получение Transferable и прямой запрос к нему.
- Возвращает:
Transferable, связанный с этой передачей
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/TransferHandler.TransferSupport.html