ClipData クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クリップボード上のクリップされたデータの表現。
[Android.Runtime.Register("android/content/ClipData", DoNotGenerateAcw=true)]
public class ClipData : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/content/ClipData", DoNotGenerateAcw=true)>]
type ClipData = class
inherit Object
interface IParcelable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 継承
- 属性
- 実装
注釈
クリップボード上のクリップされたデータの表現。
ClipData は、1 つ以上の Item インスタンスを含む複合型であり、それぞれがデータのアイテムの 1 つ以上の表現を保持できます。 ユーザーに表示するために、ラベルも含まれます。
ClipData には、クリップに ClipDescription
関する重要なメタデータを記述する が含まれています。 具体的には、 ClipDescription#getMimeType(int) getDescription().getMimeType(int)
クリップ内のデータを記述する正しい MIME の種類を返す必要があります。 適切な MIME の種類でクリップを正しく作成する方法については、、#newUri(ContentResolver, CharSequence, Uri)
、および #newIntent(CharSequence, Intent)
を使用#newPlainText(CharSequence, CharSequence)
します。
各 Item インスタンスには、テキストの単純な CharSequence、単一の Intent オブジェクト、または Uri の 3 つのメイン クラスの 1 つを指定できます。 詳細については、 Item
をご覧ください。
<div class="special reference"><h3>Developer Guides</h3>
クリップボード フレームワークの使用の詳細については、「 コピーと貼り付けの 開発者ガイド」を参照してください。
</部>
"ImplementingPaste"><h3>Implementing Paste or Drop</h3>
ClipData オブジェクトの貼り付けまたはドロップをアプリケーションに実装するには、アプリケーションで使用するデータを正しく解釈する必要があります。 Item
含まれているが単純なテキストまたは意図の場合、ほとんど行う必要はありません。テキストはテキストとしてのみ解釈でき、インテントは通常、ショートカット (ホーム画面にアイコンを配置するなど) やその他のアクションを作成するために使用されます。
クリップされたデータのテキスト表現が必要な場合は、便利な メソッド Item#coerceToText Item.coerceToText
を使用できます。 この場合、通常は、 によって ClipDescription#getMimeType(int) getDescription().getMimeType(int)
報告される MIME の種類について心配する必要はありません。これは、任意のクリップ項目を常に文字列に変換できるためです。
より複雑な交換は、URI、特に "content:" URI を介して行われます。 コンテンツ URI を使用すると、ClipData アイテムの受信者は、そのデータの転送をネゴシエートするために、データを保持している ContentProvider と密接に対話できます。 クリップには、使用可能な MIME の種類も入力する必要があります。 #newUri(ContentResolver, CharSequence, Uri)
は、これを正しく行う処理を行います。
たとえば、単純な NotePad アプリケーションの貼り付け関数を次に示します。 クリップボードからデータを取得する場合は、次の 2 つの操作を実行できます。クリップボードに既存のノートへの URI 参照が含まれている場合は、ノートの構造全体が新しいノートにコピーされます。それ以外の場合は、単にクリップをテキストに強制し、それを新しいノートの内容として使用します。
{
の android.content.ClipData
Java ドキュメント。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。
コンストラクター
ClipData(ClipData) |
別のクリップのコピーである新しいクリップを作成します。 |
ClipData(ClipDescription, ClipData+Item) |
別のクリップのコピーである新しいクリップを作成します。 |
ClipData(ICharSequence, String[], ClipData+Item) |
別のクリップのコピーである新しいクリップを作成します。 |
ClipData(IntPtr, JniHandleOwnership) |
JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。 |
ClipData(String, String[], ClipData+Item) |
新しいクリップを作成します。 |
プロパティ
Class |
この |
Creator | |
Description |
このデータに関連付けられている を |
Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
ItemCount |
クリップ データ内の項目数を返します。 |
JniIdentityHashCode |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
JniPeerMembers |
クリップボード上のクリップされたデータの表現。 |
PeerReference |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
ThresholdClass |
この API は Mono for Android インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
ThresholdType |
この API は Mono for Android インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
メソッド
AddItem(ClipData+Item) |
ClipData コンテナー全体に新しい項目を追加します。 |
AddItem(ContentResolver, ClipData+Item) |
ClipData コンテナー全体に新しい項目を追加します。 |
Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
DescribeContents() |
このパーセルのマーシャリング表現に含まれる特殊なオブジェクトの種類について説明します。 |
Dispose() |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
Dispose(Boolean) |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
GetItemAt(Int32) |
クリップ データ内の 1 つの項目を返します。 |
JavaFinalize() |
オブジェクトへの参照がなくなったとガベージ コレクションが判断したときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
NewHtmlText(ICharSequence, ICharSequence, String) |
型のデータを保持する新しい ClipData を作成します |
NewHtmlText(String, String, String) |
型のデータを保持する新しい ClipData を作成します |
NewIntent(ICharSequence, Intent) |
MIME の種類 が の意図を保持する新しい ClipData を作成します |
NewIntent(String, Intent) |
MIME の種類 が の意図を保持する新しい ClipData を作成します |
NewPlainText(ICharSequence, ICharSequence) |
型のデータを保持する新しい ClipData を作成します |
NewPlainText(String, String) |
型のデータを保持する新しい ClipData を作成します |
NewRawUri(ICharSequence, Uri) |
MIME タイプの URI を保持する新しい ClipData を作成します |
NewRawUri(String, Uri) |
MIME タイプの URI を保持する新しい ClipData を作成します |
NewUri(ContentResolver, ICharSequence, Uri) |
URI を保持する新しい ClipData を作成します。 |
NewUri(ContentResolver, String, Uri) |
URI を保持する新しい ClipData を作成します。 |
Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
ToArray<T>() |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
ToString() |
オブジェクトの文字列形式を返します。 (継承元 Object) |
UnregisterFromRuntime() |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
Wait() |
現在のスレッドが起動するまで待機します。通常<は、通知</em> または>< em 中断</em によって待機します>。> (継承元 Object) |
Wait(Int64) |
現在のスレッドが起動するまで待機します。通常<は、通知></em> または <>em 中断</em>、または特定のリアルタイムが経過するまで待機します。 (継承元 Object) |
Wait(Int64, Int32) |
現在のスレッドが起動するまで待機します。通常<は、通知></em> または <>em 中断</em>、または特定のリアルタイムが経過するまで待機します。 (継承元 Object) |
WriteToParcel(Parcel, ParcelableWriteFlags) |
このオブジェクトをパーセルにフラット化します。 |
明示的なインターフェイスの実装
IJavaPeerable.Disposed() |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
IJavaPeerable.DisposeUnlessReferenced() |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
IJavaPeerable.Finalized() |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
IJavaPeerable.JniManagedPeerState |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
IJavaPeerable.SetPeerReference(JniObjectReference) |
クリップボード上のクリップされたデータの表現。 (継承元 Object) |
拡張メソッド
JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
JavaCast<TResult>(IJavaObject) |
クリップボード上のクリップされたデータの表現。 |
GetJniTypeName(IJavaPeerable) |
クリップボード上のクリップされたデータの表現。 |