Home · All Classes · Annotated · Functions

PkIM Class Reference

The PkIM class provides an input method based on a standard telephone keypad. Also provides full screen handwriting input. More...

#include <PkIM>

Inherits QWSInputMethod.

• List of all members, including inherited members

Public Functions

• bool isActive () const
• bool isFiltering () const
• virtual void queryResponse ( int property, const QVariant & result )
• bool restrictToHint () const
• void setHint ( const QString & s )
• void setMicroFocus ( int x, int y )
• void setRestrictToHint ( bool b )
• void setStatusWidget ( QLabel * l )

• 6 public functions inherited from QWSInputMethod
• 36 public functions inherited from QObject

Signals

• void stateChanged ( int state )

• 1 signal inherited from QObject

Protected Slots

• void sendMatchedCharacters ( const QList<QFSPenMatch::Guess> & cl )

Additional Inherited Members

• 1 property inherited from QObject
• 1 public slot inherited from QObject
• 4 static public members inherited from QObject
• 8 protected functions inherited from QWSInputMethod
• 8 protected functions inherited from QObject
• 2 protected variables inherited from QObject
• 1 static protected member inherited from QObject

Detailed Description

The PkIM class provides an input method based on a standard telephone keypad. Also provides full screen handwriting input.

Member Function Documentation

bool PkIM::isActive () const

Returns true if key or mouse events are currently being filtered by the input method to generate text. Otherwise returns false.

bool PkIM::isFiltering () const

Returns true if key or mouse events are currently being filtered by the input method to generate text. Otherwise returns false.

void PkIM::queryResponse ( int property, const QVariant & result )   [virtual]

bool PkIM::restrictToHint () const

Returns true if the input method is restricted to s single mode based of the current input hint. Otherwise returns false.

See also setRestrictToHint().

void PkIM::sendMatchedCharacters ( const QList<QFSPenMatch::Guess> & cl )   [protected slot]

Adds the characters in the character list cl to its current state. This may result in sending key events or adding letters to the currently composed word.

void PkIM::setHint ( const QString & s )

Sets the mode of the input method to the hint s. If the hint starts with only will take the remaining string as the hint and restrict the mode to the one that best matches that hint.

void PkIM::setMicroFocus ( int x, int y )

Updates the input methods cache the location on the screen of the cursor or sub-focus of the current input widget to the coordinates x, y.

void PkIM::setRestrictToHint ( bool b )

If b is true will restrict the mode of the input method to the current mode.

See also restrictToHint().

void PkIM::setStatusWidget ( QLabel * l )

Sets the widget used to display the current status to l. The input method will update the icon for the widget to reflect the input method mode

void PkIM::stateChanged ( int state )   [signal]

This signal is emitted when the state of the input method changes. It is used by the server to update icon state and visability appropriately.

If the input method is filtering state will be QtopiaInputMethod::Ready. Otherwise state will be QtopiaInputMethod::Sleeping.