Trình phát hiện cử chỉ

Đã thêm vào API cấp XE12

Trình phát hiện cử chỉ được tối ưu hoá để nhận dạng các cử chỉ chạm cho bàn di chuột.

Có các trình nghe cử chỉ rời rạc (ví dụ: GestureDetector.BaseListener, GestureDetector.FingerListener) và trình nghe cử chỉ liên tục (ví dụ: GestureDetector.ScrollListener, GestureDetector.OneFingerScrollListener, GestureDetector.TwoFingerScrollListener).

Để biết thêm thông tin, hãy xem hướng dẫn cho nhà phát triển về Cử chỉ chạm.

Cách sử dụng chung

  1. Triển khai mọi giao diện trình nghe mong muốn và thiết lập các giao diện đó trên GestureDetector.
  2. Ghi đè các lệnh gọi lại sự kiện đầu vào như onGenericMotionEvent(MotionEvent) hoặc dispatchGenericFocusedEvent(MotionEvent) và truyền MotionEvent đến phương thức onMotionEvent(MotionEvent) của trình phát hiện cử chỉ để xử lý sự kiện.
  3. Xử lý sự kiện một cách thích hợp trong trình nghe trình phát hiện cử chỉ.

    Lưu ý: Khi triển khai các phương thức onXXX cho trình nghe, hãy chỉ đặt giá trị trả về thành true nếu bạn không muốn điều phối MotionEvent đến bất kỳ thực thể nghe nào khác trong quy trình truyền dữ liệu đầu vào.

Lớp lồng ghép
giao diện GestureDetector.BaseListener Nhận kết quả phát hiện. 
giao diện GestureDetector.FingerListener Trình nghe này báo cáo khi số ngón tay đã phát hiện thay đổi trên bàn di chuột. 
giao diện GestureDetector.OneFingerScrollListener Trình nghe này nhận các sự kiện cuộn liên tục theo chiều ngang bằng một ngón tay. 
giao diện GestureDetector.ScrollListener Trình nghe này nhận các sự kiện cuộn liên tục theo chiều ngang không phụ thuộc vào số ngón tay. 
giao diện GestureDetector.TwoFingerScrollListener Trình nghe này nhận các sự kiện cuộn liên tục theo chiều ngang bằng 2 ngón tay. 
Công ty xây dựng công cộng
GestureDetector(Ngữ cảnh Ngữ cảnh)
Phương thức công khai
boolean tĩnh
isForward(Cử chỉ)
boolean tĩnh
isForward(số thực deltaX)
boolean
onMotionEvent(sự kiện MotionEvent)
GestureDetector
setAlwaysConsumeEvents(đã bật boolean)
GestureDetector
setBaseListener(trình nghe GestureDetector.BaseListener)
GestureDetector
setFingerListener(trình nghe GestureDetector.FingerListener)
GestureDetector
setOneFingerScrollListener(trình nghe GestureDetector.OneFingerScrollListener)
GestureDetector
setScrollListener(trình nghe GestureDetector.ScrollListener)
GestureDetector
setTwoFingerScrollListener(trình nghe GestureDetector.TwoFingerScrollListener)
Phương thức kế thừa

Công ty xây dựng công cộng

Đã thêm vào API cấp XE12

công khai GestureDetector (Ngữ cảnh)

Phương thức công khai

Đã thêm vào API cấp XE16

công khai tĩnh boolean isForward (Cử chỉ)

Trả về true nếu cử chỉ đã cho tương ứng với chuyển động tiến trên bàn di chuột.

Phương thức này chỉ phù hợp với các thao tác vuốt ngang và gửi một trường hợp ngoại lệ nếu được gọi trên các cử chỉ khác.

Đã thêm vào API cấp XE16

Public tĩnh boolean isForward (float deltaX)

Trả về true nếu độ dịch chuyển đã cho tương ứng với chuyển động tiến trên bàn di chuột.

Đã thêm vào API cấp XE12

công khai boolean onMotionEvent (sự kiện MotionEvent)

Xử lý một sự kiện chuyển động, trả về true nếu các sự kiện luôn được sử dụng hoặc nếu phát hiện thấy một cử chỉ.

Giá trị trả về
  • phản ánh liệu sự kiện chạm có được sử dụng hay không
Đã thêm vào API cấp XE12

công khai GestureDetector setAlwaysConsumeEvents (boolean enabled)

Thiết lập xem trình phát hiện cử chỉ có sử dụng các sự kiện được truyền đến onMotionEvent(MotionEvent) hay không, bất kể các sự kiện đó có thực sự được xử lý hay không.

Đã thêm vào API cấp XE12

công khai GestureDetector setBaseListener (trình nghe GestureDetector.BaseListener)

Thiết lập trình nghe cử chỉ cơ bản.

Đã thêm vào API cấp XE12

công khai GestureDetector setFingerListener (trình nghe GestureDetector.FingerListener)

Thiết lập trình nghe ngón tay.

Đã thêm vào API cấp XE21

công khai GestureDetector setOneFingerScrollListener (trình nghe GestureDetector.OneFingerScrollListener)

Thiết lập trình nghe phát hiện thao tác cuộn theo chiều ngang và thao tác cuộn bằng một ngón tay.

Đã thêm vào API cấp XE12

công khai GestureDetector setScrollListener (trình nghe GestureDetector.ScrollListener)

Thiết lập trình nghe phát hiện thao tác cuộn theo chiều ngang không phụ thuộc vào số ngón tay.

Đã thêm vào API cấp XE12

công khai GestureDetector setTwoFingerScrollListener (trình nghe GestureDetector.TwoFingerScrollListener)

Thiết lập trình nghe phát hiện thao tác cuộn theo chiều ngang và thao tác cuộn bằng hai ngón tay.