آشنایی با Auto Complete در برنامه نویسی اندروید

حتما در هنگام تایپ کردن با کلمات پیشنهادی بر خورد داشته اید , ممکن است با وارد کردن یک یا دو حرف اول یک کلمه ، پیشنهاداتی متناسب با آن برای شما به نمایش گذاشته شود. اگر در هنگام تایپ کردن در یک فیلد قابل ویرایش ، تمایل دارید که پیشنهاداتی متناسب با کلمه مورد نظر داشته باشید ، می توانید این کار را از طریق AutoCompleteTextView انجام دهید. این برنامه به طور خودکار پیشنهاداتی را به کاربر در حال تایپ ارائه می دهد. لیست پیشنهادات در یک منوی بالا به پایین ارائه می شود که کاربر می تواند یک آیتم را انتخاب کرده و آن را جایگزین محتوای در حال ویرایش کند.

برای استفاده از AutoCompleteTextView ، شما باید ابتدا یک فیلد AutoCompletTextView در xml ایجاد کنید. سینتکس آن مانند زیر می باشد :

<AutoCompleteTextView
   android:id="@+id/autoCompleteTextView1"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   android:layout_alignParentTop="true"
   android:layout_centerHorizontal="true"
   android:layout_marginTop="65dp"
   android:ems="10" >

پس از آن شما باید یک مرجع از این textview در جاوا به دست آورید. سینتکس آن در زیر ارائه شده است :

private AutoCompleteTextView actv;
actv = (AutoCompleteTextView) findViewById(R.id.autoCompleteTextView1);

قدم بعدی که لازم است انجام دهید ، تعیین لیست آیتم های پیشنهادی نمایش داده شده می باشد.
شما می توانید آیتم های لیست را به عنوان یک ردیف رشته در جاوا یا رشته های xml مشخص کنید، که سینتکس آن در زیر ارائه شده است:

String[] countries = getResources().getStringArray(R.array.list_of_countries);
ArrayAdapter<String> adapter = new ArrayAdapter<String>
   (this,android.R.layout.simple_list_item_1,countries);
actv.setAdapter(adapter);

کلاس آرایه ی adapter ، مسئول نمایش داده به عنوان لیست ، در جعبه ی پیشنهادات (suggestion box) فیلد متن می باشد.
متد setAdapter برای تنظیم آداپتور  autoCompleteTextView استفاده می شود. علاوه براین متد ها، متد های دیگری از AutoCompelte وجود دارند که در لیست زیر ارائه می شوند :

()getAdapter : این متد یک filterable list adapter (لیست قابل فیلتر آداپتور) را باز می گرداند (return می کند).

()getCompletionHint : این متد متن انتخابی را باز می گرداند (return می کند) که در پایین لیست تطبیقی (matching list)  نمایش داده می شود.

()getDropDownAnchor : این متد id مربوط به ویویی را بازمی گرداند که لیست DropDown که auto complete به آن متصل شده است.

()getListSelection : این متد موقعیت انتخاب ویوی dropdown  را، اگر وجود داشته باشد، باز می گرداند (return می کند).

()isPopupShowing : این متد تعیین می کند که آیا منوی پاپ آپ در حال نمایش است یا نه.

(setText(CharSequence text, boolean filter : این متد متن را تنظیم می کند، به جز آن متنی که فیلترینگ را غیرفعال می کند.

()showDropDown : این متد لیست DropDown را روی صفحه نمایش می دهد.

مثال :

مثال زیر استفاده از کلاس AutoCompleteTextView را توضیح می دهد. این کلاس یک اپلیکیشن  پایه ایجاد می کند که به شما اجازه می دهد تا در آن تایپ کنید و در عین حال پیشنهاد ها را روی دستگاه ، به شما نشان می دهد.

برای آزمایش با این مثال لازم است آن را روی یک دستگاه واقعی یا یک امولاتور اجرا کنید.

1) برای ساخت یک اپلیکیشن اندروید  از Android Studio  استفاده نموده و آن را  تحت پکیج com.example.autocomplete  ایجاد کنید

2) فایل src/MainActivity.java را تغییر دهید تا کد AutoCompleteTextView را اضافه کنید.

