JavaTM 2 Platform
Standard Ed. 5.0

类 java.awt.datatransfer.DataFlavor
的使用

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

java.awt.datatransferDataFlavor 的使用
 

声明为 DataFlavorjava.awt.datatransfer 中的字段
static DataFlavor DataFlavor.imageFlavor
          DataFlavor 表示 Java Image 类,其中: representationClass = java.awt.Image mimeType = "image/x-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 类,其中: representationClass = java.lang.String mimeType = "application/x-java-serialized-object"
 

返回 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[] Transferable.getTransferDataFlavors()
          返回 DataFlavor 对象的数组,指示可用于提供数据的 flavor。
 DataFlavor[] StringSelection.getTransferDataFlavors()
          返回 flavor 的数组,Transferable 可用该 flavor 提供数据。
static DataFlavor DataFlavor.selectBestTextFlavor(DataFlavor[] availableFlavors)
          从 DataFlavor 的数组中选择最佳文本 DataFlavor
 

返回变量类型为 DataFlavor 的类型的 java.awt.datatransfer 中的方法
 List<DataFlavor> FlavorTable.getFlavorsForNative(String nat)
          返回与指定 String 对应的 DataFlavorList
 List<DataFlavor> SystemFlavorMap.getFlavorsForNative(String nat)
          返回数据传输子系统可以将指定 String native 转换成的 DataFlavorList
 Map<String,DataFlavor> FlavorMap.getFlavorsForNatives(String[] natives)
          返回指定 String native 到其相应 DataFlavorMap
 Map<String,DataFlavor> SystemFlavorMap.getFlavorsForNatives(String[] natives)
          返回指定 String native 到其大多数首选 DataFlavorMap
 Map<DataFlavor,String> FlavorMap.getNativesForFlavors(DataFlavor[] flavors)
          返回指定 DataFlavor 到其对应的 String native 的 Map
 Map<DataFlavor,String> SystemFlavorMap.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> FlavorTable.getNativesForFlavor(DataFlavor flav)
          返回与指定 DataFlavor 对应的 String native 的 List
 List<String> SystemFlavorMap.getNativesForFlavor(DataFlavor flav)
          返回数据传输子系统可以将指定 DataFlavor 转换成的 String native 的 List
 Map<DataFlavor,String> FlavorMap.getNativesForFlavors(DataFlavor[] flavors)
          返回指定 DataFlavor 到其对应的 String native 的 Map
 Map<DataFlavor,String> SystemFlavorMap.getNativesForFlavors(DataFlavor[] flavors)
          返回指定 DataFlavor 到其大多数首选的 String native 的 Map
 Object Transferable.getTransferData(DataFlavor flavor)
          返回一个对象,该对象表示将要被传输的数据。
 Object StringSelection.getTransferData(DataFlavor flavor)
          如果可能,则使用请求的 DataFlavor 返回 Transferable 的数据。
 boolean Clipboard.isDataFlavorAvailable(DataFlavor flavor)
          返回是否能够以指定的 DataFlavor 形式提供此剪贴板的当前内容。
 boolean Transferable.isDataFlavorSupported(DataFlavor flavor)
          返回此对象是否支持指定的数据 flavor。
 boolean StringSelection.isDataFlavorSupported(DataFlavor flavor)
          返回所请求的 flavor 是否受此 Transferable 支持。
 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 中的方法
protected  DataFlavor[] DropTargetContext.getCurrentDataFlavors()
          获得此操作的 Transferable 操作数的可用 DataFlavor。
 DataFlavor[] DropTargetDropEvent.getCurrentDataFlavors()
          此方法返回当前的 DataFlavor。
 DataFlavor[] DropTargetDragEvent.getCurrentDataFlavors()
          此方法返回来自 DropTargetContext 的当前 DataFlavor
 DataFlavor[] DropTargetContext.TransferableProxy.getTransferDataFlavors()
          返回一个 DataFlavor 对象数组,指示该数据的 flavor 是否可由封装的 transferable 提供。
 

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

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

javax.accessibilityDataFlavor 的使用
 

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

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

javax.swingDataFlavor 的使用
 

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


JavaTM 2 Platform
Standard Ed. 5.0

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

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