本文实例讲述了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(); } } |