You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
106 lines
4.8 KiB
106 lines
4.8 KiB
'\" t
|
|
.TH QWSInputMethod 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*-
|
|
.\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the
|
|
.\" license file included in the distribution for a complete license
|
|
.\" statement.
|
|
.\"
|
|
.ad l
|
|
.nh
|
|
.SH NAME
|
|
QWSInputMethod \- International input methods for Qt/Embedded
|
|
.SH SYNOPSIS
|
|
\fC#include <qwindowsystem_qws.h>\fR
|
|
.PP
|
|
.SS "Public Members"
|
|
.in +1c
|
|
.ti -1c
|
|
.BI "\fBQWSInputMethod\fR ()"
|
|
.br
|
|
.ti -1c
|
|
.BI "virtual \fB~QWSInputMethod\fR ()"
|
|
.br
|
|
.ti -1c
|
|
.BI "virtual bool \fBfilter\fR ( int unicode, int keycode, int modifiers, bool isPress, bool autoRepeat ) = 0"
|
|
.br
|
|
.ti -1c
|
|
.BI "virtual void \fBreset\fR ()"
|
|
.br
|
|
.ti -1c
|
|
.BI "virtual void \fBsetMicroFocus\fR ( int x, int y )"
|
|
.br
|
|
.ti -1c
|
|
.BI "virtual void \fBsetFont\fR ( const QFont & )"
|
|
.br
|
|
.in -1c
|
|
.SS "Protected Members"
|
|
.in +1c
|
|
.ti -1c
|
|
.BI "void \fBsendIMEvent\fR ( QWSServer::IMState state, const QString & txt, int cpos, int selLen = 0 )"
|
|
.br
|
|
.in -1c
|
|
.SH DESCRIPTION
|
|
The QWSInputMethod class provides international input methods for Qt/Embedded.
|
|
.PP
|
|
Subclass this class to implement your own input method.
|
|
.PP
|
|
An input methods consists of a keyboard filter and optionally a graphical interface. The keyboard filter intercepts key events from physical or virtual keyboards by implementing the filter() function.
|
|
.PP
|
|
Use sendIMEvent() to send composition events. Composition starts with the input method sending an \fCIMStart\fR event, followed by a number of \fCIMCompose\fR events and ending with an \fCIMEnd\fR event or when the virtual reset() function is called.
|
|
.PP
|
|
The functions setMicroFocus() and setFont() can be reimplemented to receive more information about the state of the focus widget.
|
|
.PP
|
|
Use QWSServer::setCurrentInputMethod() to install an input method.
|
|
.PP
|
|
See also Qt/Embedded.
|
|
.SH MEMBER FUNCTION DOCUMENTATION
|
|
.SH "QWSInputMethod::QWSInputMethod ()"
|
|
Constructs a new input method
|
|
.SH "QWSInputMethod::~QWSInputMethod ()\fC [virtual]\fR"
|
|
Destructs the input method uninstalling it if it is currently installed.
|
|
.SH "bool QWSInputMethod::filter ( int unicode, int keycode, int modifiers, bool isPress, bool autoRepeat )\fC [pure virtual]\fR"
|
|
This function must be implemented in subclasses to handle key input from physical or virtual keyboards. Returning TRUE will block the event from further processing.
|
|
.PP
|
|
The Unicode value is given in \fIunicode\fR and the key code in \fIkeycode\fR. Keyboard modifiers are OR-ed together in \fImodifiers\fR. If \fIisPress\fR is TRUE this is a key press; otherwise it is a key release. If \fIautoRepeat\fR is TRUE this is an auto-repeated key press.
|
|
.PP
|
|
All normal key events should be blocked while in compose mode (i.e., between \fCIMStart\fR and \fCIMEnd\fR).
|
|
.SH "void QWSInputMethod::reset ()\fC [virtual]\fR"
|
|
Implemented in subclasses to reset the state of the input method.
|
|
.SH "void QWSInputMethod::sendIMEvent ( QWSServer::IMState state, const QString & txt, int cpos, int selLen = 0 )\fC [protected]\fR"
|
|
Causes a QIMEvent to be sent to the focus widget. \fIstate\fR may be one of QWSServer::IMStart, QWSServer::IMCompose or QWSServer::IMEnd.
|
|
.PP
|
|
\fItxt\fR is the text being composed (or the finished text if state is \fCIMEnd\fR). \fIcpos\fR is the current cursor position.
|
|
.PP
|
|
If state is \fCIMCompose\fR, \fIselLen\fR is the number of characters in the composition string (starting at \fIcpos\fR) that should be marked as selected by the input widget receiving the event.
|
|
.SH "void QWSInputMethod::setFont ( const QFont & )\fC [virtual]\fR"
|
|
Implemented in subclasses to handle font changes in the focus widget.
|
|
.PP
|
|
This functionality is provided for future expansion; it is not used in this version of Qt/Embedded.
|
|
.SH "void QWSInputMethod::setMicroFocus ( int x, int y )\fC [virtual]\fR"
|
|
Implemented in subclasses to handle microFocusHint changes in the focus widget. \fIx\fR and \fIy\fR are the global coordinates of the text cursor.
|
|
.PP
|
|
|
|
.SH "SEE ALSO"
|
|
.BR http://doc.trolltech.com/qwsinputmethod.html
|
|
.BR http://www.trolltech.com/faq/tech.html
|
|
.SH COPYRIGHT
|
|
Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the
|
|
license file included in the distribution for a complete license
|
|
statement.
|
|
.SH AUTHOR
|
|
Generated automatically from the source code.
|
|
.SH BUGS
|
|
If you find a bug in Qt, please report it as described in
|
|
.BR http://doc.trolltech.com/bughowto.html .
|
|
Good bug reports help us to help you. Thank you.
|
|
.P
|
|
The definitive Qt documentation is provided in HTML format; it is
|
|
located at $QTDIR/doc/html and can be read using Qt Assistant or with
|
|
a web browser. This man page is provided as a convenience for those
|
|
users who prefer man pages, although this format is not officially
|
|
supported by Trolltech.
|
|
.P
|
|
If you find errors in this manual page, please report them to
|
|
.BR qt-bugs@trolltech.com .
|
|
Please include the name of the manual page (qwsinputmethod.3qt) and the Qt
|
|
version (3.3.8).
|