Spec-Zone .ru спецификации, руководства, описания, API

Содержание документации

Передача данных Swing

Для Java 2 Платформы, Standard Edition, v 1.4 выпуска, Swing добавил поддержку передачи данных между приложениями. Работа перетаскивания и отбрасывания является запросом передачи данных, который был определен жестом с графическим манипулятором. В случае копии/вставки передача данных часто инициируется с клавиатурой. Возможность передать данные принимает две формы:

• Перетащите и отбросьте (DnD) поддержку
• Передача буфера обмена через сокращение/копию/вставку

Поскольку состояние каждого компонента Swing независимо от определения модели данных, было легко реализовать механизм для того, чтобы переместить данные между компонентами, не волнуясь о деталях данных непосредственно. Передача данных составляет передачу части одной модели к другой модели. (В случае сокращения/копии/вставки данные передаются между моделью и буфером обмена.), Чтобы поддерживать передачу данных, нас:

• Добавленный небольшое количество API, чтобы включить передаче данных с несколькими вызовами метода.
• Позволенный, чтобы отключить Swing реализация DnD так, чтобы пользователь мог использовать поддержку, оказанную AWT, чтобы настроить любое специальное поведение.
• Реализованный необходимые изменения в реализациях стили мы обеспечиваем.

Справочник: Компоненты Та Поддержка DnD

У этого документа есть следующие разделы:

• Поддержка Передачи данных
  • Значение по умолчанию Поддержка TransferHandler
  • Пример Добавляющей Поддержки JLabel
• Перетащите Поддержку
  • Значение по умолчанию Перетаскивает Поддержку
  • Добавление Перетаскивает Поддержку Подклассам Классов Swing
  • Работа TransferHandler.exportAsDrag
• Поддержка отбрасывания
  • Поддержка Отбрасывания значения по умолчанию
  • Используя Поддержку Отбрасывания в Подклассах Классов Swing
• Поддержка Передачи буфера обмена
  • Передача Буфера обмена значения по умолчанию
  • Используя Поддержку Передачи Буфера обмена в Подклассах Классов Swing
• Детали реализации
• Изменения Начиная с Беты
• Известные Ошибки

Поддержка Передачи данных

Основа передачи данных является поддержкой обработки передачи данных в и из компонента. С этой функциональностью, доступной на компоненте, механика управления перетаскиванием и отбрасыванием может быть обеспечена автоматически. Кроме того, поддержка сокращения/копии/вставки может также быть оказана автоматически. Затруднением этой реализации является новый class TransferHandler. JComponent методы свойства, setTransferHandler и getTransferHandler, обеспечьте entrypoint для механизма передачи данных для любого компонента, который расширяется JComponent.

Таблица ниже детализирует степень сокращения, копии, вставки, и поддержки отбрасывания каждого из компонентов когда не -null TransferHandler устанавливается. Отметьте, что эта поддержка включается кодом стили. Поддержка перетаскивания первоначально отключается, но может быть включена, вызывая setDragEnabled(true) на компоненте. Если у компонента нет такого метода, перетаскивание может быть включено, связывая некоторый жест с этим.

Значение по умолчанию Поддержка TransferHandler

Компоненты Та Поддержка DnD

Пример Добавляющей Поддержки JLabel

JLabel компонент не поддерживает DnD по умолчанию. Следующий фрагмент кода создает a JLabel это поддерживает, перетаскивают и отбрасывают на "текстовом" свойстве (a String):

JLabel componentType = new JLabel();
componentType.setTransferHandler(new TransferHandler("text"));
MouseListener ml = new MouseAdapter() {
    public void mousePressed(MouseEvent e) {
        JComponent c = (JComponent)e.getSource();
        TransferHandler th = c.getTransferHandler();
        th.exportAsDrag(c, e, TransferHandler.COPY);
    }
};
componentType.addMouseListener(ml);

Мы включали маленький пример, который реализации перетаскивают и отбрасывают использование a JTextField и a JLabel. Можно ввести значение в текстовое поле, выделить текст, затем удержать кнопку мыши вниз по текстовому полю и перетащить несколько пикселей. Значок появляется под курсором. Выпустите значок по JLabel и см., что текст заменяет "Отбрасывание Здесь" текст. Одновременно с отбрасыванием, текст удаляется из исходного текстового поля. Поведение значения по умолчанию для перетаскивает, и отбрасывание MOVE. Изменить поведение на COPY, удержите CONTROL ключ, выбирая текст. На Windows знак "плюс" появляется в значке. Когда текст выпускается на цели, это оставляют неповрежденным в источнике. Можно аналогично перетащить от JLabel к текстовому полю. Отметьте это JLabel не имеет привязки для копии/вставки и неспособен получить фокус, который обязан поддерживать эту функцию.

