Abteilung Informatik, JFC/Swing 2004 Diego Schmidlin V2.2

Transkript

1 Inhalt 1. Drag and Drop (DnD) 1. Transfer-Mechanismus 2. Transfer-Support 3. Cursor-Symbole 4. Einführendes Beispiel 5. Komponenten DnD-fähig machen 6. Standard DnD-Verhalten ändern Folie 1 Lernziele Sie wissen, wie Drag and Drop funktioniert Sie kennen den Transfer-Mechanismus und wissen, welche Swing-Komponenten DnD standardmässig unterstützen Sie können Swing-Komponenten DnD-fähig machen Sie sind in der Lage, spezialisierte Transfer-Handler zu implementieren Folie Diego Schmidlin Seite 1

2 1.1 Transfer-Mechanismus (1) Viele Programme profitieren von einem Transfer-Mechanismus Transfer zwischen Java-Applikationen zwischen Java- und Nativ-Applikationen Zwei Mechanismen Drag and Drop (DnD) Zwischenablage (Clipboard) Folie Transfer-Mechanismus (2) Drag and Drop JComponent A Drag Transfer- Handler A Transferable- Object Drop Transfer- Handler B JComponent B Folie Diego Schmidlin Seite 2

3 1.1 Transfer-Mechanismus (3) Clipboard JComponent A Cut/ Copy Transfer- Handler A Transferable- Object Clipboard Paste Clipboard Transferable- Object Transfer- Handler B JComponent B Folie Transfer-Support Viele Swing-Komponenten unterstützen bereits den Transfer-Mechanismus Komponente JColorChooser JEditorPane JFileChooser JFormattedTextField JList JPasswordField JTable JTextArea JTextField JTextPane JTree Drag/Copy M Drag/Move M Drop Cut M Copy M Paste Folie Diego Schmidlin Seite 3

4 1.3 Cursor-Symbole Folgende Cursor-Symbole werden für DnD Operationen angezeigt Microsoft Windows Solaris/Linux Beschreibung Copy Die darunter liegende Komponente akzeptiert diesen Datentyp Copy Die darunter liegende Komponente akzeptiert diesen Datentyp nicht Move Die darunter liegende Komponente akzeptiert diesen Datentyp Move Die darunter liegende Komponente akzeptiert diesen Datentyp nicht Folie Einführendes Beispiel Standard DnD-Verhalten von Swing-Komponenten DnD kann ein-/ausgeschaltet werden component.setdragenabled(true); Bei ausgeschaltetem DnD wird trotzdem unterstützt: Cut Copy Paste Folie Diego Schmidlin Seite 4

