前面《Android剪贴板框架简介》和《Android剪贴板数据转文本简介》教程我们讲了如果要把数据复制到剪贴板(剪贴板句柄指向全局的 ClipboardManager 对象)上,需要创建一个 ClipData 对象,再把一个 ClipDescription 和一个以上的 ClipData.Item 对象加入其中,最后把这个 ClipData 添加到 ClipboardManager 对象中去。
而要从剪贴板粘贴数据,需先获得全局剪贴板对象,再获取 clip 对象,查找其中的数据,最后从 clip 对象中把数据复制到自己的存储中。
本节将详细描述把数据复制到剪切板的具体实现过程和如何针对三种剪贴板数据格式进行从剪切板粘贴数据。
具体的实现过程如下:
要复制 Content URI 类型的数据,先要建立一个 Content Provider。
NotePad 是一个使用 Content Provider 复制粘贴数据的示例。NotePadProvider 类实现了 ContentProvider。NotePad 类定义了该 Provider 和其他应用程序的交互方式,包括支持所用的 MIME 类型。
其代码如下:
- ...
- //if the user selects copy
- case R.id.menu_copy:
- //Gets a handle to the clipboard service.
- ClipboardManager clipboard = (ClipboardManager)getSystemService(Context.CLIPNOARD_SERVICE);
①文本
如果数据是一个文本,代码如下:
② URI
如果数据是一个 URI 对象,把记录 ID 编入 Provider 用到的 Content URI 中的代码如下:
- // Creates a Uri based on a base Uri and a record ID based on the contact's last name
- // Declares the base URI string
- private static final String CONTACTS = "content://com.example.contacts";
- // Declares a path string for URIs that you use to copy data
- private static final String COPY_PATH = "/copy";
- // Declares the Uri to paste to the clipboard
- Uri copyUri = Uri.parse(CONTACTS + COPY_PATH + "/" + lastName);
- ...
- // Creates a new URI clip object. The system uses the anonymous getContentResolver() object to
- // get MIME types from provider. The clip object's label is "URI", and its data is
- // the Uri previously created.
- ClipData clip = ClipData.newUri(getContentResolver(),"URI",copyUri);
③ Intent
如果数据是一个 Intent 对象,将其放入 clip 对象中的代码如下:
- //Creates the Intent
- Intent appIntent = new Intent(this,com.example.demo.myapplication.class);
- ...
- //Creates a clip object with the Intent in it.Its label is "Intent" and its data is
- //the Intent object created previously
- ClipData clip = ClipData.newIntent("Intent",appIntent);
把新建的 clip 对象放入剪贴板的代码如下:
要粘贴普通文本,首先获得全局剪贴板,并确认能否返回普通文本,然后获取 clip 对象,用 getText() 把其中的文本复制到自己的存储中。实现步骤如下:
1)用 getSystemService(CLIPBOARD_SERVICE) 获得全局 ClipboardManager 对象,并声明一个全局变量,用来存放粘贴到的文本。
2)确定启用或禁用当前 Activity 的“粘贴”选项,并验证剪贴板中是否包含 clip,且程序是否有能力处理其数据类型。
- // Gets the ID of the "paste" menu item
- MenuItem mPasteItem = menu.findItem(R.id.menu_paste);
- // If the clipboard doesn't contain data, disable the paste menu item.
- // If it does contain data, decide if you can handle the data.
- if (!(clipboard.hasPrimaryClip())) {
- mPasteItem.setEnabled(false);
- } else if (!(clipboard.getPrimaryClipDescription().hasMimeType(MIMETYPE_TEXT_PLAIN))) {
- // This disables the paste menu item, since the clipboard has data but it is not plain text
- mPasteItem.setEnabled(false);
- } else {
- // This enables the paste menu item, since the clipboard contains plain text.
- mPasteltem.setEnabled(true);
- }
3)从剪贴板中复制数据。只有“粘贴”菜单项启用时,程序才会运行至此,所以这时可以假定剪贴板已经包含普通文本,不过还不清楚里面包含文本字符串还是指向普通文本的 URI。测试处理普通文本的部分代码如下:
- // Responds to the user selecting "paste"
- case R.id.menu_paste:
- // Examines the item on the clipboard. If getTextO does not return null, the clip item contains the
- // text. Assumes that this application can only handle one item at a time.
- ClipData.Item item = clipboard.getPrimaryClip().getItemAt(0);
- // Gets the clipboard as text.
- pasteData = item.getText();
- // If the string contains data, then the paste operation is done
- if (pasteData != null) {
- return;
- // The clipboard does not contain text. If it contains a URI, attempts to get data from it
- } else {
- Uri pasteUri = item.getUri();
- // If the URI contains something, try to get text from it
- if (pasteUri != null) {
- // calls a routine to resolve the URI and get data from it. This routine is not
- // presented here. pasteData = resolveUri(Uri);
- return;
- } else {
- // Something is wrong. The MIME type was plain text, but the clipboard does not contain either
- // text or a Uri. Report an error.
- Log.e("Clipboard contains an invalid data type");
- return;
- }
- }
如果 ClipData.Item 对象包含一个 Content URI,程序也能处理其中的 MIME 类型,可创建一个 ContentResolver 对象,并调用 Content Provider 的相关方法来获取数据。
以下过程描述了如何根据剪贴板中的 Content URI 从 Content Provider 获取数据。
1)声明全局变量,用于存放 MIME 类型。
程序先检查 MIME 类型,确认能够使用 Provider 提供的数据。
2)获取全局剪贴板,创建一个用于访问 Content Provider 的 Content Resolver 对象。
- //Gets a handle to the Clipboard Manager
- ClipboardManager clipboard = (ClipboardManager)getSystemService(Context.CLIPBOARD_SERVICE);
- //Gets a content resolver instance
- ContentResolver cr = getContentResolver();
3)从剪贴板获取主 clip,并把内容解析为 URI。
- // Gets the clipboard data from the clipboard
- ClipData clip = clipboard.getPrimaryClip();
- if (clip != null) {
- // Gets the first item from the clipboard data
- ClipData.Item item = clip.getltemAt(0);
- // Tries to get the item's contents as a URI
- Uri pasteUri = item.getUri();
4)通过调用 getType(Uri),判断 URI 是否为 Content URI。如果 URI 未指向合法的 Content Provider,该方法返回 null。
- //If the clipboard contains a URI reference
- if(pasteUri != null){
- Is this a content URI?
- String uriMimeType = cr.getType(pasteUri);
- }
5)判断 Content Provider 是否支持应用程序识别的 MIME 类型。若支持,则调用 ContentResolver.query() 来获取数据,返回值是一个 Cursor 对象。
- // If the return value is not null, the Uri is a content Uri
- if (uriMimeType != null) {
- // Does the content provider offer a MIME type that the current application can use
- if (uriMimeType.equals(MIME_TYPE_CONTACT)) {
- // Get the data from the content provider.
- Cursor pasteCursor = cr.query(uri, null, null, null, null);
- // If the Cursor contains data, move to the first record
- if (pasteCursor != null) {
- if (pasteCursor.moveToFirst()) {
- // get the data from the Cursor here. The code will vary according to the
- // format of the data model.
- }
- }
- // close the Cursor
- pasteCursor.close();
- }
- }
- }
要粘贴一个 Intent,首先获取全局剪贴板,再检查 ClipData.Item 对象是否包含 Intent。最后调用 getIntent() 把 Intent 复制到程序的存储中。
实现代码如下:
- // Gets a handle to the Clipboard Manager
- ClipboardManager clipboard = (ClipboardManager)getSystemService(Context.CLIPBOARD_SERVICE);
- // Checks to see if the clip item contains an Intent, by testing to see if getlntentO returns null
- Intent pasteIntent = clipboard.getPriraaryClip().getItemAt(0).getIntent();
- if (pasteIntent != null) {
- // handle the Intent
- } else {
- // ignore the clipboard, or issue an error if your application was expecting an Intent to be
- // on the clipboard
- }