Android - área de transferência

O Android fornece a estrutura da área de transferência para copiar e colar diferentes tipos de dados. Os dados podem ser texto, imagens, dados de fluxo binário ou outros tipos de dados complexos.

O Android fornece a biblioteca de ClipboardManager e ClipData e ClipData.item para usar a estrutura de cópia e colagem. Para usar a estrutura da área de transferência, você precisa colocar os dados no objeto de clipe e, em seguida, colocar esse objeto na área de transferência do sistema.

Para usar a área de transferência, você precisa instanciar um objeto de ClipboardManager chamando o getSystemService()método. Sua sintaxe é fornecida abaixo -

ClipboardManager myClipboard;
myClipboard = (ClipboardManager)getSystemService(CLIPBOARD_SERVICE);

Copiando dados

A próxima coisa que você precisa fazer é instanciar o objeto ClipData chamando o respectivo tipo de método de dados da classe ClipData. No caso de dados de texto, onewPlainTextmétodo será chamado. Depois disso, você deve definir esses dados como o clipe do objeto Clipboard Manager. Sua sintaxe é fornecida a seguir -

ClipData myClip;
String text = "hello world";
myClip = ClipData.newPlainText("text", text);
myClipboard.setPrimaryClip(myClip);

O objeto ClipData pode assumir essas três formas e as funções a seguir são usadas para criar essas formas.

Sr. Não	Forma e método de ClipData
1	Text newPlainText (rótulo, texto) Retorna um objeto ClipData cujo único objeto ClipData.Item contém uma string de texto.
2	URI newUri (resolvedor, rótulo, URI) Retorna um objeto ClipData cujo único objeto ClipData.Item contém um URI.
3	Intent newIntent (rótulo, intent) Retorna um objeto ClipData cujo único objeto ClipData.Item contém um Intent.

Colando dados

Para colar os dados, primeiro obteremos o clipe chamando o getPrimaryClip()método. E a partir desse clique obteremos o item no objeto ClipData.Item. E do objeto obteremos os dados. Sua sintaxe é fornecida abaixo -

ClipData abc = myClipboard.getPrimaryClip();
ClipData.Item item = abc.getItemAt(0);
String text = item.getText().toString();

Além desses métodos, existem outros métodos fornecidos pela classe ClipboardManager para gerenciar a estrutura da área de transferência. Esses métodos estão listados abaixo -

Sr. Não	Método e descrição
1	getPrimaryClip() Este método apenas retorna o clipe primário atual na área de transferência
2	getPrimaryClipDescription() Este método retorna uma descrição do clipe primário atual na área de transferência, mas não uma cópia de seus dados.
3	hasPrimaryClip() Este método retorna verdadeiro se houver atualmente um clipe principal na área de transferência
4	setPrimaryClip(ClipData clip) Este método define o clipe primário atual na área de transferência
5	setText(CharSequence text) Este método pode ser usado diretamente para copiar texto para a área de transferência
6	getText() Este método pode ser usado diretamente para obter o texto copiado da área de transferência

Exemplo

Aqui está um exemplo que demonstra o uso da classe ClipboardManager. Ele cria um aplicativo básico de copiar e colar que permite copiar o texto e depois colá-lo através da área de transferência.

Para experimentar este exemplo, você pode executá-lo em um dispositivo real ou em um emulador.

Passos	Descrição
1	Você usará o Android Studio IDE para criar um aplicativo Android e em um pacote com.example.sairamkrishna.myapplication.
2	Modifique o arquivo src / MainActivity.java para adicionar o código necessário.
3	Modifique res / layout / activity_main para adicionar os respectivos componentes XML
4	Execute o aplicativo e escolha um dispositivo Android em execução, instale o aplicativo nele e verifique os resultados

A seguir está o conteúdo do arquivo de atividade principal modificado src/MainActivity.java.

package com.example.sairamkrishna.myapplication;

import android.content.ClipData;
import android.content.ClipboardManager;
import android.os.Bundle;

import android.support.v7.app.ActionBarActivity;
import android.view.View;

import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;


public class MainActivity extends ActionBarActivity {
   EditText ed1, ed2;
   Button b1, b2;