5 1.5 Komponenten DnD-fähig machen (1) JLabel unterstützt standardmässig kein DnD Jede Swing-Komponente kann DnD-fähig werden Vorgehen 1. TransferHandler installieren Datenformat ist"text" label = new JLabel("I'm a Label!",SwingConstants.LEADING); label.settransferhandler(new TransferHandler("text")); 2. Speziellen MouseListener installieren MouseListener listener = new DragMouseAdapter(); label.addmouselistener(listener); Folie Komponenten DnD-fähig machen (2) MouseListener Mouseaktivitäten für DnD abfangen TransferHandler der Komponente übergeben private class DragMouseAdapter extends MouseAdapter { public void mousepressed(mouseevent e) { JComponent c = (JComponent)e.getSource(); TransferHandler handler = c.gettransferhandler(); handler.exportasdrag(c, e, TransferHandler.COPY); Folie Diego Schmidlin Seite 5

6 1.6 Standard DnD-Verhalten ändern (1) Einige Swing-Komponenten unterstützen Drop nicht Es gibt kein allgemeines Verhalten bei einem Drop Was soll z.b bei einer JList geschehen? Knoten ersetzen? Einfügen vor dem Knoten? Einfügen als Kind-Knoten? Lösung Klasse TransferHandler erweitern TransferHandler Import/Export-Funktionen Festlegen der unterstützten Datenformate Folie Standard DnD-Verhalten ändern (2) Beispiel mit Erweiterung der TransferHandler von JList Implementation von Drop auf JList (Import) Für jede übergebene Zeile wird ein Listeneintrag generiert Implementation von Move (Export) Export von mehreren Listeneinträgen String mit Zeilenumbrüchen JTable Implementationvon Drop auf JTable (Import) Strings mit Zeilenumbrüchen ergeben neue Tabellen-Zeilen Strings mit Kommas werden in Spalten abgefüllt Implementation von Move (Export) Export von Tabellen-Zeilen/Spalten String mit Zeilenumbrüchen und Kommas Folie Diego Schmidlin Seite 6

7 1.6 Standard DnD-Verhalten ändern (3) Abstrakte Klasse StringTransferHandler public abstract class StringTransferHandler extends TransferHandler { protected abstract String exportstring(jcomponent c); protected abstract void importstring(jcomponent c, String str); protected abstract void cleanup(jcomponent c, boolean remove); protected Transferable createtransferable(jcomponent c) { return new StringSelection(exportString(c)); public int getsourceactions(jcomponent c) { return COPY_OR_MOVE; protected void exportdone(jcomponent c, Transferable data, int action) { cleanup(c, action == MOVE); Folie Standard DnD-Verhalten ändern (4) public boolean importdata(jcomponent c, Transferable t) { if (canimport(c, t.gettransferdataflavors())) { try { String str = (String)t.getTransferData(DataFlavor.stringFlavor); importstring(c, str); return true; catch (UnsupportedFlavorException ufe) { catch (IOException ioe) { return false; public boolean canimport(jcomponent c, DataFlavor[] flavors) { for (int i = 0; i < flavors.length; i++) { if (DataFlavor.stringFlavor.equals(flavors[i])) { return true; return false; Folie Diego Schmidlin Seite 7

8 1.6 Standard DnD-Verhalten ändern (5) Klasse ListTransferHandler public class ListTransferHandler extends StringTransferHandler { private int[] indices = null; private int addindex = -1; //Ort zum Einfügen private int addcount = 0; //Anzahl hinzugefügter Items //Export String: Mehrfachselektion in String mit Newline "\n" wandeln protected String exportstring(jcomponent c) { JList list = (JList)c; indices = list.getselectedindices(); Object[] values = list.getselectedvalues(); StringBuffer buff = new StringBuffer(); for (int i = 0; i < values.length; i++) { Object val = values[i]; buff.append(val == null? "" : val.tostring()); if (i!= values.length - 1) { buff.append("\n"); return buff.tostring(); Folie Standard DnD-Verhalten ändern (6) //Import String: String mit Newline "\n" in einzelne Listeneinträge wandeln protected void importstring(jcomponent c, String str) { JList target = (JList)c; DefaultListModel listmodel = (DefaultListModel)target.getModel(); int index = target.getselectedindex(); if (indices!= null && index >= indices[0] - 1 && index <= indices[indices.length - 1]) { indices = null; return; int max = listmodel.getsize(); if (index < 0) { index = max; else { index++; if (index > max) { index = max; addindex = index; String[] values = str.split("\n"); addcount = values.length; for (int i = 0; i < values.length; i++) { listmodel.add(index++, values[i]); Folie Diego Schmidlin Seite 8

9 1.6 Standard DnD-Verhalten ändern (7) //Wenn remove == true, dann selektierte Listeneinträge aus Liste entfernen protected void cleanup(jcomponent c, boolean remove) { if (remove && indices!= null) { JList source = (JList)c; DefaultListModel model = (DefaultListModel)source.getModel(); //If we are moving items around in the same list, we //need to adjust the indices accordingly, since those //after the insertion point have moved. if (addcount > 0) { for (int i = 0; i < indices.length; i++) { if (indices[i] > addindex) { indices[i] += addcount; for (int i = indices.length - 1; i >= 0; i--) { model.remove(indices[i]); indices = null; addcount = 0; addindex = -1; Folie Standard DnD-Verhalten ändern (8) Applikation Exportvon JList, JTable Import in JList, JTable Folie Diego Schmidlin Seite 9

10 Zusammenfassung Der Transfer-Mechanismus bildet die Grundlage für den Datenaustausch zwischen Java-Applikationen und zwischen Java- und Nativ-Applikationen Man unterscheidet zwei Anwendungen des Transfer-Mechanismus Drag and Drop (DnD) Zwischenablage (Clipboard) Jede Swing-Komponente kann durch Installation eines TransferHandlers DnD-fähig gemacht werden Für spezielle Import/Export-Funktionen oder die Unterstützung von speziellen Datenformaten kann ein eigener TransferHandler implementiert werden Folie Übungsaufgabe U12.1 Schauen Sie sich das Beispiel aus dem Skript an Beispiele sind aus untenstehendem Java-Tutorial Gehen Sie im Internet auf die Seite Lesen Sie das Kapitel "How to Use Drag and Drop and Data Transfer" Folie Diego Schmidlin Seite 10