Activity.OnKeyDown(Keycode, KeyEvent) Method

Definition

Namespace:: Android.App

Assembly:: Mono.Android.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Called when a key was pressed down and not handled by any of the views inside of the activity.

[Android.Runtime.Register("onKeyDown", "(ILandroid/view/KeyEvent;)Z", "GetOnKeyDown_ILandroid_view_KeyEvent_Handler")]
public virtual bool OnKeyDown(Android.Views.Keycode keyCode, Android.Views.KeyEvent? e);

[<Android.Runtime.Register("onKeyDown", "(ILandroid/view/KeyEvent;)Z", "GetOnKeyDown_ILandroid_view_KeyEvent_Handler")>]
abstract member OnKeyDown : Android.Views.Keycode * Android.Views.KeyEvent -> bool
override this.OnKeyDown : Android.Views.Keycode * Android.Views.KeyEvent -> bool

Parameters

keyCode: Keycode

The value in event.getKeyCode().

e: KeyEvent

Description of the key event.

Returns

Boolean

Return true to prevent this event from being propagated further, or false to indicate that you have not handled this event and it should continue to be propagated.

Implements

OnKeyDown(Keycode, KeyEvent)

Attributes: RegisterAttribute

Remarks

Called when a key was pressed down and not handled by any of the views inside of the activity. So, for example, key presses while the cursor is inside a TextView will not trigger the event (unless it is a navigation to another object) because TextView handles its own key presses.

If the focused view didn't want this event, this method is called.

The default implementation takes care of KeyEvent#KEYCODE_BACK by calling #onBackPressed(), though the behavior varies based on the application compatibility mode: for android.os.Build.VERSION_CODES#ECLAIR or later applications, it will set up the dispatch to call #onKeyUp where the action will be performed; for earlier applications, it will perform the action immediately in on-down, as those versions of the platform behaved. This implementation will also take care of KeyEvent#KEYCODE_ESCAPE by finishing the activity if it would be closed by touching outside of it.

Other additional default key handling may be performed if configured with #setDefaultKeyMode.

Java documentation for android.app.Activity.onKeyDown(int, android.view.KeyEvent).

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

Share via