آموزش نحوه ی ایجاد کامپوننت های سفارشی در اندروید

اندروید لیست بزرگی از ویجت های از پیش ساخته شده مانند Button، TextView، EditText، ListView، CheckBox، RadioButton، Gallery، Spinner، AutoCompleteTextView و غیره را ارائه می کند،که شما میتوانید مستقیما در اپلیکیشن خود از آن ها استفاده کنید.

ولی ممکن است موقعیتی به وجود بیاید که شما از قابلیت های ویجت های موجود راضی نباشید به طوری که حس کنید این ویجت ها نیاز و خواسته ی شما را برطرف نمی کند. اندروید ابزار هایی را برای سفارشی سازی این موارد فراهم کرده است که با کمک آن ها می توانید با توجه به نیاز خود ، عمل سفارشی سازی را انجام دهید.

اگر فقط نیازمند اعمال تغییرات و تنظیمات کوچکی در یک ویجت یا Layout موجود باشید، می توانید به سادگی یک زیر کلاس از ویجت یا Layout مربوطه ایجاد کنید و متد های آن را override کنید. این کار به شما کنترل دقیقی را ، بر روی ظاهر و عملکرد یک عنصر موجود بر روی صفحه نمایش ، می دهد .

این مقاله با استفاده از گام ها و مراحل ساده شرح می دهد که شما چگونه می توانید view های سفارشی خود را ایجاد کنید و آن ها را در اپلیکیشن خود به کار بگیرید .

ایجاد یک مولفه سفارشی ساده:

در صورتی که شما بخواهید عملکرد یک ویجت موجود مانند Button، TextView، EditText، ListView، CheckBox و غیره را توسعه دهید، ساده ترین راه برای ایجاد مولفه­ ی سفارشی مربوط به خودتان، توسعه کلاس مربوط به ویجت موجود یا زیر کلاس های مربوط به کلاس خودتان است. در غیر این صورت شما باید با شروع از کلاس android.view.View همه کارها را خودتان انجام دهید.

در ساده ترین شکل، شما باید سازنده (constructors) های خود را متناظر با همه سازنده های کلاس اصلی بنویسید. 

1) یگ پروژه جدید در اندروید استودیو ایجاد کنید و آن را با نام myapplication تحت پکیج com.example.clicksite7.myapplication ایجاد کنید.

2) فایل XML به صورت res/values/attrs.xml برای تعریف اتریبیوت های جدید به همراه نوع داده آنها ، تعریف کنید .

3) فایل src/mainactivity.java را برای اضافه کردن کدها ، جهت تعریف اجزای سفارشی ، ایجاد کنید .

4) فایل res/layout/activity_main.xml را تغییر دهید و کدهای لازم را اضافه کنید.(مطابق کدهای زیر)

5) اپلیکیشن را اجرا کنید و نتیجه را در امولاتور مورد بررسی قرار دهید .

فایل اتریبیوت زیر را با نام attrs.xml در پوشه res/values ایجاد کنید :

<?xml version="1.0" encoding="utf-8"?>
<resources>
   <declare-styleable name="TimeView">
      <declare-styleable name="TimeView">
         <attr name="title" format="string" />
         <attr name="setColor" format="boolean"/>
      </declare-styleable>
   </declare-styleable>
</resources>

فایل layout استفاده شده توسط اکتیویتی را تغییر دهید :

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:tools="http://schemas.android.com/tools"
   xmlns:custom="http://schemas.android.com/apk/res-auto"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   tools:context=".MainActivity" >

   <com.example.clicksite7.myapplication.TimeView
      android:id="@+id/timeView"
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:textColor="#fff"
      android:textSize="40sp"
      custom:title="my time view"
      custom:setColor="true" />

   <TextView
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:id="@+id/simple"
      android:layout_below="@id/timeView"
      android:layout_marginTop="10dp" />
</RelativeLayout>

فایل جاوای زیر را با نام timeview ایجاد کنید  :

package com.example.clicksite7.myapplication;
/**
 * Created by clicksite7 on 9/14/2016.
 */
import java.text.SimpleDateFormat;
import java.util.Calendar;

import android.content.Context;
import android.content.res.TypedArray;

import android.graphics.Color;
import android.util.AttributeSet;
import android.widget.TextView;

public class TimeView extends TextView {
   private String titleText;
   private boolean color;

   public TimeView(Context context) {
      super(context);
      setTimeView();
   }

   public TimeView(Context context, AttributeSet attrs) {
      super(context, attrs);
      // retrieved values correspond to the positions of the attributes
         TypedArray typedArray = context.obtainStyledAttributes(attrs, 
            R.styleable.TimeView);
      int count = typedArray.getIndexCount();
      try{
         
         for (int i = 0; i < count; ++i) {
            
            int attr = typedArray.getIndex(i);
            // the attr corresponds to the title attribute
            if(attr == R.styleable.TimeView_title) {
               
               // set the text from the layout
               titleText = typedArray.getString(attr);
               setTimeView();
            } else if(attr == R.styleable.TimeView_setColor) {
               // set the color of the attr "setColor"
               color = typedArray.getBoolean(attr, false);
               decorateText();
            }
         }
      }
        
      // the recycle() will be executed obligatorily
      finally {
         // for reuse
         typedArray.recycle();
      }
   }

   public TimeView(Context context, AttributeSet attrs, int defStyle) {
      super(context, attrs, defStyle);
      setTimeView();
   }

   private void setTimeView() {
      // has the format hour.minuits am/pm
      SimpleDateFormat dateFormat = new SimpleDateFormat("hh.mm aa");
      String time = dateFormat.format(Calendar.getInstance().getTime());
      
      if(this.titleText != null )
      setText(this.titleText+" "+time);
      else
         setText(time);
   }

   private void decorateText() {
      // when we set setColor attribute to true in the XML layout
      if(this.color == true){
         // set the characteristics and the color of the shadow
         setShadowLayer(4, 2, 2, Color.rgb(250, 00, 250));
         setBackgroundColor(Color.CYAN);
      } else {
         setBackgroundColor(Color.RED);
      }
   }
}

فایل اصلی اکتیویتی جاوا را به کد زیر تغییر دهید و اپلیکیشن خود را اجرا کنید :

package com.example.clicksite7.myapplication;

import android.os.Bundle;
import android.widget.TextView;
import android.app.Activity;

public class MainActivity extends Activity {

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

      TextView simpleText = (TextView) findViewById(R.id.simple);
      simpleText.setText("That is a simple TextView");
   }
}