JavaTM Platform
Standard Ed. 6

类 java.awt.datatransfer.DataFlavor
的使用

使用 DataFlavor 的软件包
java.awt.datatransfer 提供在应用程序之间和在应用程序内部传输数据的接口和类。 
java.awt.dnd Drag 和 Drop 是一种直接操作动作,在许多图形用户界面系统中都会遇到它,它提供了一种机制,能够在两个与 GUI 中显示元素逻辑相关的实体之间传输信息。 
javax.accessibility 定义了用户界面组件与提供对这些组件进行访问的辅助技术之间的协定。 
javax.activation   
javax.swing 提供一组“轻量级”(全部是 Java 语言)组件,尽量让这些组件在所有平台上的工作方式都相同。 
 

java.awt.datatransferDataFlavor 的使用
 

声明为 DataFlavorjava.awt.datatransfer 中的字段
static DataFlavor DataFlavor.imageFlavor
          DataFlavor 表示 Java Image 类,其中:
static DataFlavor DataFlavor.javaFileListFlavor
          要将文件列表传入 Java(及底层平台)或从中传出,需要使用此类型/子类型的 DataFlavorjava.util.List 的表示形式类。
static DataFlavor DataFlavor.plainTextFlavor
          已过时。 从 1.3 开始。使用 DataFlavor.getReaderForText(Transferable) 代替 Transferable.getTransferData(DataFlavor.plainTextFlavor)
static DataFlavor DataFlavor.stringFlavor
          DataFlavor 表示 Java Unicode String 类,其中:
 

返回 DataFlavorjava.awt.datatransfer 中的方法
static DataFlavor SystemFlavorMap.decodeDataFlavor(String nat)
          解码 String native 以用作 DataFlavor
 DataFlavor[] Clipboard.getAvailableDataFlavors()
          返回 DataFlavor 的数组,其中提供了此剪贴板的当前内容。
static DataFlavor DataFlavor.getTextPlainUnicodeFlavor()
          返回表示具有 Unicode 编码的纯文本的 DataFlavor,其中: representationClass = java.io.InputStream mimeType = "text/plain; charset=<platform default Unicode encoding>" Sun 的 Microsoft Windows 实现使用编码 utf-16le
 DataFlavor[] StringSelection.getTransferDataFlavors()
          返回 flavor 的数组,Transferable 可用该 flavor 提供数据。
 DataFlavor[] Transferable.getTransferDataFlavors()
          返回 DataFlavor 对象的数组,指示可用于提供数据的 flavor。
static DataFlavor DataFlavor.selectBestTextFlavor(DataFlavor[] availableFlavors)
          从 DataFlavor 数组中选择最佳文本 DataFlavor
 

返回变量类型为 DataFlavor 的类型的 java.awt.datatransfer 中的方法
 List<DataFlavor> SystemFlavorMap.getFlavorsForNative(String nat)
          返回数据传输子系统可以将指定 String native 转换成的 DataFlavorList
 List<DataFlavor> FlavorTable.getFlavorsForNative(String nat)
          返回与指定 String 对应的 DataFlavorList
 Map<String,DataFlavor> SystemFlavorMap.getFlavorsForNatives(String[] natives)
          返回指定 String native 到其大多数首选 DataFlavorMap
 Map<String,DataFlavor> FlavorMap.getFlavorsForNatives(String[] natives)
          返回指定 String native 到其相应 DataFlavorMap
 Map<DataFlavor,String> SystemFlavorMap.getNativesForFlavors(DataFlavor[] flavors)
          返回指定 DataFlavor 到其大多数首选的 String native 的 Map
 Map<DataFlavor,String> FlavorMap.getNativesForFlavors(DataFlavor[] flavors)
          返回指定 DataFlavor 到其对应的 String native 的 Map
 

