Home · API Reference · Modules
Public Slots | Signals | Public Member Functions | Static Public Member Functions
Maliit::InputMethod Class Reference

List of all members.

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

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()

Get the orientation of application's active window.

Returns:
orientation of application's active window

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.

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.

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.

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