Share via


WindowInsets.SystemGestureInsets Property

Definition

Returns the system gesture insets.

public Android.Graphics.Insets SystemGestureInsets { [Android.Runtime.Register("getSystemGestureInsets", "()Landroid/graphics/Insets;", "", ApiSince=29)] get; }
[<get: Android.Runtime.Register("getSystemGestureInsets", "()Landroid/graphics/Insets;", "", ApiSince=29)>]
member this.SystemGestureInsets : Android.Graphics.Insets

Property Value

Attributes

Remarks

Returns the system gesture insets.

The system gesture insets represent the area of a window where system gestures have priority and may consume some or all touch input, e.g. due to the a system bar occupying it, or it being reserved for touch-only gestures.

An app can declare priority over system gestures with View#setSystemGestureExclusionRects outside of the #getMandatorySystemGestureInsets() mandatory system gesture insets.

Note: the system will put a limit of 200dp on the vertical extent of the exclusions it takes into account. The limit does not apply while the navigation bar is View#SYSTEM_UI_FLAG_IMMERSIVE_STICKY stickily hidden, nor to the android.inputmethodservice.InputMethodService input method and Intent#CATEGORY_HOME home activity.

Simple taps are guaranteed to reach the window even within the system gesture insets, as long as they are outside the #getTappableElementInsets() system window insets.

When View#SYSTEM_UI_FLAG_LAYOUT_STABLE is requested, an inset will be returned even when the system gestures are inactive due to View#SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or View#SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION.

This inset is consumed together with the #getSystemWindowInsets() system window insets by #consumeSystemWindowInsets().

This member is deprecated. Use #getInsets(int) with Type#systemGestures() instead.

Java documentation for android.view.WindowInsets.getSystemGestureInsets().

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to