Hello Readers! In this tutorial, we will learn about how to use android checkbox with example. We will learn about different attributes that are used to customise this widget.

Output

Tutorialwing Android Checkbox Output

Getting Started

Android Checkbox can be described as below –

Android Checkbox is special type of button that has only 2 states i.e. either checked or unchecked.

Different Attributes of Android Checkbox Widget

Attributes of checkbox widget are inherited from Textview, View and Compound Button. Some of the popular attributes inherited from Textview are –

Attributes of Checkbox inherited from Compound Button are –

Attributes of Checkbox inherited from View are –

Example of Android Checkbox Widget

At first, we will create android application. Then, we will use checkbox widget in this application.

1. Creating New Project

Follow steps below to create new android project. Please ignore the steps if you have already created android application.

Now, we will modify xml and java file to modify or perform some action when checkbox is clicked. Please follow the steps below.

2. Modify Values folder

Open res/values/strings.xml file. Then, add below code into it.

<resources>
	<string name="app_name">Checkbox</string>
	<string name="check_it">Check it</string>
</resources>

Other values folder have not been changed. So, we are not going to mention it here.

3. Use Checkbox in xml file

Open res/layout/activity_main.xml file. Then, add below code into it.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
	xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:gravity="center">

	<CheckBox
		android:id="@+id/checkBox"
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:padding="10dp"
		android:text="@string/check_it"/>

</LinearLayout>

Notice that we have defined Checkbox widget with id checkBox in xml file. Now, we will access this checkbox widget in java file. Then, We will show a toast message when checkbox is clicked.

4. Access Checkbox in java file

Open src/main/java/com.tutorialwing.checkbox/MainActivity.java file. Then, add below code into it.

package com.tutorialwing.checkbox;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.widget.CheckBox;
import android.widget.CompoundButton;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {

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

		CheckBox checkBox = findViewById(R.id.checkBox);
		if (checkBox != null) {
			checkBox.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
				@Override
				public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
					String msg = "You have " + (isChecked ? "checked" : "unchecked") + " this Check it Checkbox.";
					Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
				}
			});
		}
	}
}

Notice that we have added a listener whenever checked/unchecked state is changed in checkbox.

Since AndroidManifest file is very important for any android application. We are also going to mention it here.

AndroidManifest.xml file

Code inside main/AndroidManifest.xml file is as below.

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

	<application
		android:allowBackup="true"
		android:icon="@mipmap/ic_launcher"
		android:label="@string/app_name"
		android:roundIcon="@mipmap/ic_launcher_round"
		android:supportsRtl="true"
		android:theme="@style/AppTheme">
		<activity android:name=".MainActivity">
			<intent-filter>
				<action android:name="android.intent.action.MAIN"/>

				<category android:name="android.intent.category.LAUNCHER"/>
			</intent-filter>
		</activity>
	</application>

</manifest>

When you run the application, you will get output as shown above.

That’s the end of tutorial on Android Checkbox widget.