Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
Added in API level 1
public static interface

View.OnKeyListener

android.view.View.OnKeyListener

Class Overview

Interface definition for a callback to be invoked when a hardware key event is dispatched to this view. The callback will be invoked before the key event is given to the view. This is only useful for hardware keyboards; a software input method has no obligation to trigger this listener.

Summary

Public Methods
abstract boolean onKey ( View v, int keyCode, KeyEvent event)
Called when a hardware key is dispatched to a view.

Public Methods

public abstract boolean onKey ( View v, int keyCode, KeyEvent event)

Added in API level 1

Called when a hardware key is dispatched to a view. This allows listeners to get a chance to respond before the target view.

Key presses in software keyboards will generally NOT trigger this method, although some may elect to do so in some situations. Do not assume a software input method has to be key-based; even if it is, it may use key presses in a different way than you expect, so there is no way to reliably catch soft input key presses.

Parameters
v The view the key has been dispatched to.
keyCode The code for the physical key that was pressed
event The KeyEvent object containing full information about the event.
Returns
  • True if the listener has consumed the event, false otherwise.