FlavorTable (Java 2 Platform SE 5.0) (original) (raw)

java.awt.datatransfer

Interface FlavorTable

All Superinterfaces:

All Known Implementing Classes:

public interface FlavorTable

A FlavorMap which relaxes the traditional 1-to-1 restriction of a Map. A flavor is permitted to map to any number of natives, and likewise a native is permitted to map to any number of flavors. FlavorTables need not be symmetric, but typically are.

Since:

1.4

Method Summary
List<DataFlavor>	getFlavorsForNative(String nat) Returns a List of DataFlavors to which the specified String corresponds.
List<String>	getNativesForFlavor(DataFlavor flav) Returns a List of String natives to which the specified DataFlavor corresponds.

Methods inherited from interface java.awt.datatransfer.FlavorMap
getFlavorsForNatives, getNativesForFlavors

Method Detail

getNativesForFlavor

List<String> getNativesForFlavor(DataFlavor flav)

Returns a List of String natives to which the specified DataFlavor corresponds. The List will be sorted from best native to worst. That is, the first native will best reflect data in the specified flavor to the underlying native platform. The returned List is a modifiable copy of thisFlavorTable's internal data. Client code is free to modify the List without affecting this object.

Parameters:

flav - the DataFlavor whose corresponding natives should be returned. If null is specified, all natives currently known to this FlavorTable are returned in a non-deterministic order.

Returns:

a java.util.List of java.lang.String objects which are platform-specific representations of platform- specific data formats

getFlavorsForNative

List<DataFlavor> getFlavorsForNative(String nat)

Returns a List of DataFlavors to which the specified String corresponds. The List will be sorted from best DataFlavor to worst. That is, the firstDataFlavor will best reflect data in the specified native to a Java application. The returned List is a modifiable copy of this FlavorTable's internal data. Client code is free to modify the List without affecting this object.

Parameters:

nat - the native whose corresponding DataFlavors should be returned. If null is specified, allDataFlavors currently known to this FlavorTable are returned in a non-deterministic order.

Returns:

a java.util.List of DataFlavor objects into which platform-specific data in the specified, platform-specific native can be translated

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.