См. пример JLabelDragNDrop.java здесь.

Перетащите Поддержку

Некоторые компоненты, такие как текстовые поля, поддерживают выборы. Для тех видов компонентов перетащить работа обычно инициируется, перетаскивая существующий выбор с мышью. Контроллер для этого типа компонента может распознать это условие и инициировать перетаскивание. Для тех компонентов, у которых нет выборов, Swing не может автоматически инициировать перетаскивание, но Swing может обработать механику перетаскивания если сказано, что перетащить попытка инициировалась как показано в JLabel пример.

С этим уровнем перетаскивают поддержку, разработчик Swing может сосредоточиться на том, чтобы реализовывать a TransferHandler это представляет требуемую передачу, и свойства установки на компоненте Swing. Это значительно упрощает бремя для разработчика Swing, желающего поддерживать притягивающий приложение.

Отметьте, что мы в настоящий момент исследуем обеспечение различных визуальных появлений перетаскивания, следовательно ссылка на Icon в API. Останьтесь настроенными для будущих разработок.

Значение по умолчанию Перетаскивает Поддержку

Самый простой уровень поддержки должен установить флаг, который указывает, что разработчик хотел бы включенную поддержку значения по умолчанию. Компоненты, которые предлагают поддержку значения по умолчанию перетаскивания, описываются в столбце Exports Компонентов Та Поддержка таблица DnD; но подводить итог, классы это непосредственно реализует setDragEnabled и getDragEnabled : JColorChooser, JFileChooser, JList, JTable, JTree, и JTextComponent. Перетащить жест определяется как нажатие первой кнопки мыши по выбору и перетаскивающий несколько пикселей. Установка dragEnabled свойство к true поэтому имеет тонкий эффект на поведение мыши.

Когда перетаскивание включается на компоненте, контроллер Swing (в соответствии ComponentUI подкласс), начинает искать перетащить жест, и если transferHandler свойство null, или отмеченный присутствием UIResource интерфейс, реализация по умолчанию устанавливается. Реализация, обеспеченная Swing, отмечается с UIResource интерфейс, таким образом, разработчик может вставить новое TransferHandler заменяя значение по умолчанию TransferHandler свойство с пользовательской реализацией. Когда перетащить жест распознается, exportAsDrag к методу обращаются TransferHandler который инициирует перетащить механизм. Фактическая передача обрабатывается java.awt.dnd механизм, не требуя никакого дальнейшего усилия от разработчика.

Добавление Перетаскивает Поддержку Подклассам Классов Swing

Перетащить поддержка, оказанная Swing, активируется TransferHandler.exportAsDrag метод. Это заставляет добавление перетащить поддержку столь же легкую как:

1. Установка a TransferHandler реализация (таким образом, есть что-то, чтобы перетащить), вызывая setTransferHandler метод.
2. Распознавание перетащить жест.
3. Вызов exportAsDrag метод.

Некоторые сценарии для того, чтобы выполнить это:

• Добавьте a MouseListener это наблюдает за требуемым жестом, затем вызовите getTransferHandler на компоненте и вызове exportAsDrag метод, когда требуемый жест находится. См. пример JLabel.
• Повторно реализуйте processMouseEvent метод в подклассе и вызове exportAsDrag метод на переменной ComponentUI, когда перетащить жест замечается, иначе выполните поведение суперкласса.
• В компоненте с пользовательской реализацией UI имейте вызов контроллера exportAsDrag когда перетащить жест был замечен.

Работа TransferHandler.exportAsDrag

Когда exportAsDrag к методу обращаются TransferHandler, перетаскивание обрабатывается Swing, обеспеченным функциональность. То, когда этот метод вызывают, предполагается, что допустимое перетаскивает жест, было распознано. Метод выполняет следующие шаги:

