안드로이드에서 ACTION_DOWN(액션 다운) 이벤트를 사용하는 방법

안드로이드에서 ACTION_DOWN 이벤트란?

ACTION_DOWN은 사용자가 화면을 처음 터치하는 순간 발생하는 모션 이벤트입니다. 안드로이드의 모든 터치 제스처는 ACTION_DOWN으로 시작되며, 이후 손가락을 움직이면 ACTION_MOVE, 화면에서 떼면 ACTION_UP 이벤트가 순차적으로 발생합니다. 따라서 터치 기반 인터랙션을 구현할 때 ACTION_DOWN 감지는 가장 기본이 되는 처리 로직입니다.

이 글에서는 TextView 위젯에 터치 리스너를 등록하여 ACTION_DOWN 이벤트를 감지하고, 터치 발생 시 토스트 메시지를 표시하는 간단한 예제를 단계별로 살펴보겠습니다.

1단계: 새 프로젝트 생성

Android Studio를 실행한 후 File → New Project 메뉴로 이동하여 새 프로젝트를 생성합니다. 프로젝트 생성에 필요한 모든 세부 정보를 입력한 뒤 빈 액티비티(Empty Activity) 템플릿을 선택하면 됩니다.

2단계: 레이아웃 파일 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:gravity="center"
    android:layout_height="match_parent"
    tools:context=".MainActivity"
    android:orientation="vertical">
    <TextView
        android:id="@+id/actionEvent"
        android:textSize="40sp"
        android:layout_marginTop="30dp"
        android:layout_width="wrap_content"
        android:layout_height="match_parent" />
</LinearLayout>

위 코드에서는 화면 중앙에 하나의 TextView를 배치했습니다. 이 TextView가 ACTION_DOWN 이벤트를 감지하는 대상 위젯입니다.

3단계: MainActivity에 터치 리스너 구현

src/MainActivity.java 파일에 아래 코드를 추가합니다.

package com.example.myapplication;

import android.annotation.SuppressLint;
import android.os.Build;
import android.os.Bundle;
import android.support.annotation.RequiresApi;
import android.support.v4.view.MotionEventCompat;
import android.support.v7.app.AppCompatActivity;
import android.view.MotionEvent;
import android.view.View;
import android.widget.TextView;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {
    TextView textView;
    @SuppressLint({"RestrictedApi", "ClickableViewAccessibility"})
    @RequiresApi(api = Build.VERSION_CODES.N)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        TextView actionEvent = findViewById(R.id.actionEvent);
        actionEvent.setText("Action Down");
        actionEvent.setOnTouchListener(new View.OnTouchListener() {
            @Override
            public boolean onTouch(View v, MotionEvent event) {
                int action = MotionEventCompat.getActionMasked(event);
                if (action == MotionEvent.ACTION_DOWN) {
                    Toast.makeText(MainActivity.this, "Clicked on textview", Toast.LENGTH_LONG).show();
                    return true;
                }
                return false;
            }
        });
    }
}

코드 핵심 설명

위 코드의 핵심은 setOnTouchListener()를 통해 TextView에 OnTouchListener를 등록하는 부분입니다. 터치가 발생하면 MotionEventCompat.getActionMasked(event) 메서드가 이벤트의 액션 타입을 추출하고, 이 값이 MotionEvent.ACTION_DOWN과 일치하는 경우 — 즉 사용자가 화면을 처음 눌렀을 때 — 토스트 메시지를 화면에 표시합니다.

여기서 주의할 점은 onTouch() 메서드의 반환값입니다. true를 반환하면 해당 이벤트를 소비(consume)했음을 의미하여 이후 이벤트(MOVE, UP 등)도 계속 전달받을 수 있고, false를 반환하면 이벤트 처리를 중단하게 됩니다.

실행 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기를 컴퓨터에 연결한 상태라고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일을 열고 툴바의 Run 아이콘을 클릭하세요. 실행 옵션 목록에서 연결된 모바일 기기를 선택하면, 기본 화면이 표시됩니다.

화면에 나타난 TextView를 손가락으로 누르는 순간 ACTION_DOWN 이벤트가 발생하며, "Clicked on textview"라는 토스트 메시지가 화면 하단에 나타나는 것을 확인할 수 있습니다.