3) لی اوت فایل XML (res/layout/activity_main.xml) را تغییر دهید و اگر لازم است مولفه GUI را اضافه کنید.

4) برنامه را اجرا کنید و یک دستگاه اندروید اجرایی را انتحاب کنید و برنامه را روی آن نصب کنید و نتایج را بررسی کنید.

محتوای فایل src/MainActivity.java :

package com.example.sairamkrishna.myapplication;

import android.app.Activity;
import android.content.Context;

import android.media.AudioManager;
import android.media.MediaPlayer;
import android.media.MediaRecorder;

import android.os.Bundle;
import android.os.Environment;

import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.view.animation.Animation;
import android.view.animation.AnimationUtils;

import android.widget.ArrayAdapter;
import android.widget.AutoCompleteTextView;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ImageView;
import android.widget.MultiAutoCompleteTextView;
import android.widget.Toast;
import java.io.IOException;


public class MainActivity extends Activity {
   AutoCompleteTextView text;
   MultiAutoCompleteTextView text1;
   String[] languages={"Android ","java","IOS","SQL","JDBC","Web services"};
   
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      
      text=(AutoCompleteTextView)findViewById(R.id.autoCompleteTextView1);
      text1=(MultiAutoCompleteTextView)findViewById(R.id.multiAutoCompleteTextView1);
      
      ArrayAdapter adapter = new 
         ArrayAdapter(this,android.R.layout.simple_list_item_1,languages);
      
      text.setAdapter(adapter);
      text.setThreshold(1);
      
      text1.setAdapter(adapter);
      text1.setTokenizer(new MultiAutoCompleteTextView.CommaTokenizer());
   }
}

محتوای 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:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Android Auto Complete"
      android:id="@+id/textView"
      android:textSize="30dp"
      android:layout_alignParentTop="true"
      android:layout_alignParentRight="true"
      android:layout_alignParentEnd="true" />
      
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Tutorialspoint"
      android:id="@+id/textView2"
      android:textColor="#ff3eff0f"
      android:textSize="35dp"
      android:layout_below="@+id/textView"
      android:layout_centerHorizontal="true" />
      
   <ImageView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/imageView"
      android:src="@drawable/logo"
      android:layout_below="@+id/textView2"
      android:layout_alignLeft="@+id/textView2"
      android:layout_alignStart="@+id/textView2"
      android:layout_alignRight="@+id/textView2"
      android:layout_alignEnd="@+id/textView2" />
      
   <AutoCompleteTextView
      android:id="@+id/autoCompleteTextView1"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:ems="10"
      android:layout_below="@+id/imageView"
      android:layout_alignLeft="@+id/imageView"
      android:layout_alignStart="@+id/imageView"
      android:layout_marginTop="72dp"
      android:hint="AutoComplete TextView">
      <requestFocus />
   </AutoCompleteTextView>
   
   <MultiAutoCompleteTextView
      android:id="@+id/multiAutoCompleteTextView1"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:ems="10"
      android:layout_below="@+id/autoCompleteTextView1"
      android:layout_alignLeft="@+id/autoCompleteTextView1"
      android:layout_alignStart="@+id/autoCompleteTextView1"
      android:hint="Multi Auto Complete " />
      
</RelativeLayout>

محتوای Strings.xml :

<resources>
   <string name="app_name">My Application</string>
</resources>

محتوای  AndroidManifest.xml :

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

اجازه دهید اپلیکیشن مورد نظر را اجرا کنیم. فرض می کنیم که در هنگام انجام تنظیمات محیط اندروید ، AVD خود را متصل کرده اید.
برای اجرای اپلیکیشن از Android Studio ، یکی از فایل های اکتیویتی برنامه ی خود را باز کنید و روی آیکون Run در نوار ابزار کلیک کنید. Android Studio این اپلیکیشن را روی AVD شما نصب خواهد کرد و AVD شما صفحه ی زیر را نمایش خواهد داد.

حالا فقط روی تکست ویو تایپ کنید تا پیشنهادات را ببینید. به عنوان مثال به محض اینکه من  حرف a را تایپ کردم در پیشنهادات لغت android  ارائه شد.