1. Реализация Swing a DragSource и DragListener используется, чтобы запустить перетащить использование Transferable реализация, возвращенная createTransferable как объект передачи данных.
2. Когда отбрасывание завершилось, exportDone к методу обращаются TransferHandler. Для некоторых операций, такой как MOVE, может быть необходимо удалить данные из источника. Поведение значения по умолчанию для основанных на тексте компонентов, например, состоит в том, что стандарт перетаскивает реализации MOVE поведение (после отбрасывания выбранный текст удаляется из исходного компонента). Пользователь может переопределить это поведение удержанием клавиши CTRL, когда текст выбирается для того, чтобы перетащить. На Windows перетащить значок визуально отражает это поведение с маленьким знаком "плюс".

Поддержка отбрасывания

Основная поддержка обработки отбрасывания является тем же самым что касается операции вставки, importData метод на TransferHandler. Семантика вставки данных в компонент обычно более значима на уровне приложения чем уровень инструментария. Пользователи приложения могут отбросить все виды Transferable реализации на компонентах, которые абсолютно неизвестны инструментарию Swing. Это до разработчика Swing, чтобы обеспечить a TransferHandler со значимой семантикой импорта, если значение по умолчанию TransferHandler недостаточно.

У работы отбрасывания действительно есть некоторые различия от вставки однако:

• Обычно потенциальный сайт отбрасывания обеспечивает обратную связь того, где данные были бы приняты.
• Для компонентов с возможностями выбора точка вставки перемещается, чтобы указать, куда данные были бы помещены.

Поддержка Отбрасывания значения по умолчанию

Чтобы помочь разработчикам Swing в добавляющей поддержке отбрасывания приложению, Swing обеспечивает DropTarget реализации, которые используют TransferHandler свойство на компоненте Swing. Для тех компонентов, которые имеют не -null TransferHandler свойство, цель отбрасывания устанавливается ComponentUI если значение dropTarget свойство null или отмеченный присутствием UIResource интерфейс. Значение по умолчанию DropTarget реализации, установленные ComponentUI отмечается UIResource интерфейс, позволяя разработчикам переопределить значение по умолчанию DropTarget.

Компоненты, которые обеспечивают полную реализацию отбрасывания по умолчанию, обозначаются в столбце Imports Компонентов Та Поддержка таблица DnD. Есть четыре компонента, которые оказывают только некоторую поддержку для отбрасывания. JFileChooser, JList, JTable, и JTree по умолчанию имейте установленный DropTarget это указывает на потенциальную точку вставки. Однако, чтобы полностью поддерживать импорт данных разработчик должен записать и установить пользовательское TransferHandler.

Используя Поддержку Отбрасывания в Подклассах Классов Swing

Реализация DropTarget хорошего поведения использует transferHandler свойство на JComponent выполнять отбрасывание. Разработчик Swing автоматически получает простое DropTarget реализация, которая соединяет спад TransferHandler когда transferHandler свойство устанавливается и dropTarget свойство null.

Поддержка Передачи буфера обмена

Сокращение, копия, и операции вставки выполняют передачу данных способом, который более полезен для тех без мыши, поскольку они обычно инициируются через жест клавиатуры. Эти операции могут использовать то же самое TransferHandler службы как поддержка перетаскивания и отбрасывания. Это улучшает доступность передач данных, и позволяет Swing обеспечить клавиатурные привязки для этих операций даже при том, что Swing, возможно, не знает, как фактически передать данные буферу обмена. Клавиатурные привязки для передачи буфера обмена зависят от текущего стили, который устанавливается.

Передача Буфера обмена значения по умолчанию

Как с перетаскивают и отбрасывают, передачи буфера обмена являются самыми полезными для тех компонентов та поддержка выборы. Список компонентов, показанных в столбце Exports Компонентов, Которые сократила Поддержка таблица DnD, скопируйте, и вставьте действия в компонентной карте действия, наряду с зависимым набором LAF клавиатурных привязок во входной карте компонента. Наличие Swing обеспечивает, эта привязка освобождает разработчика от попытки отследить текущий стиль и изменить привязку.

Используя Поддержку Передачи Буфера обмена в Подклассах Классов Swing

Сокращение хорошего поведения, копия, и реализация вставки используют transferHandler свойство на JComponent выполнять передачу. Когда transferHandler свойство устанавливается на a JComponent, простое Action реализация, которая соединяет передачу между a Clipboard и TransferHandler устанавливается в карте действия компонента под ключами cut, copy, и paste если нет никакого действия, в настоящий момент установленного.

Детали реализации

Отметьте: следующая информация обрисовывает в общих чертах частные детали реализации и подвержена изменениям. Мы предоставляем эту информацию только, чтобы удовлетворить любопытство тех, кто имеет доступ к исходному коду и чувствует себя вынужденным ударить шины и быстрый взгляд под капотом.