   private ClipboardManager myClipboard;
   private ClipData myClip;

   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);

      ed1 = (EditText) findViewById(R.id.editText);
      ed2 = (EditText) findViewById(R.id.editText2);

      b1 = (Button) findViewById(R.id.button);
      b2 = (Button) findViewById(R.id.button2);

      myClipboard = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);

      b1.setOnClickListener(new View.OnClickListener() {
         
         @Override
         public void onClick(View v) {
            String text;
            text = ed1.getText().toString();

            myClip = ClipData.newPlainText("text", text);
            myClipboard.setPrimaryClip(myClip);

            Toast.makeText(getApplicationContext(), "Text Copied", 
               Toast.LENGTH_SHORT).show();
         }
      });

      b2.setOnClickListener(new View.OnClickListener() {
         
         @Override
         public void onClick(View v) {
            ClipData abc = myClipboard.getPrimaryClip();
            ClipData.Item item = abc.getItemAt(0);

            String text = item.getText().toString();
            ed2.setText(text);

            Toast.makeText(getApplicationContext(), "Text Pasted", 
               Toast.LENGTH_SHORT).show();
         }
      });
   }

}

A seguir está o conteúdo modificado do xml res/layout/activity_main.xml.

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 
   xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:tools="http://schemas.android.com/tools" 
   android:layout_width="match_parent"
   android:layout_height="match_parent" 
   android:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   android:paddingBottom="@dimen/activity_vertical_margin" 
   tools:context=".MainActivity">
   
   <TextView android:text="Example" android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textview"
      android:textSize="35dp"
      android:layout_alignParentTop="true"
      android:layout_centerHorizontal="true" />
      
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Tutorials point"
      android:id="@+id/textView"
      android:layout_below="@+id/textview"
      android:layout_centerHorizontal="true"
      android:textColor="#ff7aff24"
      android:textSize="35dp" />
      
   <ImageView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/imageView"
      android:src="@drawable/abc"
      android:layout_below="@+id/textView"
      android:layout_centerHorizontal="true" />
      
   <EditText
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/editText"
      android:layout_alignParentRight="true"
      android:layout_alignParentEnd="true"
      android:hint="Copy text"
      android:layout_below="@+id/imageView"
      android:layout_alignLeft="@+id/imageView"
      android:layout_alignStart="@+id/imageView" />
      
   <EditText
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/editText2"
      android:layout_alignLeft="@+id/editText"
      android:layout_alignStart="@+id/editText"
      android:hint="paste text"
      android:layout_below="@+id/editText"
      android:layout_alignRight="@+id/editText"
      android:layout_alignEnd="@+id/editText" />
      
   <Button
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Copy text"
      android:id="@+id/button"
      android:layout_below="@+id/editText2"
      android:layout_alignLeft="@+id/editText2"
      android:layout_alignStart="@+id/editText2" />
      
   <Button
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Paste text"
      android:id="@+id/button2"
      android:layout_below="@+id/editText2"
      android:layout_alignRight="@+id/editText2"
      android:layout_alignEnd="@+id/editText2" />
      
</RelativeLayout>

A seguir está o conteúdo do res/values/string.xml.

<resources>
   <string name="app_name">My Application</string>
</resources>

A seguir está o conteúdo de AndroidManifest.xml Arquivo.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.sairamkrishna.myapplication" >

   <application
      android:allowBackup="true"
      android:icon="@drawable/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme" >
      
      <activity
         android:name="com.example.sairamkrishna.myapplication.MainActivity"
         android:label="@string/app_name" >
         
         <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
      
      </activity>
   </application>

</manifest>

Vamos tentar executar nosso aplicativo que acabamos de modificar. Suponho que você tenha criado o seuAVDao fazer a configuração do ambiente. Para executar o aplicativo do Android Studio, abra um dos arquivos de atividade do seu projeto e clique no ícone Executar na barra de ferramentas. O instalador do Android Studio exibirá as seguintes imagens -

Agora, basta inserir qualquer texto no campo Texto a copiar e selecionar o botão de copiar texto. A seguinte notificação será exibida, mostrada abaixo -

Agora é só clicar no botão Colar, e você verá que o texto que foi copiado agora está colado no campo Texto Copiado. É mostrado abaixo -