android_translation_layer/src/api-impl/android/content/ClipboardManager.java

/**
 * 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.app.Activity;
import android.content.Context;
import android.os.Handler;
import android.os.IBinder;
import android.os.Message;
import android.os.RemoteException;
import android.util.Log;
import java.util.ArrayList;

class ClipDescription {}

/**
 * Interface to the clipboard service, for placing and retrieving text in
 * the global clipboard.
 *
 * <p>
 * You do not instantiate this class directly; instead, retrieve it through
 * {@link android.content.Context#getSystemService}.
 *
 * <p>
 * The ClipboardManager API itself is very simple: it consists of methods
 * to atomically get and set the current primary clipboard data.  That data
 * is expressed as a {@link ClipData} object, which defines the protocol
 * for data exchange between applications.
 *
 * <div class="special reference">
 * <h3>Developer Guides</h3>
 * <p>For more information about using the clipboard framework, read the
 * <a href="{@docRoot}guide/topics/clipboard/copy-paste.html">Copy and Paste</a>
 * developer guide.</p>
 * </div>
 *
 * @see android.content.Context#getSystemService
 */
public class ClipboardManager extends android.text.ClipboardManager {
	static final int MSG_REPORT_PRIMARY_CLIP_CHANGED = 1;
	/**
	 * Defines a listener callback that is invoked when the primary clip on the clipboard changes.
	 * Objects that want to register a listener call
	 * {@link android.content.ClipboardManager#addPrimaryClipChangedListener(OnPrimaryClipChangedListener)
	 * addPrimaryClipChangedListener()} with an
	 * object that implements OnPrimaryClipChangedListener.
	 *
	 */
	public interface OnPrimaryClipChangedListener {
		/**
		 * Callback that is invoked by {@link android.content.ClipboardManager} when the primary
		 * clip changes.
		 */
		void onPrimaryClipChanged();
	}
	/**
	 * {@hide}
	 */
	public ClipboardManager(Context context, Handler handler) {
	}
	public ClipboardManager() {
	}
	/**
	 * Sets the current primary clip on the clipboard.  This is the clip that
	 * is involved in normal cut and paste operations.
	 *
	 * @param clip The clipped data item to set.
	 */
	public void setPrimaryClip(ClipData clip) {
		// this is not the primary clipboard in UNIX sense (not middle click paste)
		native_set_clipboard(clip.text);
	}
	/**
	 * Returns the current primary clip on the clipboard.
	 */
	public ClipData getPrimaryClip() {
		return null;
	}
	/**
	 * Returns a description of the current primary clip on the clipboard
	 * but not a copy of its data.
	 */
	public ClipDescription getPrimaryClipDescription() {
		return null;
	}
	/**
	 * Returns true if there is currently a primary clip on the clipboard.
	 */
	public boolean hasPrimaryClip() {
		return false;
	}
	public void addPrimaryClipChangedListener(OnPrimaryClipChangedListener what) {
	}
	public void removePrimaryClipChangedListener(OnPrimaryClipChangedListener what) {
	}
	/**
	 * @deprecated Use {@link #getPrimaryClip()} instead.  This retrieves
	 * the primary clip and tries to coerce it to a string.
	 */
	public CharSequence getText() {
		return null;
	}
	/**
	 * @deprecated Use {@link #setPrimaryClip(ClipData)} instead.  This
	 * creates a ClippedItem holding the given text and sets it as the
	 * primary clip.  It has no label or icon.
	 */
	public void setText(CharSequence text) {
	}
	/**
	 * @deprecated Use {@link #hasPrimaryClip()} instead.
	 */
	public boolean hasText() {
		return false;
	}
	void reportPrimaryClipChanged() {
	}

	public static native void native_set_clipboard(String text);
}