Если a TransferHandler устанавливается на a JComponent, стиль тогда включает сокращению, копии, и вставке, используя следующий TransferHandler методы:

• getCutAction
• getCopyAction
• getPasteAction

Следующие частные на пакет классы были добавлены к javax.swing.plaf.basic пакет для того, чтобы создать поддержку значения по умолчанию:

BasicTransferable

Основание различного Transferable реализации.

BasicDropTargetListener

Добавляет прокрутка поддержки и целевой обратной связи отбрасывания для тех компонентов, поддерживающих выбор.

BasicDragGestureRecognizer

Поддерживает "избранный, и переместитесь, несколько пикселей" перетаскивают распознавание жеста.

Каждый из ComponentUI у классов, которые поддерживают DnD тогда, есть некоторые дополнительные вложенные классы:

BasicTreeUI:

TreeTransferHandler

Поддержка импорта/экспорта значения по умолчанию.

TreeTransferable

Фактические древовидные данные.

TreeDragGestureRecognizer

Дерево перетаскивает распознавание жеста, включенное JTree.setDragEnabled.

TreeDropHandler

Шоу отбрасывают целевое расположение.

BasicListUI, BasicTableUI, BasicTextUI у всех есть образец, подобный как BasicTreeUI.

BasicFileChooserUI

Использует поддержку списка, но имеет a FileTransferHandler это производит FileTransferable это расширяется ListTransferable с разновидностью, используемой для передач файлов.

BasicColorChooserUI

Использование TransferHandler бобовая поддержка и связывает "цветное" свойство. Слушатель мыши добавляется к области предварительного просмотра, чтобы связать щелчок мышью с exportAsDrag метод на TransferHandler.

Изменения Начиная с Беты

Действия TransferHandler Должны быть Зарегистрированы UI

Отчет bugtraq, который соответствует этому изменению: 4460011.

Чтобы реализовать перетаскивают и отбрасывают, привязка была обеспечена в Action class, чтобы поддерживать копирование и вставку данных. Для стили, или другого кода, чтобы переопределить их Actions, UI должен установить их - Actions автоматически больше не устанавливаются TransferHandler. Закрытые методы пакета getCutAction, getCopyAction, и getPasteAction в TransferHandler теперь обнародованы.

Возможность Отключить DropTarget

Отчет bugtraq, который соответствует этому изменению: 4485914.

Реализация перетаскивания и отбрасывания вызывает a DropTarget быть добавленным к a JComponent если у того компонента есть a TransferHandler установленный. Это может влиять на приложения, которые вручную добавляют DropTargets. Поэтому свойство System suppressSwingDropSupport был добавлен. JComponent методы setTransferHandler(TransferHandler) и getTransferHandler может использоваться, чтобы включить или отключить это свойство.

Известные Ошибки

Отбрасывание Ударяет Выбранный текст в JTextComponent

Отчет bugtraq, который соответствует этой проблеме: 4513715.

Выбор текста и затем перетаскивания, на которое текст в пределах выбранной области того же самого текстового компонента заставляет выбранный текст быть ударенным и ничто, чтобы быть вставленным. Эта ошибка исправляется в выпуске 1.4.1.

Случайные Ошибки в Восстановлении Каре, Выходя из Компонента

Отчет bugtraq, который соответствует этой проблеме: 4513720.

Со встроенной поддержкой отбрасывания текстовые компоненты Swing отвечают на DnD dragovers, устанавливая Caret к видимому и использующему это, чтобы вывести на экран потенциальное расположение вставки. Когда перетащить выходы компонент, Caret's видимость восстанавливается. К сожалению, начиная с Caret использует то же самое"visible"свойство, чтобы представить обычное значение видимых так же как когда это находится в середине флэш-памяти, мы иногда, восстанавливает видимость Каре неправильно.

Сократите/Копируйте/Перетащите Поврежденный для JEditorPane с RTFEditorKit

Отчет bugtraq, который соответствует этой проблеме: 4513638.

При использовании RTFEditorKit набор явно на a JEditorPane использование setEditorKit, или устанавливая content-type к text/rtf, сокращение, копия и не перетаскивают больше работу. Отметьте, что эта ошибка, зарегистрированная против выпуска 1.4, исправляется в выпуске 1.4.1.

---

Авторское право © 1993, 2012, Oracle и/или его филиалы. Все права защищены.

Свяжитесь с Нами