/** * Copyright (c) 2010, The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.content; import android.os.Parcel; import android.os.Parcelable; import android.os.PersistableBundle; import android.text.TextUtils; import java.util.ArrayList; /** * Meta-data describing the contents of a {@link ClipData}. Provides enough * information to know if you can handle the ClipData, but not the data * itself. * *
For more information about using the clipboard framework, read the * Copy and Paste * developer guide.
** Type: String *
** Use {@link ComponentName#unflattenFromString(String)} * and {@link ComponentName#flattenToString()} to convert the extra value * to/from {@link ComponentName}. *
* @hide */ public static final String EXTRA_TARGET_COMPONENT_NAME = "android.content.extra.TARGET_COMPONENT_NAME"; /** * The name of the extra used to define a user serial number when copying/dragging * an app icon from Launcher. ** Type: long *
* @hide */ public static final String EXTRA_USER_SERIAL_NUMBER = "android.content.extra.USER_SERIAL_NUMBER"; final CharSequence mLabel; final String[] mMimeTypes; private PersistableBundle mExtras; /** * Create a new clip. * * @param label Label to show to the user describing this clip. * @param mimeTypes An array of MIME types this data is available as. */ public ClipDescription(CharSequence label, String[] mimeTypes) { if (mimeTypes == null) { throw new NullPointerException("mimeTypes is null"); } mLabel = label; mMimeTypes = mimeTypes; } /** * Create a copy of a ClipDescription. */ public ClipDescription(ClipDescription o) { mLabel = o.mLabel; mMimeTypes = o.mMimeTypes; } /** * Helper to compare two MIME types, where one may be a pattern. * @param concreteType A fully-specified MIME type. * @param desiredType A desired MIME type that may be a pattern such as */*. * @return Returns true if the two MIME types match. */ public static boolean compareMimeTypes(String concreteType, String desiredType) { final int typeLength = desiredType.length(); if (typeLength == 3 && desiredType.equals("*/*")) { return true; } final int slashpos = desiredType.indexOf('/'); if (slashpos > 0) { if (typeLength == slashpos+2 && desiredType.charAt(slashpos+1) == '*') { if (desiredType.regionMatches(0, concreteType, 0, slashpos+1)) { return true; } } else if (desiredType.equals(concreteType)) { return true; } } return false; } /** * Return the label for this clip. */ public CharSequence getLabel() { return mLabel; } /** * Check whether the clip description contains the given MIME type. * * @param mimeType The desired MIME type. May be a pattern. * @return Returns true if one of the MIME types in the clip description * matches the desired MIME type, else false. */ public boolean hasMimeType(String mimeType) { for (int i=0; i