آموزش کار با صفحه لمسی در اندروید با چند مثال

Gesture در واقع مربوط به حرکات لمس صفحه و کوچک و بزرگ کردن تصاویر است ؛ اندروید انواع خاصی از لمس صفحه را ارائه می دهد که عبارتند از:

• فشار دادن (pinch)
• ضربه ی دوتایی (double tap)
• فهرست ها (scrolls)
• فشار طولانی مدت (long presses)
• flinch 

اندروید کلاس GestureDetector را ارائه می دهد تا event های Gesture را دریافت کرده و به ما بگوید که آیا این رویداد ها با Gesture (رفتار) منطبق هستند یا نه.
برای استفاده از آن لازم است یک آبجکت از GestureDetector ایجاد کنید و سپس یک کلاس دیگر با GestureDetector.SimpleOnGestureListener گسترش دهید تا مانند یک شنونده عمل کنید و بعضی از متدها را override کنید.
سینتکس آن را می توانید در زیر ببینید :

GestureDetector myG;
myG = new GestureDetector(this,new Gesture());
   
class Gesture extends GestureDetector.SimpleOnGestureListener{
   public boolean onSingleTapUp(MotionEvent ev) {
   }
   
   public void onLongPress(MotionEvent ev) {
   }
   
   public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX,
   float distanceY) {
   }
   
   public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
   float velocityY) {
   }
}

 رفتار pinch:

اندروید برای اداره Gesture ( رفتار) pinch ، کلاس ScaleGestureDetector را ایجاد می کند.
برای استفاده از این کلاس لازم است که یک آبجکت از این کلاس را نمونه گذاری کنید که سینتکس آن را در زیر می بینید  :

ScaleGestureDetector SGD;
SGD = new ScaleGestureDetector(this,new ScaleListener());

اولین پارامتر کانتکست (context) و دومین پارامتر شنونده ی رویداد (event listener) می باشد. ما باید رویداد شنونده را تعریف کرده و از تابع OnTouchEvent برای به کار انداختن آن استفاده کنیم.
سینتکس آن را در زیر می بینید :

public boolean onTouchEvent(MotionEvent ev) {
   SGD.onTouchEvent(ev);
   return true;
}

private class ScaleListener extends ScaleGestureDetector.SimpleOnScaleGestureListener {
   @Override
   public boolean onScale(ScaleGestureDetector detector) {
      float scale = detector.getScaleFactor();
      return true;
   }
}

علاوه بر pinch، متد های دیگری هم وجود دارند که در مورد رویداد های لمس (touch event) بیشتر توضیح می دهند.
لیست آن ها در زیر ارائه شده اند :

• ()getEventTime : این متد زمان پردازش شدن ، زمان رویداد را به دست می آورد.
• ()getFocusX : این متد مختصات X را از نقطه ی کانونی آخرین حرکت (gesture ) به دست می آورد.
• ()getFocusY : این متد مختصات Y را از نقطه ی کانونی آخرین حرکت (gesture ) به دست می آورد.
• ()getTimeDelta : این متد تفاوت زمانی بین مقیاس رویداد قبلی و مقیاس رویداد کنونی به یک هزارم ثانیه (milliseconds) بر می گرداند.
• ()isInProgress : این متد بولین ، اگر مقیاس یک حرکت (gesture ) در حال پیشروی باشد ، true را باز می گردد.
• (onTouchEvent(MotionEvent event : این متد MotionEvents را قبول کرده و اگر رویداد ها مناسب باشند ، می فرستد.

مثال :

در اینجا مثالی را می بینید که استفاده از کلاس ScaleGestureDetector را توضیح می دهد.
این مثال یک اپلیکیشن  پایه ایجاد می کند که به شما اجازه می دهد تا از طریق pinch  چیزی را زوم کنید یا از حالت زوم خارج شوید.
برای آزمایش با این مثال به یک دستگاه واقعی یا یک امولاتور با صفحه ی لمسی فعال نیاز خواهید داشت.

1. برای ایجاد یک اپلیکیشن اندروید از Android studio  تحت پکیج  com.example. gestures استفاده نمایید.
2. فایل src/MainActivity.java را برای افزودن کد لازم تغییر دهید.
3. res/layout/activity_main را برای افزودن کامپوننت های XML مربوطه تغییر دهید.
4. برنامه را اجرا کرده و یک دستگاه اجرایی اندروید انتخاب کنید و برنامه را روی آن نصب کنید و نتایج را بررسی کنید.

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

package com.example.sairamkrishna.myapplication;

import android.app.Activity;
import android.graphics.Matrix;
import android.os.Bundle;

import android.view.MotionEvent;
import android.view.ScaleGestureDetector;
import android.widget.ImageView;

public class MainActivity extends Activity {
   private ImageView iv;
   private Matrix matrix = new Matrix();
   private float scale = 1f;
   private ScaleGestureDetector SGD;

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

      iv=(ImageView)findViewById(R.id.imageView);
      SGD = new ScaleGestureDetector(this,new ScaleListener());
   }

   public boolean onTouchEvent(MotionEvent ev) {
      SGD.onTouchEvent(ev);
      return true;
   }

   private class ScaleListener extends ScaleGestureDetector.
      SimpleOnScaleGestureListener {
      
      @Override
      public boolean onScale(ScaleGestureDetector detector) {
         scale *= detector.getScaleFactor();
         scale = Math.max(0.1f, Math.min(scale, 5.0f));
         matrix.setScale(scale, scale);
         iv.setImageMatrix(matrix);
         return true;
      }
   }
}

محتوای تغییر یافته فایل res/layout/activity_main.xml :

<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:text="Gestures  
      Example" android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textview"
      android:textSize="35dp"
      android:layout_alignParentTop="true"
      android:layout_centerHorizontal="true" />
      
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Tutorials point"
      android:id="@+id/textView"
      android:layout_below="@+id/textview"
      android:layout_centerHorizontal="true"
      android:textColor="#ff7aff24"
      android:textSize="35dp" />
      
   <ImageView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/imageView"
      android:src="@drawable/abc"
      android:scaleType="matrix"
      android:layout_below="@+id/textView"
      android:layout_alignParentLeft="true"
      android:layout_alignParentStart="true"
      android:layout_alignParentBottom="true"
      android:layout_alignParentRight="true"
      android:layout_alignParentEnd="true" />
      
</RelativeLayout>

محتوای res/values/string.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.myapplicationMainActivity"
         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>

اجازه بدهید اپلیکیشن را اجرا کنیم. فرض می کنیم که دستگاه موبایل اندروید خود را به کامپیوتر متصل کرده اید. برای اجرای برنامه از Android studio ، یکی از فایل های اکتیویتی پروژه را باز کرده و روی آیکون Run از نوار ابزار کلیک کنید.

اکنون دو انگشت را روی صفحه ی اندروید قرار داده و آن ها را از هم دور کنید. خواهید دید که تصویر اندروید بزرگتر می شود. مانند تصویر زیر:

حال دوباره دو انگشت را روی صفحه قرار داده و آنها را به هم نزدیک کنید، خواهید دید که تصویر اندروید کوچکتر می شود، مانند تصویر زیر: