Uses of Android Clipboard:<\/h4>\n\n- Copy and paste your data from one area to another.<\/li>\n
- Copying multiple types of data, whether an image, text, number, URL, or even complex data types.<\/li>\n
- You can store some of your frequently needed data like phone number and address in the clipboard and then paste it whenever required.<\/li>\n<\/ul>\n
Where is the Clipboard on Android Phone?<\/h3>\n
On Android Devices, the clipboard is usually available in the form of RAM. Whatever data you copy into the clipboard is stored in the RAM of your device.
\nTo access the stored data from the RAM, you require the Clipboard Manager.<\/p>\n
If you wish to access the stored data without using a Clipboard Manager, then you need to root your device. There are some apps available on the Google Play Store to check the history of the data stored in the clipboard.<\/p>\n
How to use Android Clipboard?<\/h3>\n
To use the Android Clipboard, you must first construct a Clipboard class object. To do so, you can use the getSystemService()<\/strong> method, as shown below.<\/p>\n\/\/creating an object of the clipboard manager \r\n\/\/using getSystemService \r\nval myClipboardManager = getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager<\/pre>\nAfter successfully creating your Clipboard object, you are ready to take over the action you need to perform. Generally, we use the clipboard to do two primary activities.<\/p>\n
\n- Copy Data<\/li>\n
- Paste Data<\/li>\n<\/ul>\n
Let’s see how you can perform each function in detail.<\/p>\n
Copy Data<\/h3>\n
To copy your data, you need to create an object of the ClipData and then use it to store the data in the clipboard. You need to use the respective function applicable to the data you wish to copy for making the object.<\/p>\n
For example, you would use the newPlainText()<\/strong> method if you wish to copy plain text. Now to add the data into the Clipboard, you need to use the ClipManager object.<\/p>\nYou can see an example implementation below.<\/p>\n
\/\/creating our clipData object and passing the text with a label\r\nval myClipData = ClipData.newPlainText(\"copiedText\", enteredText)\r\n\r\n\/\/setting the clipped data on the Android clipboard\r\nmyClipboardManager.setPrimaryClip(myClipData)\r\n<\/pre>\nThe data which you can pass as the ClipData can be of three types:<\/p>\n
1. Text
\n2. URI
\n3. Intent<\/p>\n
Paste Data<\/h3>\n
To paste the clipped data from the clipboard, you need to use the getPrimaryClip()<\/strong> method. You can store the data in ClipData.Item object and then later put it wherever we need.<\/p>\nBelow is an example of pasting data.<\/p>\n
\/\/creating the clipboard manager object\r\nval clipboardManager = getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager\r\n\r\n\/\/accessing the data from the clipboard and\r\n\/\/placing it on the text view\r\npastedTextView.text = clipboardManager.primaryClip?.getItemAt(0)?.text\r\n<\/pre>\nMethods involved in Android Clipboard<\/h3>\n
Several methods are involved while using the Android Clipboard.<\/p>\n
<\/p>\n
![\"Android](\"https:\/\/techvidvan.com\/tutorials\/wp-content\/uploads\/sites\/2\/2021\/07\/Android-Clipboard-Methods.jpg\")
<\/a><\/p>\n1. getPrimaryClipDescription()<\/strong> \u2013 This method provides information about the currently copied data in the clipboard, such as its MIME type. It returns a ClipDescription object that describes the data format and type, which can be useful for understanding the kind of data you are working with.<\/p>\n2. hasPrimaryClip()<\/strong> \u2013 This method tells us whether there is any data available in the primary clipboard or not. It returns a boolean value\u2014true if there is data available, and false otherwise. This helps in checking if there is something to paste or if the clipboard is empty.<\/p>\n3. setPrimaryClip(ClipData<\/strong> clip) \u2013 This method sets the data on the clipboard\u2019s primary clip. You pass a ClipData object that contains the data you want to copy. This allows you to programmatically copy data to the clipboard, which can be used for later retrieval or pasting.<\/p>\n4. getText()<\/strong> \u2013 This method retrieves the text from the clipboard if the current primary clip contains text data. It returns a CharSequence containing the text, which you can use directly in your application. It is convenient for accessing plain text that has been copied to the clipboard.<\/p>\n5. setText(CharSequence<\/strong> text<\/strong>) \u2013 This method sets the textual data directly into the clipboard. You pass a CharSequence representing the text you want to copy. It is a simple way to copy text to the clipboard without needing to create a ClipData object.<\/p>\nThe architecture of Android Clipboard Framework<\/h3>\n
You need to understand the architecture of the Android Clipboard Framework. Through the architecture, you will get to know the parts that are present in the Android Clipboard.<\/p>\n
So below is a figure which will guide you through the architecture of Clipboard.<\/p>\n
![\"Android](\"https:\/\/techvidvan.com\/tutorials\/wp-content\/uploads\/sites\/2\/2021\/07\/Clipboard-Framework.jpg\")
<\/a><\/p>\nNow let’s see each of the components of the architecture in detail.<\/p>\n
![\"Android](\"https:\/\/techvidvan.com\/tutorials\/wp-content\/uploads\/sites\/2\/2021\/07\/Android-Clipboard-Framework.jpg\")
<\/a><\/p>\n1. Clipboard Manager:<\/strong> Clipboard Manager is a class that manages the system clipboard and stores or sends data to\/from the clipboard. It provides methods for accessing and modifying the clipboard’s contents, allowing you to copy, cut, and paste data within your application and across other apps.<\/p>\n2. ClipData:<\/strong> ClipData is an object that holds the actual data item and the description of that data. It is used to encapsulate the data you want to copy to or retrieve from the clipboard, supporting multiple types of data such as text, images, and URIs.<\/p>\n3. ClipData.Item:<\/strong> It’s also a ClipData object used to store the actual data item in the form of text, URI, or an intent. It allows you to manage individual pieces of data within a ClipData object, providing flexibility in how data is stored and accessed.<\/p>\n4. ClipDescription:<\/strong> The ClipDescription object is used to store the metadata of the actual data stored in the ClipBoard. It includes information such as the data’s MIME type and label, helping to describe the nature of the data and ensure compatibility when pasting.<\/p>\n5. ClipData Methods:<\/strong> ClipData methods are used to create ClipData and operate it. These methods allow you to add items, retrieve data, and manipulate the clipboard’s contents, facilitating various clipboard operations and interactions within your app.<\/p>\nImplementation of Android Clipboard<\/h3>\n
So I hope you are clear with the Android Clipboard and the two possible operations, Copy and Paste. Now it’s time for us to see the steps that are useful to implement Clipboard.<\/p>\n
Step 1:<\/strong> Open your Android Studio and select Create a new Project and proceed.<\/p>\nStep<\/strong> 2:<\/strong> Select Empty Activity and then enter a project name of your choice. Now just select API level 22 and proceed.<\/p>\nStep 3:<\/strong> To design the layout, you can use the below code and paste it into your activity_main.xml file.<\/p>\nCode: activity_main.xml<\/strong><\/p>\n<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<LinearLayout xmlns:android=\"http:\/\/schemas.android.com\/apk\/res\/android\"\r\n android:layout_width=\"match_parent\"\r\n android:layout_height=\"match_parent\"\r\n android:orientation=\"vertical\"\r\n android:padding=\"20dp\">\r\n\r\n <TextView\r\n android:id=\"@+id\/title\"\r\n android:layout_marginTop=\"20dp\"\r\n android:layout_width=\"match_parent\"\r\n android:layout_height=\"wrap_content\"\r\n android:layout_marginBottom=\"100dp\"\r\n android:gravity=\"center\"\r\n android:text=\"TechVidvan Clipboard\"\r\n android:textSize=\"30sp\"\r\n android:textColor=\"@color\/purple_700\"\/>\r\n\r\n <LinearLayout\r\n android:layout_width=\"match_parent\"\r\n android:layout_height=\"wrap_content\"\r\n android:orientation=\"vertical\">\r\n\r\n <EditText\r\n android:id=\"@+id\/your_copied_text\"\r\n android:layout_width=\"match_parent\"\r\n android:layout_height=\"wrap_content\"\r\n android:textSize=\"18sp\"\r\n android:padding=\"10dp\"\r\n android:hint=\"Enter the text you wish to copy\"\r\n \/>\r\n\r\n <Button\r\n android:onClick=\"copyText\"\r\n android:layout_width=\"wrap_content\"\r\n android:layout_height=\"wrap_content\"\r\n android:layout_marginTop=\"10dp\"\r\n android:text=\"Copy Text\"\r\n \/>\r\n\r\n <\/LinearLayout>\r\n\r\n <LinearLayout\r\n android:layout_width=\"match_parent\"\r\n android:layout_height=\"wrap_content\"\r\n android:orientation=\"vertical\"\r\n android:layout_marginTop=\"50dp\">\r\n\r\n <TextView\r\n android:id=\"@+id\/your_pasted_text\"\r\n android:layout_width=\"wrap_content\"\r\n android:layout_height=\"wrap_content\"\r\n android:textSize=\"18sp\"\r\n android:padding=\"10dp\"\r\n android:hint=\"Paste your text here\"\r\n \/>\r\n\r\n <Button\r\n android:onClick=\"pasteText\"\r\n android:layout_width=\"wrap_content\"\r\n android:layout_height=\"wrap_content\"\r\n android:layout_marginTop=\"10dp\"\r\n android:text=\"Paste Here\"\r\n \/>\r\n\r\n <\/LinearLayout>\r\n\r\n<\/LinearLayout>\r\n<\/pre>\nStep 4:<\/strong> As a final step, you need to add the following in your MainActivity file.<\/p>\nCode: MainActivity.kt<\/strong><\/p>\npackage com.techvidvan.techvidvanclipboard\r\n\r\nimport android.content.ClipData\r\nimport android.content.ClipboardManager\r\nimport android.content.Context\r\nimport androidx.appcompat.app.AppCompatActivity\r\nimport android.os.Bundle\r\nimport android.view.View\r\nimport android.widget.EditText\r\nimport android.widget.TextView\r\nimport android.widget.Toast\r\n\r\nclass MainActivity : AppCompatActivity()\r\n{\r\n \/\/declaring variables\r\n lateinit var copiedText:EditText\r\n lateinit var pastedTextView:TextView\r\n override fun onCreate(savedInstanceState: Bundle?)\r\n {\r\n super.onCreate(savedInstanceState)\r\n setContentView(R.layout.activity_main)\r\n\r\n \/\/binding the edit text and text view\r\n \/\/with our created variables\r\n copiedText = findViewById(R.id.your_copied_text)\r\n pastedTextView = findViewById(R.id.your_pasted_text)\r\n }\r\n\r\n fun copyText(view: View)\r\n {\r\n \/\/fetching the text from the edit text\r\n val enteredText = copiedText.text.toString()\r\n\r\n \/\/creating an object of the clipboard manager\r\n \/\/using getSystemService\r\n val myClipboardManager = getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager\r\n\r\n \/\/creating our clipData object and passing the text with a label\r\n val myClipData = ClipData.newPlainText(\"copiedText\", enteredText)\r\n\r\n \/\/setting the clipped data on the clipboard\r\n myClipboardManager.setPrimaryClip(myClipData)\r\n\r\n \/\/updating the user that data is clipped successfully\r\n Toast.makeText(this, \"Yayy!! Your text is copied to the Clipboard\", Toast.LENGTH_LONG).show()\r\n }\r\n fun pasteText(view: View)\r\n {\r\n \/\/creating the clipboard manager object\r\n val clipboardManager = getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager\r\n\r\n \/\/accessing the data from the clipboard and\r\n \/\/placing it on the text view\r\n pastedTextView.text = clipboardManager.primaryClip?.getItemAt(0)?.text\r\n }\r\n\r\n\r\n}\r\n<\/pre>\nNow simply run your clipboard application.<\/p>\n
![\"Android](\"https:\/\/techvidvan.com\/tutorials\/wp-content\/uploads\/sites\/2\/2021\/07\/App_Output_1-6.jpg\")
<\/a><\/p>\nYou can use the copy text button to copy the text and then use the paste text button to paste it.<\/p>\n
Where is the Clipboard on Android Phone?<\/h3>\n
On Android Devices, the clipboard is usually available in the form of RAM. Whatever data you copy into the clipboard is stored in the RAM of your device.
\nTo access the stored data from the RAM, you require the Clipboard Manager.<\/p>\n
If you wish to access the stored data without using a Clipboard Manager, then you need to root your device. There are some apps available on the Google Play Store to check the history of the data stored in the clipboard.<\/p>\n
How to use Android Clipboard?<\/h3>\n
To use the Android Clipboard, you must first construct a Clipboard class object. To do so, you can use the getSystemService()<\/strong> method, as shown below.<\/p>\n After successfully creating your Clipboard object, you are ready to take over the action you need to perform. Generally, we use the clipboard to do two primary activities.<\/p>\n Let’s see how you can perform each function in detail.<\/p>\n To copy your data, you need to create an object of the ClipData and then use it to store the data in the clipboard. You need to use the respective function applicable to the data you wish to copy for making the object.<\/p>\n For example, you would use the newPlainText()<\/strong> method if you wish to copy plain text. Now to add the data into the Clipboard, you need to use the ClipManager object.<\/p>\n You can see an example implementation below.<\/p>\n The data which you can pass as the ClipData can be of three types:<\/p>\n 1. Text To paste the clipped data from the clipboard, you need to use the getPrimaryClip()<\/strong> method. You can store the data in ClipData.Item object and then later put it wherever we need.<\/p>\n Below is an example of pasting data.<\/p>\n Several methods are involved while using the Android Clipboard.<\/p>\n <\/p>\n 1. getPrimaryClipDescription()<\/strong> \u2013 This method provides information about the currently copied data in the clipboard, such as its MIME type. It returns a ClipDescription object that describes the data format and type, which can be useful for understanding the kind of data you are working with.<\/p>\n 2. hasPrimaryClip()<\/strong> \u2013 This method tells us whether there is any data available in the primary clipboard or not. It returns a boolean value\u2014true if there is data available, and false otherwise. This helps in checking if there is something to paste or if the clipboard is empty.<\/p>\n 3. setPrimaryClip(ClipData<\/strong> clip) \u2013 This method sets the data on the clipboard\u2019s primary clip. You pass a ClipData object that contains the data you want to copy. This allows you to programmatically copy data to the clipboard, which can be used for later retrieval or pasting.<\/p>\n 4. getText()<\/strong> \u2013 This method retrieves the text from the clipboard if the current primary clip contains text data. It returns a CharSequence containing the text, which you can use directly in your application. It is convenient for accessing plain text that has been copied to the clipboard.<\/p>\n 5. setText(CharSequence<\/strong> text<\/strong>) \u2013 This method sets the textual data directly into the clipboard. You pass a CharSequence representing the text you want to copy. It is a simple way to copy text to the clipboard without needing to create a ClipData object.<\/p>\n You need to understand the architecture of the Android Clipboard Framework. Through the architecture, you will get to know the parts that are present in the Android Clipboard.<\/p>\n So below is a figure which will guide you through the architecture of Clipboard.<\/p>\n Now let’s see each of the components of the architecture in detail.<\/p>\n 1. Clipboard Manager:<\/strong> Clipboard Manager is a class that manages the system clipboard and stores or sends data to\/from the clipboard. It provides methods for accessing and modifying the clipboard’s contents, allowing you to copy, cut, and paste data within your application and across other apps.<\/p>\n 2. ClipData:<\/strong> ClipData is an object that holds the actual data item and the description of that data. It is used to encapsulate the data you want to copy to or retrieve from the clipboard, supporting multiple types of data such as text, images, and URIs.<\/p>\n 3. ClipData.Item:<\/strong> It’s also a ClipData object used to store the actual data item in the form of text, URI, or an intent. It allows you to manage individual pieces of data within a ClipData object, providing flexibility in how data is stored and accessed.<\/p>\n 4. ClipDescription:<\/strong> The ClipDescription object is used to store the metadata of the actual data stored in the ClipBoard. It includes information such as the data’s MIME type and label, helping to describe the nature of the data and ensure compatibility when pasting.<\/p>\n 5. ClipData Methods:<\/strong> ClipData methods are used to create ClipData and operate it. These methods allow you to add items, retrieve data, and manipulate the clipboard’s contents, facilitating various clipboard operations and interactions within your app.<\/p>\n So I hope you are clear with the Android Clipboard and the two possible operations, Copy and Paste. Now it’s time for us to see the steps that are useful to implement Clipboard.<\/p>\n Step 1:<\/strong> Open your Android Studio and select Create a new Project and proceed.<\/p>\n Step<\/strong> 2:<\/strong> Select Empty Activity and then enter a project name of your choice. Now just select API level 22 and proceed.<\/p>\n Step 3:<\/strong> To design the layout, you can use the below code and paste it into your activity_main.xml file.<\/p>\n Code: activity_main.xml<\/strong><\/p>\n Step 4:<\/strong> As a final step, you need to add the following in your MainActivity file.<\/p>\n Code: MainActivity.kt<\/strong><\/p>\n Now simply run your clipboard application.<\/p>\n You can use the copy text button to copy the text and then use the paste text button to paste it.<\/p>\n\/\/creating an object of the clipboard manager \r\n\/\/using getSystemService \r\nval myClipboardManager = getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager<\/pre>\n
\n
Copy Data<\/h3>\n
\/\/creating our clipData object and passing the text with a label\r\nval myClipData = ClipData.newPlainText(\"copiedText\", enteredText)\r\n\r\n\/\/setting the clipped data on the Android clipboard\r\nmyClipboardManager.setPrimaryClip(myClipData)\r\n<\/pre>\n
\n2. URI
\n3. Intent<\/p>\nPaste Data<\/h3>\n
\/\/creating the clipboard manager object\r\nval clipboardManager = getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager\r\n\r\n\/\/accessing the data from the clipboard and\r\n\/\/placing it on the text view\r\npastedTextView.text = clipboardManager.primaryClip?.getItemAt(0)?.text\r\n<\/pre>\n
Methods involved in Android Clipboard<\/h3>\n
<\/a><\/p>\nThe architecture of Android Clipboard Framework<\/h3>\n
<\/a><\/p>\n<\/a><\/p>\nImplementation of Android Clipboard<\/h3>\n
<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<LinearLayout xmlns:android=\"http:\/\/schemas.android.com\/apk\/res\/android\"\r\n android:layout_width=\"match_parent\"\r\n android:layout_height=\"match_parent\"\r\n android:orientation=\"vertical\"\r\n android:padding=\"20dp\">\r\n\r\n <TextView\r\n android:id=\"@+id\/title\"\r\n android:layout_marginTop=\"20dp\"\r\n android:layout_width=\"match_parent\"\r\n android:layout_height=\"wrap_content\"\r\n android:layout_marginBottom=\"100dp\"\r\n android:gravity=\"center\"\r\n android:text=\"TechVidvan Clipboard\"\r\n android:textSize=\"30sp\"\r\n android:textColor=\"@color\/purple_700\"\/>\r\n\r\n <LinearLayout\r\n android:layout_width=\"match_parent\"\r\n android:layout_height=\"wrap_content\"\r\n android:orientation=\"vertical\">\r\n\r\n <EditText\r\n android:id=\"@+id\/your_copied_text\"\r\n android:layout_width=\"match_parent\"\r\n android:layout_height=\"wrap_content\"\r\n android:textSize=\"18sp\"\r\n android:padding=\"10dp\"\r\n android:hint=\"Enter the text you wish to copy\"\r\n \/>\r\n\r\n <Button\r\n android:onClick=\"copyText\"\r\n android:layout_width=\"wrap_content\"\r\n android:layout_height=\"wrap_content\"\r\n android:layout_marginTop=\"10dp\"\r\n android:text=\"Copy Text\"\r\n \/>\r\n\r\n <\/LinearLayout>\r\n\r\n <LinearLayout\r\n android:layout_width=\"match_parent\"\r\n android:layout_height=\"wrap_content\"\r\n android:orientation=\"vertical\"\r\n android:layout_marginTop=\"50dp\">\r\n\r\n <TextView\r\n android:id=\"@+id\/your_pasted_text\"\r\n android:layout_width=\"wrap_content\"\r\n android:layout_height=\"wrap_content\"\r\n android:textSize=\"18sp\"\r\n android:padding=\"10dp\"\r\n android:hint=\"Paste your text here\"\r\n \/>\r\n\r\n <Button\r\n android:onClick=\"pasteText\"\r\n android:layout_width=\"wrap_content\"\r\n android:layout_height=\"wrap_content\"\r\n android:layout_marginTop=\"10dp\"\r\n android:text=\"Paste Here\"\r\n \/>\r\n\r\n <\/LinearLayout>\r\n\r\n<\/LinearLayout>\r\n<\/pre>\n
package com.techvidvan.techvidvanclipboard\r\n\r\nimport android.content.ClipData\r\nimport android.content.ClipboardManager\r\nimport android.content.Context\r\nimport androidx.appcompat.app.AppCompatActivity\r\nimport android.os.Bundle\r\nimport android.view.View\r\nimport android.widget.EditText\r\nimport android.widget.TextView\r\nimport android.widget.Toast\r\n\r\nclass MainActivity : AppCompatActivity()\r\n{\r\n \/\/declaring variables\r\n lateinit var copiedText:EditText\r\n lateinit var pastedTextView:TextView\r\n override fun onCreate(savedInstanceState: Bundle?)\r\n {\r\n super.onCreate(savedInstanceState)\r\n setContentView(R.layout.activity_main)\r\n\r\n \/\/binding the edit text and text view\r\n \/\/with our created variables\r\n copiedText = findViewById(R.id.your_copied_text)\r\n pastedTextView = findViewById(R.id.your_pasted_text)\r\n }\r\n\r\n fun copyText(view: View)\r\n {\r\n \/\/fetching the text from the edit text\r\n val enteredText = copiedText.text.toString()\r\n\r\n \/\/creating an object of the clipboard manager\r\n \/\/using getSystemService\r\n val myClipboardManager = getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager\r\n\r\n \/\/creating our clipData object and passing the text with a label\r\n val myClipData = ClipData.newPlainText(\"copiedText\", enteredText)\r\n\r\n \/\/setting the clipped data on the clipboard\r\n myClipboardManager.setPrimaryClip(myClipData)\r\n\r\n \/\/updating the user that data is clipped successfully\r\n Toast.makeText(this, \"Yayy!! Your text is copied to the Clipboard\", Toast.LENGTH_LONG).show()\r\n }\r\n fun pasteText(view: View)\r\n {\r\n \/\/creating the clipboard manager object\r\n val clipboardManager = getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager\r\n\r\n \/\/accessing the data from the clipboard and\r\n \/\/placing it on the text view\r\n pastedTextView.text = clipboardManager.primaryClip?.getItemAt(0)?.text\r\n }\r\n\r\n\r\n}\r\n<\/pre>\n<\/a><\/p>\n