Window.SystemGestureExclusionRects 屬性

public virtual System.Collections.Generic.IList<Android.Graphics.Rect> SystemGestureExclusionRects { [Android.Runtime.Register("getSystemGestureExclusionRects", "()Ljava/util/List;", "GetGetSystemGestureExclusionRectsHandler", ApiSince=29)] get; [Android.Runtime.Register("setSystemGestureExclusionRects", "(Ljava/util/List;)V", "GetSetSystemGestureExclusionRects_Ljava_util_List_Handler", ApiSince=29)] set; }

[<get: Android.Runtime.Register("getSystemGestureExclusionRects", "()Ljava/util/List;", "GetGetSystemGestureExclusionRectsHandler", ApiSince=29)>]
[<set: Android.Runtime.Register("setSystemGestureExclusionRects", "(Ljava/util/List;)V", "GetSetSystemGestureExclusionRects_Ljava_util_List_Handler", ApiSince=29)>]
member this.SystemGestureExclusionRects : System.Collections.Generic.IList<Android.Graphics.Rect> with get, set

屬性值

此視窗特定系統手勢排除 rect 列表

屬性

RegisterAttribute

備註

財產取得者文件：

取得此視窗座標空間內系統不應攔截觸控或其他指示裝置手勢的區域清單。 這是由設定的 #setSystemGestureExclusionRects(List) 清單，若未被呼叫則為空清單 #setSystemGestureExclusionRects(List) 。 它不包含由此視窗視圖階層設定的排除矩碼。

Java 文件 android.view.Window.getSystemGestureExclusionRects()。

屬性設定文件：

在此視窗的座標空間中，設定系統不應攔截觸控或其他指示裝置手勢的區域清單。

此方法應用於使用 #takeSurface(SurfaceHolder.Callback2) 且沒有檢視階層的應用程式。 有視圖層級的應用程式應該改用 View#setSystemGestureExclusionRects(List) 。 此方法不會修改或替換由視窗 View#setSystemGestureExclusionRects(List)視圖階層中個別視圖所填充的手勢排除矩形。

利用此資訊告訴系統，視圖中哪些特定子區域需要接收手勢輸入，才能在可能衝突的全域系統手勢存在時正常運作。 例如，若系統希望擷取從螢幕邊緣滑入的手勢以提供系統層級的導航功能，例如導航抽屜容器等視圖，可以利用此 API 將自身左邊（或起始邊）標記為需要手勢捕捉優先權。 系統可能會選擇放鬆自己的手勢辨識，讓應用程式能直接接收使用者的手勢。 應用程式不必為廣泛區域（如整個 ScrollView 區域）登記排除 rect，或是簡單的按鍵與釋放點擊目標（如 Button。 在與視圖互動時，標記排除矩形需要在 X 或 Y 維度的小區域內精確觸碰，例如邊緣滑動或拇指拖曳 SeekBar 。

呼叫此方法後，請勿修改所提供的清單。

Java 文件 android.view.Window.setSystemGestureExclusionRects(java.util.List<android.graphics.Rect>)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。