Home · API Reference · Modules
Public Slots | Signals | Public Member Functions | Static Public Member Functions | List of all members
Maliit::InputMethod Class Reference
Inheritance diagram for Maliit::InputMethod:
Inheritance graph
[legend]

Public Slots

void startOrientationAngleChange (Maliit::OrientationAngle newOrientationAngle)
 
void setOrientationAngle (Maliit::OrientationAngle newOrientationAngle)
 
void setArea (const QRect &newRegion)
 

Signals

void areaChanged (const QRect &region)
 
void orientationAngleAboutToChange (Maliit::OrientationAngle orientationAngle)
 
void orientationAngleChanged (Maliit::OrientationAngle orientationAngle)
 
void keyPress (const QKeyEvent &)
 
void keyRelease (const QKeyEvent &)
 
void languageChanged (const QString &language)
 

Public Member Functions

QWidget * widget () const
 
QRect area () const
 
Maliit::OrientationAngle orientationAngle () const
 
const QString & language () const
 

Static Public Member Functions

static InputMethodinstance ()
 

Detailed Description

Listen to device orientation, language and raw key events.

Member Function Documentation

QRect Maliit::InputMethod::area ( ) const

Get current input method area.

Returns
current input method area
void Maliit::InputMethod::areaChanged ( const QRect &  region)
signal

Emitted when input method area is changed.

Warning
This signal is consumed by the input widget relocator inside libmeegotouch, and can be emitted at any time, so in order to avoid conflicts, an application that does any custom relayout must not use a queued connection (like Qt::QueuedConnection).
Parameters
regionnew input method area
InputMethod * Maliit::InputMethod::instance ( )
static

Get singleton instance.

Example of using the singleton InputMethod instance:

Returns
singleton instance
void Maliit::InputMethod::keyPress ( const QKeyEvent &  )
signal

Can be emitted by input method to notify about raw key press event it receives.

void Maliit::InputMethod::keyRelease ( const QKeyEvent &  )
signal

Can be emitted by input method to notify about raw key release event it receives.

const QString & Maliit::InputMethod::language ( ) const

Current language of active input method.

void Maliit::InputMethod::languageChanged ( const QString &  language)
signal

Emitted on input method language change.

See also
language()
OrientationAngle Maliit::InputMethod::orientationAngle ( ) const

Get the orientation of application's active window.

Returns
orientation of application's active window
void Maliit::InputMethod::orientationAngleAboutToChange ( Maliit::OrientationAngle  orientationAngle)
signal

This signal is emitted before the orientation angle of the application's active window is changed.

Parameters
orientationAngleNew orientation angle which is about to change.
Note
It is emitted at the start of the rotation animation.
void Maliit::InputMethod::orientationAngleChanged ( Maliit::OrientationAngle  orientationAngle)
signal

This signal is emitted when the orientation angle of application's active window is changed.

Parameters
orientationAnglenew orientation angle
Note
It's emitted with every orientation angle change finished.
void Maliit::InputMethod::setArea ( const QRect &  newRegion)
slot

Set input method area to newRegion.

void Maliit::InputMethod::setOrientationAngle ( Maliit::OrientationAngle  newOrientationAngle)
slot

Set the orientation angle of application's active window to newOrientationAngle.

Note
This method should be called when active window already finished the rotation animation.
void Maliit::InputMethod::startOrientationAngleChange ( Maliit::OrientationAngle  newOrientationAngle)
slot

Application's active window start to rotate to newOrientationAngle.

Note
This method should be called when active window start rotation animation.
QWidget * Maliit::InputMethod::widget ( ) const

Get the input method widget.

If the "MaliitDirect" input-context plugin is in use, the Maliit Server will be hosted inside the application process, and the input method widget be available here. The application may then reparent the widget into its widget hierarchy to make use of the input method. Handling of show and hide is still done by Maliit, and the application should follow the areaChanged() signal to track the size of the IM, just as in the server-hosted case.

If the input-context plugin in use is not "MaliitDirect", this method will return 0


Copyright © 2011 Nokia Corporation
Maliit