to top
Android APIs
public class

ClipboardManager

extends ClipboardManager
java.lang.Object
   ↳ android.text.ClipboardManager
     ↳ android.content.ClipboardManager

Class Overview

Interface to the clipboard service, for placing and retrieving text in the global clipboard.

You do not instantiate this class directly; instead, retrieve it through getSystemService(String).

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 ClipData object, which defines the protocol for data exchange between applications.

Developer Guides

For more information about using the clipboard framework, read the Copy and Paste developer guide.

Summary

Nested Classes
interface ClipboardManager.OnPrimaryClipChangedListener Defines a listener callback that is invoked when the primary clip on the clipboard changes. 
Public Methods

? Examples
void addPrimaryClipChangedListener( ClipboardManager.OnPrimaryClipChangedListener what)

? Examples
ClipData getPrimaryClip()
Returns the current primary clip on the clipboard.

? Examples
ClipDescription getPrimaryClipDescription()
Returns a description of the current primary clip on the clipboard but not a copy of its data.

? Examples
CharSequence getText()
This method was deprecated in API level 11. Use getPrimaryClip() instead. This retrieves the primary clip and tries to coerce it to a string.

? Examples
boolean hasPrimaryClip()
Returns true if there is currently a primary clip on the clipboard.

? Examples
boolean hasText()
This method was deprecated in API level 11. Use hasPrimaryClip() instead.

? Examples
void removePrimaryClipChangedListener( ClipboardManager.OnPrimaryClipChangedListener what)

? Examples
void setPrimaryClip( ClipData clip)
Sets the current primary clip on the clipboard.

? Examples
void setText( CharSequence text)
This method was deprecated in API level 11. Use setPrimaryClip(ClipData) instead. This creates a ClippedItem holding the given text and sets it as the primary clip. It has no label or icon.
[Expand]
Inherited Methods
From class android.text.ClipboardManager
From class java.lang.Object

Public Methods

public void addPrimaryClipChangedListener (ClipboardManager.OnPrimaryClipChangedListener what)

Added in API level 11

public ClipData getPrimaryClip ()

Added in API level 11

Returns the current primary clip on the clipboard.

public ClipDescription getPrimaryClipDescription ()

Added in API level 11

Returns a description of the current primary clip on the clipboard but not a copy of its data.

public CharSequence getText ()

Added in API level 11

This method was deprecated in API level 11.
Use getPrimaryClip() instead. This retrieves the primary clip and tries to coerce it to a string.

Returns the text on the clipboard. It will eventually be possible to store types other than text too, in which case this will return null if the type cannot be coerced to text.

public boolean hasPrimaryClip ()

Added in API level 11

Returns true if there is currently a primary clip on the clipboard.

public boolean hasText ()

Added in API level 11

This method was deprecated in API level 11.
Use hasPrimaryClip() instead.

Returns true if the clipboard contains text; false otherwise.

public void removePrimaryClipChangedListener (ClipboardManager.OnPrimaryClipChangedListener what)

Added in API level 11

public void setPrimaryClip (ClipData clip)

Added in API level 11

Sets the current primary clip on the clipboard. This is the clip that is involved in normal cut and paste operations.

Parameters
clip The clipped data item to set.

public void setText (CharSequence text)

Added in API level 11

This method was deprecated in API level 11.
Use setPrimaryClip(ClipData) instead. This creates a ClippedItem holding the given text and sets it as the primary clip. It has no label or icon.

Sets the contents of the clipboard to the specified text.

No examples for this method.
Frequently called with: [Clear]
Portions of this page are reproduced from work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. The original page is available here.