本文實例講述了Java利用鼠標的拖放來實現交換程序數據的方法,即所謂的鼠標拖放功能。鼠標的拖放功能在圖形化系統中非常常用,Java 提供了java.awt.dnd 和java.awt.datatransfer 包來支持該功能。本例演示如何在程序中實現拖放的實現方法,當在窗口上部的“Hello World!”標簽點下鼠標,并拖至窗口下部的文本框放開,則在文本框中將添加“Hello World !”文本;繼續上述過程,將繼續添加該文本。
該程序功能具體的實現思路和方法為:在鼠標拖放的實現中,兩個最重要的概念是拖拽源和放置目標,即drag source 和drop target。拖拽源和放置目標都是與可視化的組件相關聯的(如果不可視,還怎么拖呢?!)。拖放技術的實質就是將拖拽源組件上的數據傳遞到放置目標組件上,因此從底層看,拖放和上例中的剪貼板技術很接近。
拖拽源的實現:拖拽源類必須先創建一個DragGestureRecognizer 實例,表明該類是拖拽源組件類或包含拖拽源組件。可以通過調用DataSource 對象的createDefaultDragGestureRecognizer()方法實現。具體的實現如下:
1
2
|
int action = DnDConstants.ACTION_COPY_OR_MOVE; //拖放的類型 ds.createDefaultDragGestureRecognizer( this ,action, this ); |
上面的語句表明, 拖拽源組件是本類自身的實例對象, 要完成的拖放的種類是DnDConstants.ACTION_COPY_OR_MOVE 型的,實現DragGestureListener 接口的類是本類。拖拽源一般實現DragGestureListener 接口,該接口中定義了一個dragGestureRecognized()方法,當開始拖拽是,DragGestureListener 監聽到事件,隨即轉入dragGestureRecognized()方法處理事件,如將拖拽源的數據發送出去。具體代碼:
1
2
3
4
5
6
7
8
9
10
|
public void dragGestureRecognized(DragGestureEvent dge) { //throw new java.lang.UnsupportedOperationException("Method dragGestureRecognized() not yet implemented."); try { Transferable tr = new StringSelection( this .getText()); //將標簽的文本作為數據,由Transferable 對象包裝 //開始拖拽,設置光標為DragSource.DefaultCopyNoDrop 形,拖放的數據是tr 對象,DragSourceListener 是本類 dge.startDrag(DragSource.DefaultCopyNoDrop,tr, this ); } catch (Exception err){ err.printStackTrace(); } } |
拖拽源還得實現DragSourceListener 接口,該接口定義了拖拽相關的各狀態的事件處理方法。如dragEnter、dragOver、dropActionChanged、dragExit等方法。本例中,將實現dragEnter()方法來設置拖拽時的光標形狀,其他的方法為空方法。具體實現代碼如下:
1
2
3
4
5
6
7
8
9
10
|
public void dragEnter(DragSourceDragEvent dsde) { //throw new java.lang.UnsupportedOperationException("Method dragEnter() not yet implemented."); DragSourceContext dsc = dsde.getDragSourceContext(); //得到拖拽源的上下文引用 //設置拖拽時的光標形狀 int action = dsde.getDropAction(); if ((action&DnDConstants.ACTION_COPY)!= 0 ) dsc.setCursor(DragSource.DefaultCopyDrop); else dsc.setCursor(DragSource.DefaultCopyNoDrop); } |
放置目標的實現:放置目標的類中必須先創建一個DragTarget 實例,來表明本類是放置目標組件類或包含放置目標組件,實現如下:
1
|
new DropTarget( this .jTextField1,DnDConstants.ACTION_COPY_OR_MOVE, this ); |
上面的語句表明, 放置目標是this.jTextField1 對象, 拖放操作是DnDConstants.ACTION_COPY_OR_MOVE 型的,而實現DropTargetListener 接口的類是本類。與DrafSourceListener 相對應,放置目標或其所在類一般實現DropTargetListener 接口。該接口也定義了很多的方法,如dragEnter、dragOver 等,用于處理當拖放過程進入不同階段時的事件。本例只關心drop()方法,即當在放置目標組件上放開鼠標時的事件處理,一般用來處理傳遞到的數據,如本例中將在JTextField 組件上顯示傳遞來的文本數據,其他方法為空方法,具體代碼如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
public void drop(DropTargetDropEvent dtde) { //throw new java.lang.UnsupportedOperationException("Method drop() not yet implemented."); try { Transferable tr = dtde.getTransferable(); //得到傳遞來的數據對象 //處理數據對象,得到其中的文本信息 if (dtde.isDataFlavorSupported(DataFlavor.stringFlavor)){ dtde.acceptDrop(dtde.getDropAction()); String s = (String) tr.getTransferData(DataFlavor.stringFlavor); this .jTextField1.setText( this .jTextField1.getText()+s); //在放置目標上顯示從拖拽源傳遞來的文本信息 dtde.dropComplete( true ); } else { dtde.rejectDrop(); } } catch (Exception err){ err.printStackTrace(); } } |
程序代碼:
1.新建一個Project,取名為JDragAndDropDemo。
2.新建一個Application,取名為JDragAndDropDemo;主窗口取名為MainFrame,標題為JDragAndDropDemo。
3.新建一個Class,取名為DragJLabel,繼承JLabel 類。
4.利用wizards|implements interface 使DragJLabel 類實現DragGestureListener 、DragSourceListener 接口。
5.在類DragJLabel 中添加新的屬性 DragSource ds,代碼如下:
1
2
3
4
|
class DragJLabel extends JLabel implements DragGestureListener, DragSourceListener { DragSource ds = DragSource.getDefaultDragSource(); //創建DragSource 實例 …… } |
6.編寫DragJLabel 類的構造方法。
1
2
3
4
5
|
public DragJLabel(String title, int alignment){ super (title,alignment); //使用父類的方法 int action = DnDConstants.ACTION_COPY_OR_MOVE; ds.createDefaultDragGestureRecognizer( this ,action, this ); //創建 } |
7.實現DragJLabel 類中的dragGestureRecognized()方法,包裝并發送數據。
1
2
3
4
5
6
7
8
9
|
public void dragGestureRecognized(DragGestureEvent dge) { //throw new java.lang.UnsupportedOperationException("Method dragGestureRecognized() not yet implemented."); try { Transferable tr = new StringSelection( this .getText()); dge.startDrag(DragSource.DefaultCopyNoDrop,tr, this ); } catch (Exception err){ err.printStackTrace(); } } |
8.實現DragJLabel 類中的dragEnter()方法,設置光標的形狀。
1
2
3
4
5
6
7
8
9
|
public void dragEnter(DragSourceDragEvent dsde) { //throw new java.lang.UnsupportedOperationException("Method dragEnter() not yet implemented."); DragSourceContext dsc = dsde.getDragSourceContext(); int action = dsde.getDropAction(); if ((action&DnDConstants.ACTION_COPY)!= 0 ) dsc.setCursor(DragSource.DefaultCopyDrop); else dsc.setCursor(DragSource.DefaultCopyNoDrop); } |
9.在MainFrame 類的設計窗口中下部添加一個JTextField 組件,并在類中創建一個DragJLabel實例,具體代碼如下:
1
2
3
4
5
6
7
|
public class MainFrame extends JFrame implements DropTargetListener { private JPanel contentPane; private BorderLayout borderLayout1 = new BorderLayout(); private JTextField jTextField1 = new JTextField(); DragJLabel label = new DragJLabel( "Hello World !" ,SwingConstants.CENTER); …… } |
10.編寫MainFrame 類的初始化方法jbInit(),設置組件的初始屬性,并創建一個新的DropTarget實例,代碼如下:
1
2
3
4
5
6
7
8
9
10
11
|
private void jbInit() throws Exception { //setIconImage(Toolkit.getDefaultToolkit().createImage(MainFrame.class.getResource("[Your Icon]"))); contentPane = (JPanel) this .getContentPane(); contentPane.setLayout(borderLayout1); this .setSize( new Dimension( 410 , 114 )); this .setTitle( "JDragAndDropDemo" ); jTextField1.setFont( new java.awt.Font( "Dialog" , 0 , 14 )); contentPane.add(jTextField1, BorderLayout.SOUTH); contentPane.add( this .label,BorderLayout.NORTH); new DropTarget( this .jTextField1,DnDConstants.ACTION_COPY_OR_MOVE, this ); } |
11.利用wizards|implements interface 使MainFrame 類實現DropTargetListener 接口。
12.實現繼承自DropTargetListener 接口的方法drop(),處理傳遞來的數據,具體代碼如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
public void drop(DropTargetDropEvent dtde) { //throw new java.lang.UnsupportedOperationException("Method drop() not yet implemented."); try { Transferable tr = dtde.getTransferable(); if (dtde.isDataFlavorSupported(DataFlavor.stringFlavor)){ dtde.acceptDrop(dtde.getDropAction()); String s = (String) tr.getTransferData(DataFlavor.stringFlavor); this .jTextField1.setText( this .jTextField1.getText()+s); dtde.dropComplete( true ); } else { dtde.rejectDrop(); } } catch (Exception err){ err.printStackTrace(); } } |