ToggleButton in android studio

سنتعرف في هذه التدوينة الي عنصر أخر مهم جدا في كثير من تطبيقات الروبوت وهو عنصر ToggleButton
في نظام التشغيل Android ، يتم استخدام ToggleButton لعرض الحالة المحددة checked وغير المحددة unchecked لأحد الأزرارعند النقر عليه. ToggleButton بشكل أساسي زر تشغيل / إيقاف off/on مع مؤشر ضوئي يشير إلى الحالة الحالية لزر التبديل. المثال الأكثر بساطة على ToggleButton هو تشغيل / إيقاف الصوت ، بلوتوث ، wifi ، نقطة ساخنة وجميع الادوات التي تظهر عند إنزال الستارة الخاصة بهاتفك . كما إنها فئة فرعية subclass من الكلاس compoundButton

كتابة كود العنصر في ملف XML

في داخل الفعالية الرئيسية MainActivity وفي ملف xml file الخاص بها قم بكتابة الكود التالي او قم بسحبه من خلال لوحة التصميم

 <ToggleButton
        android:id="@+id/btn_toggle"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

وعندما ننظر الي نتيجة معاينة الكود نجد ان الزر ظهر وفيه القيمة off (false) وهي القيمة الافتراضية ويمكنك تغيرها لاحقا من خلال بعض الخصائص المخصصة لذلك

خصائص زر ToggleButton

1. id:

   هي الخاصية المسؤولة عن تميز هذا الزر عن غيره طريق إعطاه إسم فريد

2. checked:

   تستخدم هذه الخاصية في وضع القيمة للزر وتكون قيمة منطقية true or false وعند وضع القيمة true يعني أن الحالة محددة checked وعندما تكون flase تعني أن الحالة غير محددة unchecked وتكون القيمة الافتراضية هي flase

3. gravity :

   هذه الخاصية تستخدم في التحكم في موضع النص داخل الزر وتكون إحدي القيم يمين او يسار او بالاعلي او الاسفل او الوسط في كلا الاتجاهين

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    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:orientation="vertical"
    tools:context="engahmed.gagacademy.MainActivity">

    <ToggleButton
        android:id="@+id/btn_toggle1"
        android:checked="true"
        android:gravity="right"
        android:layout_width="100dp"
        android:layout_height="100dp" />
    <ToggleButton
        android:id="@+id/btn_toggle2"
        android:checked="false"
        android:gravity="left"
        android:layout_width="100dp"
        android:layout_height="100dp" />

</LinearLayout>

1. textOn And textOff:

   textOn تستخدم هذه الخاصية في تعين النص عندما تكون الحالة محددة checked
   textOff تستخدم في تعين النص المكتوبة داخلها عندما تكون الحالة غير محددة unchecked

1. textSize:

   تستخدم في تعين حجم النص داخل زر التبديل ويقاس حجم النص بوحدة sp

2. textStyle:

   تستخدم هذه الخاصية في تعين شكل النص داخل الزر وتأخذ إحدي القيم bold , italic

3. textColor:

   تستخدم في تعين لون للنص داخل الزر

4. background:

   تستخدم في وضع صورة او لون ليكون عبارة عن خلفية للزر

5. padding:

   تستخدم في تحريك النص داخل الزر من إحدي الحواف الاربعة وفقا لقيم الاتجاهات المعروفة

6. drawableBottom, drawableTop, drawableRight And drawableLeft :

   تستخدم في وضع صورة مع نص داخل الزر والتحكم في تموضع الصورة بالنسبة للنص من خلال القيم اعلي واسفل ويمين ويسار

<ToggleButton
        android:id="@+id/btn_toggle1"
        android:checked="true"
        android:gravity="center"
        android:textOff="Disable"
        android:textOn="Enable"
        android:textSize="20sp"
        android:textStyle="italic"
        android:textColor="#efd56b"
        android:background="#44a987"
        android:drawableLeft="@mipmap/ic_launcher"
        android:layout_width="280dp"
        android:layout_height="100dp"/>
    <ToggleButton
        android:id="@+id/btn_toggle2"
        android:checked="false"
        android:gravity="center"
        android:textSize="20sp"
        android:textStyle="bold"
        android:textColor="#601aec"
        android:background="#9c98ac"
        android:textOff="Disable"
        android:textOn="Enable"
        android:drawableRight="@mipmap/ic_launcher"
        android:layout_width="280dp"
        android:layout_height="100dp" />