public final class SystemFlavorMap extends Object implements FlavorMap, FlavorTable
修飾子と型 | メソッド | 説明 |
---|---|---|
void |
addFlavorForUnencodedNative(String nat, DataFlavor flav) |
1つの
String ネイティブから1つのDataFlavor へのマッピングを追加します。 |
void |
addUnencodedNativeForFlavor(DataFlavor flav, String nat) |
指定された
DataFlavor (および指定されたDataFlavor に等しいすべてのDataFlavor )から指定されたString ネイティブへのマッピングを追加します。 |
static DataFlavor |
decodeDataFlavor(String nat) |
DataFlavor として使用するためにString ネイティブをデコードします。 |
static String |
decodeJavaMIMEType(String nat) |
Java MIMEタイプとして使用するために
String ネイティブをデコードします。 |
static String |
encodeDataFlavor(DataFlavor flav) |
String ネイティブとして使用するためにDataFlavor をエンコードします。 |
static String |
encodeJavaMIMEType(String mimeType) |
String ネイティブとして使用するためにMIMEタイプをエンコードします。 |
static FlavorMap |
getDefaultFlavorMap() |
このスレッドのClassLoaderの、デフォルトのFlavorMapを返します。
|
List<DataFlavor> |
getFlavorsForNative(String nat) |
指定された
String ネイティブのデータ転送サブシステムによる変換の宛先にすることのできるDataFlavor のList を返します。 |
Map<String,DataFlavor> |
getFlavorsForNatives(String[] natives) |
指定された
String ネイティブの、そのもっとも適切なDataFlavor へのMap を返します。 |
List<String> |
getNativesForFlavor(DataFlavor flav) |
指定された
DataFlavor のデータ転送サブシステムによる変換の宛先にすることのできるString ネイティブのList を返します。 |
Map<DataFlavor,String> |
getNativesForFlavors(DataFlavor[] flavors) |
指定された
DataFlavor の、そのもっとも適切なString ネイティブへのMap を返します。 |
static boolean |
isJavaMIMEType(String str) |
指定された
String がエンコードされたJava MIMEタイプであるかどうかを返します。 |
void |
setFlavorsForNative(String nat, DataFlavor[] flavors) |
指定された
String ネイティブの現在のマッピングを破棄し、指定されたDataFlavor への新しいマッピングを作成します。 |
void |
setNativesForFlavor(DataFlavor flav, String[] natives) |
指定された
DataFlavor 、および指定されたDataFlavor に等しいすべてのDataFlavor の現在のマッピングを破棄し、指定されたString ネイティブへの新しいマッピングを作成します。 |
public static FlavorMap getDefaultFlavorMap()
public List<String> getNativesForFlavor(DataFlavor flav)
DataFlavor
のデータ転送サブシステムによる変換の宛先にすることのできるString
ネイティブのList
を返します。 List
は、もっとも適しているネイティブからもっとも適していないものの順にソートされます。 つまり、基本となるネイティブ・プラット・フォームに指定されたフレーバのデータをもっともよく反映するのは、最初のネイティブということになります。
指定されたDataFlavor
が以前にデータ転送サブシステムに認識されておらず、データ転送サブシステムがこのDataFlavor
を既存のネイティブに変換できない場合は、このメソッドを呼び出すと、指定されたDataFlavor
と、そのMIMEタイプのネイティブとしてエンコードされたバージョンの間の双方向のマッピングが確立されます。
getNativesForFlavor
、インタフェースFlavorTable
flav
- 対応するネイティブが返されるDataFlavor
。 null
が指定されている場合は、現在データ転送サブシステムに認識されているすべてのネイティブが順序不定で返される。 java.lang.String
オブジェクトのjava.util.List
encodeDataFlavor(java.awt.datatransfer.DataFlavor)
public List<DataFlavor> getFlavorsForNative(String nat)
String
ネイティブのデータ転送サブシステムによる変換の宛先にすることのできるDataFlavor
のList
を返します。 List
は、もっとも適しているDataFlavor
からもっとも適していないものの順にソートされます。 つまり、最初のDataFlavor
が、Javaアプリケーションに指定されたネイティブ内のデータをもっともよく反映しています。
指定されたネイティブが以前にデータ転送サブシステムに認識されておらず、そのネイティブが適切にエンコードされている場合は、このメソッドを呼び出すと、指定されたネイティブと、デコードされたバージョンのネイティブをMIMEタイプとして持つDataFlavor
の間の双方向のマッピングが確立されます。
指定されたネイティブが適切にエンコードされたネイティブではなく、このネイティブのマッピングがsetFlavorsForNative
によって変更されていない場合、List
の内容はプラットフォームに依存しますが、null
を返すことはできません。
getFlavorsForNative
、インタフェースFlavorTable
nat
- 対応するDataFlavor
が返されるネイティブ。 null
が指定されている場合は、現在データ転送サブシステムに認識されているすべてのDataFlavor
が順序不定で返される。 DataFlavor
オブジェクトのjava.util.List
encodeJavaMIMEType(java.lang.String)
public Map<DataFlavor,String> getNativesForFlavors(DataFlavor[] flavors)
DataFlavor
の、そのもっとも適切なString
ネイティブへのMap
を返します。 各ネイティブ値は、指定されたフレーバに対してgetNativesForFlavor
が返すリスト内の最初のネイティブと同じになります。
指定されたDataFlavor
が以前にデータ転送サブシステムに認識されていない場合は、このメソッドを呼び出すと、指定されたDataFlavor
と、そのMIMEタイプをネイティブとしてエンコードしたものとの間で、双方向のマッピングが確立されます。
getNativesForFlavors
、インタフェースFlavorMap
flavors
- 返されたMap
のキー・セットになるDataFlavor
の配列。 null
が指定されている場合は、データ転送サブシステムに認識されているすべてのDataFlavor
から、そのもっとも適切なString
ネイティブへのマッピングが返される。 DataFlavor
からString
ネイティブへのjava.util.Map
getNativesForFlavor(java.awt.datatransfer.DataFlavor)
, encodeDataFlavor(java.awt.datatransfer.DataFlavor)
public Map<String,DataFlavor> getFlavorsForNatives(String[] natives)
String
ネイティブの、そのもっとも適切なDataFlavor
へのMap
を返します。 各DataFlavor
値は、指定されたネイティブに対してgetFlavorsForNative
によって返されるリスト内の最初のDataFlavor
と同じになります。
指定されたネイティブが以前にデータ転送サブシステムに認識されておらず、そのネイティブが適切にエンコードされている場合は、このメソッドを呼び出すと、指定されたネイティブと、デコードされたバージョンのネイティブをMIMEタイプとして持つDataFlavor
の間の双方向のマッピングが確立されます。
getFlavorsForNatives
、インタフェースFlavorMap
natives
- 返されたMap
のキー・セットになるString
の配列。 null
が指定されている場合は、サポートされるすべてのString
ネイティブから、そのもっとも適切なDataFlavor
へのマッピングが返される。 String
ネイティブからDataFlavor
へのjava.util.Map
getFlavorsForNative(java.lang.String)
, encodeJavaMIMEType(java.lang.String)
public void addUnencodedNativeForFlavor(DataFlavor flav, String nat)
DataFlavor
(および指定されたDataFlavor
に等しいすべてのDataFlavor
)から指定されたString
ネイティブへのマッピングを追加します。 getNativesForFlavor
とは異なり、このマッピングは一方向にのみ確立され、ネイティブはエンコードされません。 双方向のマッピングを確立するには、addFlavorForUnencodedNative
も呼び出します。 新しいマッピングの優先度は、既存のマッピングよりも低くなります。 指定された、または等しいDataFlavor
から、指定されたString
ネイティブへのマッピングがすでに存在する場合は、このメソッドに効果はありません。 flav
- マッピング用のDataFlavor
キーnat
- マッピング用のString
ネイティブ値NullPointerException
- flavまたはnatがnull
の場合addFlavorForUnencodedNative(java.lang.String, java.awt.datatransfer.DataFlavor)
public void setNativesForFlavor(DataFlavor flav, String[] natives)
DataFlavor
、および指定されたDataFlavor
に等しいすべてのDataFlavor
の現在のマッピングを破棄し、指定されたString
ネイティブへの新しいマッピングを作成します。 getNativesForFlavor
とは異なり、このマッピングは一方向にのみ確立され、ネイティブはエンコードされません。 双方向のマッピングを確立するには、setFlavorsForNative
も呼び出します。 配列内の最初のネイティブは、優先度がもっとも高いマッピングを表します。 続くネイティブでは、マッピングの優先度が下がっていきます。
配列に、等しいString
ネイティブを参照する複数の要素が含まれている場合、このメソッドは、これらのうちの最初の要素のための新しいマッピングを確立し、残りの要素を無視します。
データ転送サブシステムが確立したマッピングをクライアント・コードでリセットしないようお薦めします。 このメソッドは、アプリケーション・レベルのマッピングだけに使用します。
flav
- マッピング用のDataFlavor
キーnatives
- マッピング用のString
ネイティブ値NullPointerException
- flavまたはネイティブがnull
の場合、またはネイティブにnull
要素が含まれている場合setFlavorsForNative(java.lang.String, java.awt.datatransfer.DataFlavor[])
public void addFlavorForUnencodedNative(String nat, DataFlavor flav)
String
ネイティブから1つのDataFlavor
へのマッピングを追加します。 getFlavorsForNative
とは異なり、このマッピングは一方向にのみ確立され、ネイティブはエンコードされません。 双方向のマッピングを確立するには、addUnencodedNativeForFlavor
も呼び出します。 新しいマッピングの優先度は、既存のマッピングよりも低くなります。 指定されたString
ネイティブから、指定された、または等しいDataFlavor
へのマッピングがすでに存在する場合は、このメソッドに効果はありません。 nat
- マッピング用のString
ネイティブ・キーflav
- マッピング用のDataFlavor
値NullPointerException
- natまたはflavがnull
の場合addUnencodedNativeForFlavor(java.awt.datatransfer.DataFlavor, java.lang.String)
public void setFlavorsForNative(String nat, DataFlavor[] flavors)
String
ネイティブの現在のマッピングを破棄し、指定されたDataFlavor
への新しいマッピングを作成します。 getFlavorsForNative
とは異なり、このマッピングは一方向にのみ確立され、ネイティブをエンコードする必要はありません。 双方向のマッピングを確立するには、setNativesForFlavor
も呼び出します。 配列内の最初のDataFlavor
は、優先度がもっとも高いマッピングを表します。 以降のDataFlavor
では、マッピングの優先度が下がっていきます。
配列に、等しいDataFlavor
を参照する複数の要素が含まれている場合、このメソッドは、これらのうちの最初の要素のための新しいマッピングを確立し、残りの要素を無視します。
データ転送サブシステムが確立したマッピングをクライアント・コードでリセットしないようお薦めします。 このメソッドは、アプリケーション・レベルのマッピングだけに使用します。
nat
- マッピング用のString
ネイティブ・キーflavors
- マッピング用のDataFlavor
値NullPointerException
- natまたはフレーバがnull
の場合、またはフレーバにnull
要素が含まれている場合setNativesForFlavor(java.awt.datatransfer.DataFlavor, java.lang.String[])
public static String encodeJavaMIMEType(String mimeType)
String
ネイティブとして使用するためにMIMEタイプをエンコードします。 MIMEタイプのエンコードされた表現の形式は、実装に依存します。 制限は次に示すものだけです。
null
になるのは、MIMEタイプString
がnull
の場合だけです。null
以外の2つのMIMEタイプString
のエンコードされた表現が等しいのは、これらのString
がString.equals(Object)
に従って等しい場合だけです。
このメソッドのリファレンス実装では、接頭辞JAVA_DATAFLAVOR:
が付いた指定されたMIMEタイプString
を返します。
mimeType
- エンコードするMIMEタイプString
。mimeTypeがnull
の場合はnull
public static String encodeDataFlavor(DataFlavor flav)
String
ネイティブとして使用するためにDataFlavor
をエンコードします。 エンコードされたDataFlavor
の形式は、実装に依存します。 制限は次に示すものだけです。
null
になるのは、指定されたDataFlavor
がnull
か、またはそのMIMEタイプString
がnull
の場合だけです。null
以外のMIMEタイプString
を持つnull
以外の2つのDataFlavor
のエンコードされた表現が等しいのは、これらのDataFlavor
のMIMEタイプString
がString.equals(Object)
に従って等しい場合だけです。
このメソッドのリファレンス実装では、接頭辞JAVA_DATAFLAVOR:
が付いた指定されたDataFlavor
のMIMEタイプString
を返します。
flav
- エンコードするDataFlavor
String
。flavがnull
か、またはnull
のMIMEタイプを持つ場合はnull
public static boolean isJavaMIMEType(String str)
String
がエンコードされたJava MIMEタイプであるかどうかを返します。str
- テストするString
String
がエンコードされている場合はtrue
。それ以外の場合はfalse
public static String decodeJavaMIMEType(String nat)
String
ネイティブをデコードします。nat
- デコードするString
String
ネイティブでない場合はnull
public static DataFlavor decodeDataFlavor(String nat) throws ClassNotFoundException
DataFlavor
として使用するためにString
ネイティブをデコードします。nat
- デコードするString
DataFlavor
。natがエンコードされたString
ネイティブでない場合はnull
ClassNotFoundException
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。