参数类型为 DataFlavorjava.awt.datatransfer 中的方法
 void SystemFlavorMap.addFlavorForUnencodedNative(String nat, DataFlavor flav)
          添加从单个 String native 到单个 DataFlavor 的映射。
 void SystemFlavorMap.addUnencodedNativeForFlavor(DataFlavor flav, String nat)
          添加从指定的 DataFlavor(和等于指定 DataFlavor 的所有 DataFlavor)到指定 String native 的映射。
static String SystemFlavorMap.encodeDataFlavor(DataFlavor flav)
          编码 DataFlavor 以用作 String native。
 boolean DataFlavor.equals(DataFlavor that)
          测试 DataFlavor 与此 DataFlavor 的相等性。
 Object Clipboard.getData(DataFlavor flavor)
          返回一个对象,表示此剪贴板中指定 DataFlavor 类型的当前内容。
 List<String> SystemFlavorMap.getNativesForFlavor(DataFlavor flav)
          返回数据传输子系统可以将指定 DataFlavor 转换成的 String native 的 List
 List<String> FlavorTable.getNativesForFlavor(DataFlavor flav)
          返回与指定 DataFlavor 对应的 String native 的 List
 Map<DataFlavor,String> SystemFlavorMap.getNativesForFlavors(DataFlavor[] flavors)
          返回指定 DataFlavor 到其大多数首选的 String native 的 Map
 Map<DataFlavor,String> FlavorMap.getNativesForFlavors(DataFlavor[] flavors)
          返回指定 DataFlavor 到其对应的 String native 的 Map
 Object StringSelection.getTransferData(DataFlavor flavor)
          如果可能,则使用请求的 DataFlavor 返回 Transferable 的数据。
 Object Transferable.getTransferData(DataFlavor flavor)
          返回一个对象,该对象表示将要被传输的数据。
 boolean Clipboard.isDataFlavorAvailable(DataFlavor flavor)
          返回是否能够以指定的 DataFlavor 形式提供此剪贴板的当前内容。
 boolean StringSelection.isDataFlavorSupported(DataFlavor flavor)
          返回所请求的 flavor 是否受此 Transferable 支持。
 boolean Transferable.isDataFlavorSupported(DataFlavor flavor)
          返回此对象是否支持指定的数据 flavor。
 boolean DataFlavor.isMimeTypeEqual(DataFlavor dataFlavor)
          比较两个 DataFlavor 对象的 mimeType
 boolean DataFlavor.match(DataFlavor that)
          测试 DataFlavor 与此 DataFlavor 的相等性。
static DataFlavor DataFlavor.selectBestTextFlavor(DataFlavor[] availableFlavors)
          从 DataFlavor 数组中选择最佳文本 DataFlavor
 void SystemFlavorMap.setFlavorsForNative(String nat, DataFlavor[] flavors)
          放弃指定 String native 的当前映射,而创建指定 DataFlavor 的新映射。
 void SystemFlavorMap.setNativesForFlavor(DataFlavor flav, String[] natives)
          放弃指定 DataFlavor 和等于指定 DataFlavor 的所有 DataFlavor 的当前映射,并创建到指定 String native 的新映射。
 

参数类型为 DataFlavorjava.awt.datatransfer 中的构造方法
UnsupportedFlavorException(DataFlavor flavor)
          构造一个 UnsupportedFlavorException。
 

java.awt.dndDataFlavor 的使用
 

返回 DataFlavorjava.awt.dnd 中的方法
 DataFlavor[] DropTargetDragEvent.getCurrentDataFlavors()
          此方法返回来自 DropTargetContext 的当前 DataFlavor
 DataFlavor[] DropTargetDropEvent.getCurrentDataFlavors()
          此方法返回当前的 DataFlavor。
protected  DataFlavor[] DropTargetContext.getCurrentDataFlavors()
          获取此操作的 Transferable 操作数的可用 DataFlavor。
 DataFlavor[] DropTargetContext.TransferableProxy.getTransferDataFlavors()
          返回一个 DataFlavor 对象数组,指示该数据的 flavor 是否可由封装的 transferable 提供。
 

