Obsługa zdarzeń dotknięcia w elemencie ViewGroup wymaga szczególnej ostrożności, ponieważ często zdarza się, że elementy podrzędne ViewGroup są celem kierowania na inne zdarzenia kliknięcia niż sam element ViewGroup. Aby mieć pewność, że każdy widok prawidłowo otrzymuje wymagane zdarzenia dotknięcia, zastąp metodę onInterceptTouchEvent().
Zapoznaj się z tymi powiązanymi materiałami:
Przechwytywanie zdarzeń dotknięcia w grupie widoków
Metoda onInterceptTouchEvent() jest wywoływana za każdym razem, gdy zostanie wykryte zdarzenie dotknięcia na powierzchni elementu ViewGroup, w tym na powierzchni jego elementów podrzędnych. Jeśli funkcja onInterceptTouchEvent() zwraca wartość true, element MotionEvent jest przechwytywany, co oznacza, że nie jest przekazywany do elementu podrzędnego, a do metody onTouchEvent() elementu nadrzędnego.
Metoda onInterceptTouchEvent() daje wydawcy nadrzędnemu możliwość zobaczenia zdarzeń dotknięcia, zanim zrobią to jego elementy podrzędne. Jeśli zwrócisz parametr true z metody onInterceptTouchEvent(), widok podrzędny, który wcześniej przetwarzał zdarzenia kliknięcia, otrzyma ACTION_CANCEL, a te od tego momentu zdarzenia będą wysyłane do metody onTouchEvent() obiektu nadrzędnego w zwykły sposób. onInterceptTouchEvent() może też zwracać wartość false i szpiegować zdarzenia, gdy przechodzą w dół hierarchii widoków do standardowych celów, które obsługują zdarzenia z własnym onTouchEvent().
W tym fragmencie kodu klasa MyViewGroup jest rozszerzeniem ViewGroup.
Element MyViewGroup ma wiele widoków podrzędnych. Jeśli przeciągniesz palcem w poziomie do widoku podrzędnego, widok podrzędny nie będzie już rejestrować zdarzeń dotknięcia, a MyViewGroup obsługuje takie zdarzenia, przewijając jego zawartość. Jeśli jednak klikniesz przyciski w widoku podrzędnym lub przewiniesz widok podrzędny w pionie, element nadrzędny nie przechwyci tych zdarzeń dotknięcia, ponieważ jest nim zamierzony element podrzędny. W takich przypadkach onInterceptTouchEvent() zwraca false i onTouchEvent() klasy MyViewGroup nie jest wywoływany.
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(). Element ViewGroup wywołuje tę metodę, gdy podmiot podrzędny nie chce, aby element nadrzędny i jego elementy nadrzędne przechwytywały zdarzenia dotyku za pomocą metody onInterceptTouchEvent().
Przetwarzaj zdarzenia ACTION_OUTSIDE
Jeśli ViewGroup otrzymuje element MotionEvent z ACTION_OUTSIDE, zdarzenie nie jest domyślnie wysyłane do elementów podrzędnych. Aby przetworzyć MotionEvent za pomocą ACTION_OUTSIDE, zastąp dispatchTouchEvent(MotionEvent event), aby wysłać żądanie do odpowiedniego View, lub podaj go w odpowiednim Window.Callback, np. Activity.
Używanie stałych ViewConfiguration
Poprzedni fragment kodu korzysta z bieżącej wartości ViewConfiguration do inicjowania zmiennej o nazwie mTouchSlop. Klasa ViewConfiguration pozwala uzyskać dostęp do typowych odległości, prędkości i czasów używanych przez system Android.
Termin „odległość dotyku” odnosi się do odległości w pikselach, po której użytkownik może się poruszać po dotknięciu, zanim gest zostanie zinterpretowany jako przewijanie. Pulpit dotykowy służy zwykle do zapobiegania przypadkowemu przewijaniu, gdy użytkownik wykonuje inną operację dotykową, np. dotyka elementów na ekranie.
Dwie inne często używane metody ViewConfiguration to getScaledMinimumFlingVelocity() i getScaledMaximumFlingVelocity().
Te metody zwracają odpowiednio prędkość minimalną i maksymalną, aby zainicjować rzut mierzony 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.
}
}
Rozszerzaj obszar dotykowy widoku dziecka
Android udostępnia klasę TouchDelegate, która umożliwia rodzicowi rozszerzenie dotykowego obszaru widoku podrzędnego poza granice tego obszaru. Jest to przydatne, gdy dziecko jest małe, ale potrzebuje większego obszaru dotykowego. W ten sposób możesz też zmniejszyć obszar dotyku dziecka.
W poniższym przykładzie element ImageButton to _delegate view_ (widok danych delegate), czyli element podrzędny, którego obszar dotykowy obejmuje obszar nadrzędny. Oto plik szablonu:
<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 element nadrzędny skonfiguruje elementy podrzędne, zanim wywoła metodęgetHitRect(). MetodagetHitRect()pobiera prostokąt działania elementu podrzędnego (czyli obszar dotykowy) we współrzędnych obiektu nadrzędnego. - Wyszukuje widok podrzędny
ImageButtoni wywołuje metodęgetHitRect(), aby ustalić granice obszaru dotyku dziecka. - Rozszerza granice prostokąta działań w widoku podrzędnym
ImageButton. - Tworzy instancję
TouchDelegate, przekazując jako parametry rozwinięty prostokąt działania i widok podrzędnyImageButton. - Ustawia obiekt
TouchDelegatew widoku nadrzędnym, tak aby dotknięcia w granicach tej funkcji są kierowane do elementu podrzędnego.
Jako delegat dotyk w widoku podrzędnym ImageButton widok nadrzędny otrzymuje wszystkie zdarzenia dotknięcia. Jeśli zdarzenie dotknięcia występuje w prostokącie trafienia elementu podrzędnego, element nadrzędny przekazuje to zdarzenie do elementu podrzędnego w celu obsługi.
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);
}
}
});
}
}