Package jmri.util.datatransfer

Class RosterEntrySelection

java.lang.Object

jmri.util.datatransfer.RosterEntrySelection

All Implemented Interfaces:

ClipboardOwner, Transferable

public class RosterEntrySelection
extends Object
implements Transferable, ClipboardOwner

Transfer roster entries either via drag-and-drop or via the clipboard.

Note that roster entries can only be transfered within a single JVM instance, and cannot be shared between programs via this mechanism.

This file is part of JMRI.

JMRI is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation. See the "COPYING" file for a copy of this license.

JMRI is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Field Summary

Fields

Modifier and Type	Field	Description
static final DataFlavor	rosterEntryFlavor

Constructor Summary

Constructors

Constructor	Description
RosterEntrySelection(ArrayList<String> rosterEntries)	Create the transferable.

Method Summary

Modifier and Type	Method	Description
static RosterEntrySelection	createRosterEntrySelection(ArrayList<RosterEntry> rosterEntries)	Create a transferable with a list of RosterEntries.
static ArrayList<RosterEntry>	getRosterEntries(Transferable t)	Get an ArrayList of RosterEntries from a RosterEntrySelection.
Object	getTransferData(DataFlavor df)
DataFlavor[]	getTransferDataFlavors()
boolean	isDataFlavorSupported(DataFlavor df)
void	lostOwnership(Clipboard clpbrd, Transferable t)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

rosterEntryFlavor

public static final DataFlavor rosterEntryFlavor

Constructor Details

RosterEntrySelection

public RosterEntrySelection(ArrayList<String> rosterEntries)

Create the transferable.

Takes as a parameter an ArrayList containing Strings representing RosterEntry Ids.

Parameters:

rosterEntries - an ArrayList of RosterEntry Ids

Method Details

createRosterEntrySelection

public static RosterEntrySelection createRosterEntrySelection(ArrayList<RosterEntry> rosterEntries)

Create a transferable with a list of RosterEntries.

Parameters:

rosterEntries - entries to include in the selection

Returns:

a new selection with the given entries

getTransferDataFlavors

public DataFlavor[] getTransferDataFlavors()

Specified by:

getTransferDataFlavors in interface Transferable

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor df)

Specified by:

isDataFlavorSupported in interface Transferable

getTransferData

public Object getTransferData(DataFlavor df)
                       throws UnsupportedFlavorException,
IOException

Specified by:

getTransferData in interface Transferable

Throws:

UnsupportedFlavorException

IOException

lostOwnership

public void lostOwnership(Clipboard clpbrd,
 Transferable t)

Specified by:

lostOwnership in interface ClipboardOwner

getRosterEntries

public static ArrayList<RosterEntry> getRosterEntries(Transferable t)
                                               throws UnsupportedFlavorException,
IOException

Get an ArrayList of RosterEntries from a RosterEntrySelection.

Parameters:

t - a Transferable object. This should be a RosterEntrySelection, but for simplicity, will accept any Transferable object.

Returns:

the transfered roster entries

Throws:

UnsupportedFlavorException - if the transferable is incorrect

IOException - if unable to transfer the entries