返回变量类型为 DataFlavor 的类型的 java.awt.dnd 中的方法
 List<DataFlavor> DropTargetDragEvent.getCurrentDataFlavorsAsList()
          此方法以 java.util.List 形式返回当前的 DataFlavor
 List<DataFlavor> DropTargetDropEvent.getCurrentDataFlavorsAsList()
          此方法以 java.util.List 形式返回当前可用的 DataFlavor
protected  List<DataFlavor> DropTargetContext.getCurrentDataFlavorsAsList()
          此方法返回 Transferable 操作数当前可用的 DataFlavor,作为一个 java.util.List
 

参数类型为 DataFlavorjava.awt.dnd 中的方法
 Object DropTargetContext.TransferableProxy.getTransferData(DataFlavor df)
          返回一个对象,该对象表示数据是由封装的 transferable 为所请求的数据 flavor 提供的。
 boolean DropTargetDragEvent.isDataFlavorSupported(DataFlavor df)
          此方法返回一个指示指定的 DataFlavor 是否受支持 boolean 值。
 boolean DropTargetDropEvent.isDataFlavorSupported(DataFlavor df)
          此方法返回一个指示指定的 DataFlavor 是否可在源对象中使用的 boolean 值。
protected  boolean DropTargetContext.isDataFlavorSupported(DataFlavor df)
          此方法返回一个 boolean 值,指示给定的 DataFlavor 是否受此 DropTargetContext 支持。
 boolean DropTargetContext.TransferableProxy.isDataFlavorSupported(DataFlavor flavor)
          返回指定的数据 flavor 是否受封装的 transferable 支持。
 

javax.accessibilityDataFlavor 的使用
 

返回 DataFlavorjavax.accessibility 中的方法
 DataFlavor[] AccessibleStreamable.getMimeTypes()
          返回此对象所支持的 MIME 类型的 DataFlavor 对象数组。
 

参数类型为 DataFlavorjavax.accessibility 中的方法
 InputStream AccessibleStreamable.getStream(DataFlavor flavor)
          返回 DataFlavor 的 InputStream
 

javax.activationDataFlavor 的使用
 

javax.activationDataFlavor 的子类
 class ActivationDataFlavor
          ActivationDataFlavor 类是 java.awt.datatransfer.DataFlavor 的一个特殊子类。
 

返回 DataFlavorjavax.activation 中的方法
 DataFlavor[] DataContentHandler.getTransferDataFlavors()
          返回一个 DataFlavor 对象数组,这些对象指示可用于提供数据的 flavor。
 DataFlavor[] DataHandler.getTransferDataFlavors()
          返回此数据在其中可用的 DataFlavor。
 

参数类型为 DataFlavorjavax.activation 中的方法
 boolean ActivationDataFlavor.equals(DataFlavor dataFlavor)
          将传入的 DataFlavor 与此 DataFlavor 进行比较;调用 isMimeTypeEqual 方法。
 Object DataHandler.getTransferData(DataFlavor flavor)
          返回一个对象,该对象表示要传输的数据。
 Object DataContentHandler.getTransferData(DataFlavor df, DataSource ds)
          返回一个对象,该对象表示将要传输的数据。
 boolean DataHandler.isDataFlavorSupported(DataFlavor flavor)
          返回此对象是否支持指定的数据 flavor。
 

javax.swingDataFlavor 的使用
 

返回 DataFlavorjavax.swing 中的方法
 DataFlavor[] TransferHandler.TransferSupport.getDataFlavors()
          返回此传输的数据 flavor。
 

参数类型为 DataFlavorjavax.swing 中的方法
 boolean TransferHandler.canImport(JComponent comp, DataFlavor[] transferFlavors)
          指示一个组件在实际尝试导入给定数据 flavor 的集合之前是否接受其导入。
 boolean TransferHandler.TransferSupport.isDataFlavorSupported(DataFlavor df)
          返回是否支持给定的数据 flavor。
 


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策