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
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 -