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 タイプでクリップを正しく構築する方法については、 #newPlainText(CharSequence, CharSequence)、 #newUri(ContentResolver, CharSequence, Uri)、 #newIntent(CharSequence, Intent)を使用してください。
各 Item インスタンスには、テキストの単純な CharSequence、単一の Intent オブジェクト、または Uri という 3 つの主要なデータ クラスのいずれかを指定できます。 詳細については、 Item をご覧ください。
<div class="special reference"><h3>Developer Guides</h3>
クリップボード フレームワークの使用方法の詳細については、「 コピーと貼り付けの 開発者ガイド」を参照してください。
</部>
"ImplementingPaste"><h3>貼り付けまたはドロップの実装</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 参照が含まれている場合は、ノートの構造全体が新しいノートにコピーされます。それ以外の場合は、単にクリップをテキストに強制し、それを新しいノートの内容として使用します。
{
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
コンストラクター
| 名前 | 説明 |
|---|---|
| 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 は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
| ThresholdType |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
メソッド
| 名前 | 説明 |
|---|---|
| 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) |
|
| NewHtmlText(String, String, String) |
|
| NewIntent(ICharSequence, Intent) |
MIME の種類が |
| NewIntent(String, Intent) |
MIME の種類が |
| NewPlainText(ICharSequence, ICharSequence) |
|
| NewPlainText(String, String) |
|
| NewRawUri(ICharSequence, Uri) |
MIME の種類が |
| NewRawUri(String, Uri) |
MIME の種類が |
| 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>notified</em> または <em>interrupted</em>。 (継承元 Object) |
| Wait(Int64, Int32) |
現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object) |
| Wait(Int64) |
現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</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) |
拡張メソッド
| 名前 | 説明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
インスタンス |
| JavaAs<TResult>(IJavaPeerable) |
|
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
クリップボード上のクリップされたデータの表現。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
|