Obsługa zdarzeń dotknięcia w ViewGroup jest dosyć ostrożna, ponieważ ViewGroup często ma elementy podrzędne, które są celem innych zdarzeń dotknięcia niż sama zasada ViewGroup. Aby mieć pewność, że każda widoczność poprawnie odbiera przeznaczone dla niej zdarzenia dotyku, zastąpij metodę onInterceptTouchEvent().
Zapoznaj się z tymi materiałami:
Przechwytywanie zdarzeń dotyku w grupie widoków
Metoda onInterceptTouchEvent() jest wywoływana, gdy zostanie wykryte zdarzenie dotyku na powierzchni elementu ViewGroup, w tym na powierzchniach jego elementów podrzędnych. Jeśli funkcja onInterceptTouchEvent() zwraca wartość true, wartość MotionEvent zostaje przechwycona, co oznacza, że nie jest ona przekazywana dziecku, ale do metody onTouchEvent() rodzica.
Metoda onInterceptTouchEvent() daje widokowi nadrzędnemu możliwość wyświetlenia zdarzeń dotykowych przed ich wyświetleniem przez widoki podrzędne. Jeśli z metody onInterceptTouchEvent() zwrócona zostanie wartość true, widok podrzędny, który wcześniej obsługiwał zdarzenia dotykowe, otrzyma zdarzenie ACTION_CANCEL, a zdarzenia od tego momentu będą wysyłane do metody onTouchEvent() widoku nadrzędnego w celu zwykłego ich obsługi. onInterceptTouchEvent() może również zwracać wartość false i szpiegować zdarzenia, gdy przesuwają się w dół hierarchii widoku, do standardowych celów, które obsługują zdarzenia za pomocą własnych onTouchEvent().
W tym fragmencie kodu klasa MyViewGroup rozszerza klasę ViewGroup.
MyViewGroup zawiera wiele widoków podrzędnych. Jeśli przeciągniesz palcem poziomo w widoku podrzędnym, w widoku podrzędnym nie będą już rejestrowane zdarzenia dotknięcia, a MyViewGroup będzie obsługiwać zdarzenia dotknięcia, przewijając ich zawartość. Jeśli jednak klikniesz przyciski w widoku podrzędnym lub przewiniesz go w poziomie, widok nadrzędny nie przechwyci tych zdarzeń dotykowych, ponieważ widok podrzędny jest docelowym miejscem ich wystąpienia. W takich przypadkach onInterceptTouchEvent() zwraca false, a onTouchEvent() klasy MyViewGroup nie jest wywoływane.
Kotlin
class MyViewGroup @JvmOverloads constructor(
context: Context,
private val mTouchSlop: Int = ViewConfiguration.get(context).scaledTouchSlop
) : ViewGroup(context) {
...
override fun onInterceptTouchEvent(ev: MotionEvent): Boolean {
// This method only determines whether you want to intercept the motion.
// If this method returns true, onTouchEvent is called and you can do
// the actual scrolling there.
return when (ev.actionMasked) {
// Always handle the case of the touch gesture being complete.
MotionEvent.ACTION_CANCEL, MotionEvent.ACTION_UP -> {
// Release the scroll.
mIsScrolling = false
false // Don't intercept the touch event. Let the child handle it.
}
MotionEvent.ACTION_MOVE -> {
if (mIsScrolling) {
// You're currently scrolling, so intercept the touch event.
true
} else {
// If the user drags their finger horizontally more than the
// touch slop, start the scroll.
// Left as an exercise for the reader.
val xDiff: Int = calculateDistanceX(ev)
// Touch slop is calculated using ViewConfiguration constants.
if (xDiff > mTouchSlop) {
// Start scrolling!
mIsScrolling = true
true
} else {
false
}
}
}
...
else -> {
// In general, don't intercept touch events. The child view
// handles them.
false
}
}
}
override fun onTouchEvent(event: MotionEvent): Boolean {
// Here, you actually handle the touch event. For example, if the action
// is ACTION_MOVE, scroll this container. This method is only called if
// the touch event is intercepted in onInterceptTouchEvent.
...
}
}
Java
public class MyViewGroup extends ViewGroup {
private int mTouchSlop;
...
ViewConfiguration vc = ViewConfiguration.get(view.getContext());
mTouchSlop = vc.getScaledTouchSlop();
...
@Override
public boolean onInterceptTouchEvent(MotionEvent ev) {
// This method only determines whether you want to intercept the motion.
// If this method returns true, onTouchEvent is called and you can do
// the actual scrolling there.
final int action = MotionEventCompat.getActionMasked(ev);
// Always handle the case of the touch gesture being complete.
if (action == MotionEvent.ACTION_CANCEL || action == MotionEvent.ACTION_UP) {
// Release the scroll.
mIsScrolling = false;
return false; // Don't intercept touch event. Let the child handle it.
}
switch (action) {
case MotionEvent.ACTION_MOVE: {
if (mIsScrolling) {
// You're currently scrolling, so intercept the touch event.
return true;
}
// If the user drags their finger horizontally more than the
// touch slop, start the scroll.
// Left as an exercise for the reader.
final int xDiff = calculateDistanceX(ev);
// Touch slop is calculated using ViewConfiguration constants.
if (xDiff > mTouchSlop) {
// Start scrolling.
mIsScrolling = true;
return true;
}
break;
}
...
}
// In general, don't intercept touch events. The child view handles them.
return false;
}
@Override
public boolean onTouchEvent(MotionEvent ev) {
// Here, you actually handle the touch event. For example, if the
// action is ACTION_MOVE, scroll this container. This method is only
// called if the touch event is intercepted in onInterceptTouchEvent.
...
}
}
Pamiętaj, że ViewGroup udostępnia też metodę requestDisallowInterceptTouchEvent(). ViewGroup wywołuje tę metodę, gdy podrzędny nie chce, aby nadrzędny ani jego przodkowie przechwytywały zdarzenia dotyku za pomocą onInterceptTouchEvent().
Przetwarzanie zdarzeń ACTION_OUTSIDE
Jeśli ViewGroup otrzymuje MotionEvent z ACTION_OUTSIDE, zdarzenie nie jest domyślnie wysyłane do jego podrzędnych. Aby przetworzyć MotionEvent z ACTION_OUTSIDE, zastąpić dispatchTouchEvent(MotionEvent event), aby wysłać do odpowiedniego View, lub obsłużyć go w odpowiednim Window.Callback, na przykład Activity.
Korzystanie z konstant ViewConfiguration
Poprzedni fragment kodu używa bieżącej wartości ViewConfiguration do zainicjowania zmiennej o nazwie mTouchSlop. Klasa ViewConfiguration umożliwia dostęp do typowych odległości, prędkości i czasów używanych przez system Android.
„Dopuszczalne odchylenie” to odległość w pikselach, jaką może odbiegać od dotyku użytkownika, zanim gest zostanie zinterpretowany jako przewijanie. Obszar dotyku jest zwykle używany do zapobiegania przypadkowemu przewijaniu, gdy użytkownik wykonuje inną operację dotykową, na przykład dotykając elementów na ekranie.
Dwie inne powszechnie używane metody ViewConfiguration to getScaledMinimumFlingVelocity() i getScaledMaximumFlingVelocity().
Te metody zwracają odpowiednio minimalną i maksymalną prędkość, aby zainicjować przesunięcie mierzone w pikselach na sekundę. Na przykład:
Kotlin
private val vc: ViewConfiguration = ViewConfiguration.get(context)
private val mSlop: Int = vc.scaledTouchSlop
private val mMinFlingVelocity: Int = vc.scaledMinimumFlingVelocity
private val mMaxFlingVelocity: Int = vc.scaledMaximumFlingVelocity
...
MotionEvent.ACTION_MOVE -> {
...
val deltaX: Float = motionEvent.rawX - mDownX
if (Math.abs(deltaX) > mSlop) {
// A swipe occurs, do something.
}
return false
}
...
MotionEvent.ACTION_UP -> {
...
if (velocityX in mMinFlingVelocity..mMaxFlingVelocity && velocityY < velocityX) {
// The criteria are satisfied, do something.
}
}
Java
ViewConfiguration vc = ViewConfiguration.get(view.getContext());
private int mSlop = vc.getScaledTouchSlop();
private int mMinFlingVelocity = vc.getScaledMinimumFlingVelocity();
private int mMaxFlingVelocity = vc.getScaledMaximumFlingVelocity();
...
case MotionEvent.ACTION_MOVE: {
...
float deltaX = motionEvent.getRawX() - mDownX;
if (Math.abs(deltaX) > mSlop) {
// A swipe occurs, do something.
}
...
case MotionEvent.ACTION_UP: {
...
} if (mMinFlingVelocity <= velocityX && velocityX <= mMaxFlingVelocity
&& velocityY < velocityX) {
// The criteria are satisfied, do something.
}
}
Rozszerzanie obszaru dotykowego widoku podrzędnego
Android udostępnia klasę TouchDelegate, aby umożliwić wyświetlanie obszaru dotykowego widoku podrzędnego poza jego granice. Jest to przydatne, gdy dziecko jest małe, ale potrzebuje większego obszaru dotykowego. Możesz też użyć tego podejścia, aby zmniejszyć obszar dotykowy dziecka.
W tym przykładzie ImageButton jest _widokiem delegowanym_, czyli elementem podrzędnym, którego obszar dotykowy jest rozszerzany przez element nadrzędny. Oto plik układu:
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/parent_layout"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity" >
<ImageButton android:id="@+id/button"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:background="@null"
android:src="@drawable/icon" />
</RelativeLayout>
Ten fragment kodu wykonuje te zadania:
- Pobiera widok nadrzędny i publikuje
Runnablew wątku interfejsu. Dzięki temu rodzic może ustawić swoje dzieci przed wywołaniem metodygetHitRect(). MetodagetHitRect()pobiera prostokąt docelowy (lub dotykalny obszar) podrzędnego w uwzględnieniu współrzędnych rodzica. - Znajduje widok podrzędny
ImageButtoni wywołujegetHitRect(), aby uzyskać granice obszaru dotykowego podrzędnego. - Rozszerza granice prostokąta docelowego widoku podrzędnego
ImageButton. - Tworzy instancję
TouchDelegate, przekazując jako parametry rozszerzony prostokąt dopasowania i widok podrzędnyImageButton. - Ustawia
TouchDelegatew widoku rodzica, aby dotknięcia w zakresie delegowania dotykiem były kierowane do widoku dziecka.
W widoku podrzędnym ImageButton widok nadrzędny może odbierać wszystkie zdarzenia dotyku. Jeśli zdarzenie dotyku występuje w prostokącie docelowym elementu podrzędnego, element nadrzędny przekazuje zdarzenie dotyku do elementu podrzędnego w celu jego obsłużenia.
Kotlin
public class MainActivity : Activity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
// Post in the parent's message queue to make sure the parent lays out
// its children before you call getHitRect().
findViewById<View>(R.id.parent_layout).post {
// The bounds for the delegate view, which is an ImageButton in this
// example.
val delegateArea = Rect()
val myButton = findViewById<ImageButton>(R.id.button).apply {
isEnabled = true
setOnClickListener {
Toast.makeText(
this@MainActivity,
"Touch occurred within ImageButton touch region.",
Toast.LENGTH_SHORT
).show()
}
// The hit rectangle for the ImageButton.
getHitRect(delegateArea)
}
// Extend the touch area of the ImageButton beyond its bounds on the
// right and bottom.
delegateArea.right += 100
delegateArea.bottom += 100
// Set the TouchDelegate on the parent view so that touches within
// the touch delegate bounds are routed to the child.
(myButton.parent as? View)?.apply {
// Instantiate a TouchDelegate. "delegateArea" is the bounds in
// local coordinates of the containing view to be mapped to the
// delegate view. "myButton" is the child view that receives
// motion events.
touchDelegate = TouchDelegate(delegateArea, myButton)
}
}
}
}
Java
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// Get the parent view.
View parentView = findViewById(R.id.parent_layout);
parentView.post(new Runnable() {
// Post in the parent's message queue to make sure the parent lays
// out its children before you call getHitRect().
@Override
public void run() {
// The bounds for the delegate view, which is an ImageButton in
// this example.
Rect delegateArea = new Rect();
ImageButton myButton = (ImageButton) findViewById(R.id.button);
myButton.setEnabled(true);
myButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Toast.makeText(MainActivity.this,
"Touch occurred within ImageButton touch region.",
Toast.LENGTH_SHORT).show();
}
});
// The hit rectangle for the ImageButton.
myButton.getHitRect(delegateArea);
// Extend the touch area of the ImageButton beyond its bounds on
// the right and bottom.
delegateArea.right += 100;
delegateArea.bottom += 100;
// Instantiate a TouchDelegate. "delegateArea" is the bounds in
// local coordinates of the containing view to be mapped to the
// delegate view. "myButton" is the child view that receives
// motion events.
TouchDelegate touchDelegate = new TouchDelegate(delegateArea,
myButton);
// Set the TouchDelegate on the parent view so that touches
// within the touch delegate bounds are routed to the child.
if (View.class.isInstance(myButton.getParent())) {
((View) myButton.getParent()).setTouchDelegate(touchDelegate);
}
}
});
}
}