Android APIs
public class

QwertyKeyListener

extends BaseKeyListener
java.lang.Object
   ↳ android.text.method.MetaKeyKeyListener
     ↳ android.text.method.BaseKeyListener
       ↳ android.text.method.QwertyKeyListener

Class Overview

This is the standard key listener for alphabetic input on qwerty keyboards. You should generally not need to instantiate this yourself; TextKeyListener will do it for you.

As for all implementations of KeyListener, this class is only concerned with hardware keyboards. Software input methods have no obligation to trigger the methods in this class.

Summary

[Expand]
Inherited Constants
From class android.text.method.MetaKeyKeyListener
Public Constructors
QwertyKeyListener(TextKeyListener.Capitalize cap, boolean autoText)
Public Methods
int getInputType()
static QwertyKeyListener getInstance(boolean autoText, TextKeyListener.Capitalize cap)
Returns a new or existing instance with the specified capitalization and correction properties.
static QwertyKeyListener getInstanceForFullKeyboard()
Gets an instance of the listener suitable for use with full keyboards.
static void markAsReplaced(Spannable content, int start, int end, String original)
Marks the specified region of content as having contained original prior to AutoText replacement.
boolean onKeyDown(View view, Editable content, int keyCode, KeyEvent event)
Handles presses of the meta keys.
[Expand]
Inherited Methods
From class android.text.method.BaseKeyListener
From class android.text.method.MetaKeyKeyListener
From class java.lang.Object
From interface android.text.method.KeyListener

Public Constructors

public QwertyKeyListener (TextKeyListener.Capitalize cap, boolean autoText)

Added in API level 1

Parameters
cap
autoText

Public Methods

public int getInputType ()

Added in API level 3

Returns
int

public static QwertyKeyListener getInstance (boolean autoText, TextKeyListener.Capitalize cap)

Added in API level 1

Returns a new or existing instance with the specified capitalization and correction properties.

Parameters
autoText
cap
Returns
QwertyKeyListener

public static QwertyKeyListener getInstanceForFullKeyboard ()

Added in API level 11

Gets an instance of the listener suitable for use with full keyboards. Disables auto-capitalization, auto-text and long-press initiated on-screen character pickers.

Returns
QwertyKeyListener

public static void markAsReplaced (Spannable content, int start, int end, String original)

Added in API level 1

Marks the specified region of content as having contained original prior to AutoText replacement. Call this method when you have done or are about to do an AutoText-style replacement on a region of text and want to let the same mechanism (the user pressing DEL immediately after the change) undo the replacement.

Parameters
content the Editable text where the replacement was made
start the start of the replaced region
end the end of the replaced region; the location of the cursor
original the text to be restored if the user presses DEL

public boolean onKeyDown (View view, Editable content, int keyCode, KeyEvent event)

Added in API level 1

Handles presses of the meta keys.

Parameters
view
content
keyCode
event
Returns
boolean