Qt 4.8
Public Types | Public Functions | Private Functions | Friends | List of all members
QInputContext Class Referenceabstract

The QInputContext class abstracts the input method dependent data and composing state. More...

#include <qinputcontext.h>

Inheritance diagram for QInputContext:
QObject QBBInputContext QBBInputContext QCoeFepInputContext QDummyInputContext QMacInputContext QMultiInputContext QWinInputContext QWSInputContext QXIMInputContext

Public Types

enum  StandardFormat { PreeditFormat, SelectionFormat }
 

Public Functions

virtual QList< QAction * > actions ()
 This is a preliminary interface for Qt 4. More...
 
virtual bool filterEvent (const QEvent *event)
 This function can be reimplemented in a subclass to filter input events. More...
 
QWidgetfocusWidget () const
 Returns the widget that has an input focus for this input context. More...
 
virtual QFont font () const
 Returns the font of the current input widget. More...
 
virtual QString identifierName ()=0
 This function must be implemented in any subclasses to return the identifier name of the input method. More...
 
virtual bool isComposing () const =0
 This function indicates whether InputMethodStart event had been sent to the current focus widget. More...
 
virtual QString language ()=0
 This function must be implemented in any subclasses to return a language code (e. More...
 
virtual void mouseHandler (int x, QMouseEvent *event)
 This function can be reimplemented in a subclass to handle mouse press, release, double-click, and move events within the preedit text. More...
 
 QInputContext (QObject *parent=0)
 Constructs an input context with the given parent. More...
 
virtual void reset ()=0
 This function can be reimplemented in a subclass to reset the state of the input method. More...
 
void sendEvent (const QInputMethodEvent &event)
 Sends an input method event specified by event to the current focus widget. More...
 
virtual void setFocusWidget (QWidget *w)
 Sets the widget that has an input focus for this input context. More...
 
QTextFormat standardFormat (StandardFormat s) const
 Returns a QTextFormat object that specifies the format for component s. More...
 
virtual void update ()
 This virtual function is called when a state in the focus widget has changed. More...
 
virtual void widgetDestroyed (QWidget *w)
 This virtual function is called when the specified widget is destroyed. More...
 
virtual bool x11FilterEvent (QWidget *keywidget, XEvent *event)
 This function may be overridden only if input method is depending on X11 and you need raw XEvent. More...
 
virtual ~QInputContext ()
 Destroys the input context. More...
 
- Public Functions inherited from QObject
bool blockSignals (bool b)
 If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More...
 
const QObjectListchildren () const
 Returns a list of child objects. More...
 
bool connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
 
bool disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0)
 
bool disconnect (const QObject *receiver, const char *member=0)
 
void dumpObjectInfo ()
 Dumps information about signal connections, etc. More...
 
void dumpObjectTree ()
 Dumps a tree of children to the debug output. More...
 
QList< QByteArraydynamicPropertyNames () const
 Returns the names of all properties that were dynamically added to the object using setProperty(). More...
 
virtual bool event (QEvent *)
 This virtual function receives events to an object and should return true if the event e was recognized and processed. More...
 
virtual bool eventFilter (QObject *, QEvent *)
 Filters events if this object has been installed as an event filter for the watched object. More...
 
template<typename T >
findChild (const QString &aName=QString()) const
 Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More...
 
template<typename T >
QList< T > findChildren (const QString &aName=QString()) const
 Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More...
 
template<typename T >
QList< T > findChildren (const QRegExp &re) const
 
bool inherits (const char *classname) const
 Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More...
 
void installEventFilter (QObject *)
 Installs an event filter filterObj on this object. More...
 
bool isWidgetType () const
 Returns true if the object is a widget; otherwise returns false. More...
 
void killTimer (int id)
 Kills the timer with timer identifier, id. More...
 
virtual const QMetaObjectmetaObject () const
 Returns a pointer to the meta-object of this object. More...
 
void moveToThread (QThread *thread)
 Changes the thread affinity for this object and its children. More...
 
QString objectName () const
 
QObjectparent () const
 Returns a pointer to the parent object. More...
 
QVariant property (const char *name) const
 Returns the value of the object's name property. More...
 
Q_INVOKABLE QObject (QObject *parent=0)
 Constructs an object with parent object parent. More...
 
void removeEventFilter (QObject *)
 Removes an event filter object obj from this object. More...
 
void setObjectName (const QString &name)
 
void setParent (QObject *)
 Makes the object a child of parent. More...
 
bool setProperty (const char *name, const QVariant &value)
 Sets the value of the object's name property to value. More...
 
void setUserData (uint id, QObjectUserData *data)
 
bool signalsBlocked () const
 Returns true if signals are blocked; otherwise returns false. More...
 
int startTimer (int interval)
 Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More...
 
QThreadthread () const
 Returns the thread in which the object lives. More...
 
QObjectUserDatauserData (uint id) const
 
virtual ~QObject ()
 Destroys the object, deleting all its child objects. More...
 

Private Functions

QInputContextoperator= (const QInputContext &)
 
 QInputContext (const QInputContext &)
 

Friends

class QApplication
 
class QInputContextFactory
 
class QWidget
 
class QWidgetPrivate
 

Additional Inherited Members

- Public Slots inherited from QObject
void deleteLater ()
 Schedules this object for deletion. More...
 
- Signals inherited from QObject
void destroyed (QObject *=0)
 This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More...
 
- Static Public Functions inherited from QObject
static bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
 Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More...
 
static bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
 
static bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
 Disconnects signal in object sender from method in object receiver. More...
 
static bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
 
static uint registerUserData ()
 
static QString tr (const char *sourceText, const char *comment=0, int n=-1)
 
static QString trUtf8 (const char *sourceText, const char *comment=0, int n=-1)
 
- Static Public Variables inherited from QObject
static const QMetaObject staticMetaObject
 This variable stores the meta-object for the class. More...
 
- Protected Functions inherited from QObject
virtual void childEvent (QChildEvent *)
 This event handler can be reimplemented in a subclass to receive child events. More...
 
virtual void connectNotify (const char *signal)
 This virtual function is called when something has been connected to signal in this object. More...
 
virtual void customEvent (QEvent *)
 This event handler can be reimplemented in a subclass to receive custom events. More...
 
virtual void disconnectNotify (const char *signal)
 This virtual function is called when something has been disconnected from signal in this object. More...
 
 QObject (QObjectPrivate &dd, QObject *parent=0)
 
int receivers (const char *signal) const
 Returns the number of receivers connected to the signal. More...
 
QObjectsender () const
 Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More...
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *)
 This event handler can be reimplemented in a subclass to receive timer events for the object. More...
 
- Protected Variables inherited from QObject
QScopedPointer< QObjectDatad_ptr
 
- Static Protected Variables inherited from QObject
static const QMetaObject staticQtMetaObject
 

Detailed Description

The QInputContext class abstracts the input method dependent data and composing state.

An input method is responsible for inputting complex text that cannot be inputted via simple keymap. It converts a sequence of input events (typically key events) into a text string through the input method specific converting process. The class of the processes are widely ranging from simple finite state machine to complex text translator that pools a whole paragraph of a text with text editing capability to perform grammar and semantic analysis.

To abstract such different input method specific intermediate information, Qt offers the QInputContext as base class. The concept is well known as 'input context' in the input method domain. An input context is created for a text widget in response to a demand. It is ensured that an input context is prepared for an input method before input to a text widget.

Multiple input contexts that belong to a single input method may concurrently coexist. Suppose multi-window text editor. Each text widget of window A and B holds different QInputContext instance which contains different state information such as partially composed text.

Groups of Functions

Context

Functions

Receiving information

x11FilterEvent(), filterEvent(), mouseHandler()

Sending back composed text

sendEvent()

State change notification

setFocusWidget(), reset()

Context information

identifierName(), language(), font(), isComposing()

Licensing Information

Copyright (C) 2003-2004 immodule for Qt Project. All rights reserved.

This file is written to contribute to Nokia Corporation and/or its subsidiary(-ies) under their own license. You may use this file under your Qt license. Following description is copied from their original file headers. Contact immod.nosp@m.ule-.nosp@m.qt@fr.nosp@m.eede.nosp@m.sktop.nosp@m..org if any conditions of this licensing are not clear to you.

See also
QInputContextPlugin, QInputContextFactory, QApplication::setInputContext()

Definition at line 83 of file qinputcontext.h.

Enumerations

◆ StandardFormat

  • PreeditFormat The preedit text.
  • SelectionFormat The selection text.
See also
standardFormat()
Enumerator
PreeditFormat 
SelectionFormat 

Definition at line 118 of file qinputcontext.h.

Constructors and Destructors

◆ QInputContext() [1/2]

QInputContext::QInputContext ( QObject parent = 0)
explicit

Constructs an input context with the given parent.

Definition at line 144 of file qinputcontext.cpp.

145  : QObject(*new QInputContextPrivate, parent)
146 {
147 }
Q_INVOKABLE QObject(QObject *parent=0)
Constructs an object with parent object parent.
Definition: qobject.cpp:753

◆ ~QInputContext()

QInputContext::~QInputContext ( )
virtual

Destroys the input context.

Definition at line 153 of file qinputcontext.cpp.

154 {
155 }

◆ QInputContext() [2/2]

QInputContext::QInputContext ( const QInputContext )
private

Functions

◆ actions()

QList< QAction * > QInputContext::actions ( )
virtual

This is a preliminary interface for Qt 4.

Reimplemented in QMultiInputContext, and QBBInputContext.

Definition at line 417 of file qinputcontext.cpp.

Referenced by QBBInputContext::actions(), QMultiInputContext::actions(), QTextControl::createStandardContextMenu(), and QLineEdit::createStandardContextMenu().

418 {
419  return QList<QAction *>();
420 }
The QList class is a template class that provides lists.
Definition: qdatastream.h:62

◆ filterEvent()

bool QInputContext::filterEvent ( const QEvent event)
virtual

This function can be reimplemented in a subclass to filter input events.

Return true if the event has been consumed. Otherwise, the unfiltered event will be forwarded to widgets as ordinary way. Although the input events have accept() and ignore() methods, leave it untouched.

event is currently restricted to events of these types:

  • CloseSoftwareInputPanel
  • KeyPress
  • KeyRelease
  • MouseButtonDblClick
  • MouseButtonPress
  • MouseButtonRelease
  • MouseMove
  • RequestSoftwareInputPanel

But some input method related events such as QWheelEvent or QTabletEvent may be added in future.

The filtering opportunity is always given to the input context as soon as possible. It has to be taken place before any other key event consumers such as eventfilters and accelerators because some input methods require quite various key combination and sequences. It often conflicts with accelerators and so on, so we must give the input context the filtering opportunity first to ensure all input methods work properly regardless of application design.

Ordinary input methods require discrete key events to work properly, so Qt's key compression is always disabled for any input contexts.

See also
QKeyEvent, x11FilterEvent()

Reimplemented in QCoeFepInputContext, QMultiInputContext, QBBInputContext, and QBBInputContext.

Definition at line 248 of file qinputcontext.cpp.

Referenced by QMultiInputContext::filterEvent(), QApplication::notify(), and QApplication::x11ProcessEvent().

249 {
250  return false;
251 }

◆ focusWidget()

QWidget * QInputContext::focusWidget ( ) const

Returns the widget that has an input focus for this input context.

The return value may differ from holderWidget() if the input context is shared between several text widgets.

Warning
To ensure platform independence and support flexible configuration of widgets, ordinary input methods should not call this function directly.
See also
setFocusWidget()

Definition at line 170 of file qinputcontext.cpp.

Referenced by QMultiInputContext::changeSlave(), QXIMInputContext::create_xim(), QBBInputContext::dispatchRequestSoftwareInputPanel(), QWinInputContext::endComposition(), QMultiInputContext::focusWidget(), QMacInputContext::globalEventProcessor(), QBBInputContext::hasSelectedText(), QXIMInputContext::icData(), QXIMInputContext::isComposing(), QWinInputContext::mouseHandler(), QXIMInputContext::mouseHandler(), QBBInputContext::onGetCursorPosition(), QBBInputContext::onGetSelectedText(), QBBInputContext::onGetTextAfterCursor(), QBBInputContext::onGetTextBeforeCursor(), QBBInputContext::onSetComposingRegion(), QBBInputContext::onSetComposingText(), QWinInputContext::reconvertString(), QMacInputContext::reset(), QWinInputContext::reset(), QXIMInputContext::reset(), sendEvent(), QWidget::setAttribute(), QMacInputContext::setFocusWidget(), QWSInputContext::setFocusWidget(), QWinInputContext::setFocusWidget(), QXIMInputContext::setFocusWidget(), standardFormat(), QWinInputContext::startComposition(), QWSInputContext::update(), QWinInputContext::update(), QXIMInputContext::update(), and QXIMInputContext::x11FilterEvent().

171 {
172  Q_D(const QInputContext);
173  return d->focusWidget;
174 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QInputContext class abstracts the input method dependent data and composing state.
Definition: qinputcontext.h:83

◆ font()

QFont QInputContext::font ( ) const
virtual

Returns the font of the current input widget.

Reimplemented in QMultiInputContext, and QBBInputContext.

Definition at line 315 of file qinputcontext.cpp.

Referenced by QXIMInputContext::createICData(), QBBInputContext::font(), and QMultiInputContext::font().

316 {
317  Q_D(const QInputContext);
318  if (!d->focusWidget)
319  return QApplication::font();
320 
321  return qvariant_cast<QFont>(d->focusWidget->inputMethodQuery(Qt::ImFont));
322 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
static QFont font()
Returns the default application font.
The QFont class specifies a font used for drawing text.
Definition: qfont.h:64
T qvariant_cast(const QVariant &)
Definition: qvariant.h:571
The QInputContext class abstracts the input method dependent data and composing state.
Definition: qinputcontext.h:83

◆ identifierName()

QString QInputContext::identifierName ( )
pure virtual

This function must be implemented in any subclasses to return the identifier name of the input method.

Return value is the name to identify and specify input methods for the input method switching mechanism and so on. The name has to be consistent with QInputContextPlugin::keys(). The name has to consist of ASCII characters only.

There are two different names with different responsibility in the input method domain. This function returns one of them. Another name is called 'display name' that stands for the name for endusers appeared in a menu and so on.

See also
QInputContextPlugin::keys(), QInputContextPlugin::displayName()

Implemented in QDummyInputContext, QXIMInputContext, QCoeFepInputContext, QWinInputContext, QMultiInputContext, QWSInputContext, QMacInputContext, QBBInputContext, and QBBInputContext.

Referenced by QMultiInputContext::identifierName().

◆ isComposing()

bool QInputContext::isComposing ( ) const
pure virtual

This function indicates whether InputMethodStart event had been sent to the current focus widget.

It is ensured that an input context can send InputMethodCompose or InputMethodEnd event safely if this function returned true.

The state is automatically being tracked through sendEvent().

See also
sendEvent()

Implemented in QDummyInputContext, QCoeFepInputContext, QXIMInputContext, QWinInputContext, QMultiInputContext, QWSInputContext, QMacInputContext, QBBInputContext, and QBBInputContext.

Referenced by QMacInputContext::identifierName(), QMultiInputContext::isComposing(), and QKeyMapperPrivate::translateKeyEvent().

◆ language()

QString QInputContext::language ( )
pure virtual

This function must be implemented in any subclasses to return a language code (e.

g. "zh_CN", "zh_TW", "zh_HK", "ja", "ko", ...) of the input context. If the input context can handle multiple languages, return the currently used one. The name has to be consistent with QInputContextPlugin::language().

This information will be used by language tagging feature in QInputMethodEvent. It is required to distinguish unified han characters correctly. It enables proper font and character code handling. Suppose CJK-awared multilingual web browser (that automatically modifies fonts in CJK-mixed text) and XML editor (that automatically inserts lang attr).

Implemented in QDummyInputContext, QXIMInputContext, QCoeFepInputContext, QWinInputContext, QMultiInputContext, QWSInputContext, QMacInputContext, QBBInputContext, and QBBInputContext.

Referenced by QMacInputContext::identifierName(), and QMultiInputContext::language().

◆ mouseHandler()

void QInputContext::mouseHandler ( int  x,
QMouseEvent event 
)
virtual

This function can be reimplemented in a subclass to handle mouse press, release, double-click, and move events within the preedit text.

You can use the function to implement mouse-oriented user interface such as text selection or popup menu for candidate selection.

The x parameter is the offset within the string that was sent with the InputMethodCompose event. The alteration boundary of x is ensured as character boundary of preedit string accurately.

The event parameter is the event that was sent to the editor widget. The event type is QEvent::MouseButtonPress, QEvent::MouseButtonRelease, QEvent::MouseButtonDblClick or QEvent::MouseMove. The event's button and state indicate the kind of operation that was performed.

Reimplemented in QCoeFepInputContext, QXIMInputContext, QWinInputContext, QMultiInputContext, QMacInputContext, QWSInputContext, and QBBInputContext.

Definition at line 303 of file qinputcontext.cpp.

Referenced by QMacInputContext::lastFocusWidget(), QBBInputContext::mouseHandler(), QMultiInputContext::mouseHandler(), QDeclarativeTextInputPrivate::sendMouseEventToInputContext(), QLineEditPrivate::sendMouseEventToInputContext(), and QTextControlPrivate::sendMouseEventToInputContext().

304 {
305  // Default behavior for simple ephemeral input contexts. Some
306  // complex input contexts should not be reset here.
307  if (event->type() == QEvent::MouseButtonPress || event->type() == QEvent::MouseButtonDblClick)
308  reset();
309 }
virtual void reset()=0
This function can be reimplemented in a subclass to reset the state of the input method.
Type type() const
Returns the event type.
Definition: qcoreevent.h:303

◆ operator=()

QInputContext& QInputContext::operator= ( const QInputContext )
private

◆ reset()

void QInputContext::reset ( )
pure virtual

This function can be reimplemented in a subclass to reset the state of the input method.

This function is called by several widgets to reset input state. For example, a text widget call this function before inserting a text to make widget ready to accept a text.

Default implementation is sufficient for simple input method. You can override this function to reset external input method engines in complex input method. In the case, call QInputContext::reset() to ensure proper termination of inputting.

In a reimplementation of reset(), you must not send any QInputMethodEvent containing preedit text. You can only commit string and attributes; otherwise, you risk breaking input state consistency.

Implemented in QDummyInputContext, QXIMInputContext, QCoeFepInputContext, QWinInputContext, QMultiInputContext, QWSInputContext, QMacInputContext, QBBInputContext, and QBBInputContext.

Referenced by QMultiInputContext::changeSlave(), QMacInputContext::identifierName(), mouseHandler(), QMultiInputContext::reset(), QWidget::resetInputContext(), QWidget::setAttribute(), QWidgetPrivate::setEnabled_helper(), QGraphicsScenePrivate::setFocusItemHelper(), and QApplicationPrivate::setFocusWidget().

◆ sendEvent()

void QInputContext::sendEvent ( const QInputMethodEvent event)

Sends an input method event specified by event to the current focus widget.

Implementations of QInputContext should call this method to send the generated input method events and not QApplication::sendEvent(), as the events might have to get dispatched to a different application on some platforms.

Some complex input methods route the handling to several child contexts (e.g. to enable language switching). To account for this, QInputContext will check if the parent object is a QInputContext. If yes, it will call the parents sendEvent() implementation instead of sending the event directly.

See also
QInputMethodEvent

Definition at line 268 of file qinputcontext.cpp.

Referenced by QBBInputContext::endComposition(), QBBInputContext::onCommitText(), QBBInputContext::onDeleteSurroundingText(), QBBInputContext::onFinishComposingText(), QBBInputContext::onSetComposingRegion(), QXIMInputContext::reset(), sendEvent(), QBBInputContext::setComposingText(), QXIMInputContext::x11FilterEvent(), and xic_draw_callback().

269 {
270  // route events over input context parents to make chaining possible.
272  if (p) {
273  p->sendEvent(event);
274  return;
275  }
276 
277  QWidget *focus = focusWidget();
278  if (!focus)
279  return;
280 
281  QInputMethodEvent e(event);
282  QApplication::sendEvent(focus, &e);
283 }
The QWidget class is the base class of all user interface objects.
Definition: qwidget.h:150
QWidget * focusWidget() const
Returns the widget that has an input focus for this input context.
T * qobject_cast(QObject *object)
Definition: qobject.h:375
static bool sendEvent(QObject *receiver, QEvent *event)
Sends event event directly to receiver receiver, using the notify() function.
The QInputMethodEvent class provides parameters for input method events.
Definition: qevent.h:431
void sendEvent(const QInputMethodEvent &event)
Sends an input method event specified by event to the current focus widget.
QObject * parent() const
Returns a pointer to the parent object.
Definition: qobject.h:273
The QInputContext class abstracts the input method dependent data and composing state.
Definition: qinputcontext.h:83

◆ setFocusWidget()

void QInputContext::setFocusWidget ( QWidget widget)
virtual

Sets the widget that has an input focus for this input context.

Warning
Ordinary input methods must not call this function directly.
See also
focusWidget()

Reimplemented in QCoeFepInputContext, QXIMInputContext, QMultiInputContext, QWinInputContext, QWSInputContext, QMacInputContext, QBBInputContext, and QBBInputContext.

Definition at line 185 of file qinputcontext.cpp.

Referenced by QMultiInputContext::changeSlave(), getNetWmState(), QBBInputContext::hasPhysicalKeyboard(), QWidget::setAttribute(), QWidgetPrivate::setEnabled_helper(), QBBInputContext::setFocusWidget(), QMacInputContext::setFocusWidget(), QWSInputContext::setFocusWidget(), QWinInputContext::setFocusWidget(), QMultiInputContext::setFocusWidget(), QXIMInputContext::setFocusWidget(), QApplicationPrivate::setFocusWidget(), and widgetDestroyed().

186 {
187  Q_ASSERT(!widget || widget->testAttribute(Qt::WA_InputMethodEnabled));
189  d->focusWidget = widget;
190 }
double d
Definition: qnumeric_p.h:62
QPointer< QWidget > widget
#define Q_ASSERT(cond)
Definition: qglobal.h:1823
#define Q_D(Class)
Definition: qglobal.h:2482
bool testAttribute(Qt::WidgetAttribute) const
Returns true if attribute attribute is set on this widget; otherwise returns false.
Definition: qwidget.h:1041
The QInputContext class abstracts the input method dependent data and composing state.
Definition: qinputcontext.h:83

◆ standardFormat()

QTextFormat QInputContext::standardFormat ( StandardFormat  s) const

Returns a QTextFormat object that specifies the format for component s.

Definition at line 435 of file qinputcontext.cpp.

Referenced by QWinInputContext::composition(), QWSInputContext::translateIMEvent(), and xic_draw_callback().

436 {
437  QWidget *focus = focusWidget();
438  const QPalette &pal = focus ? focus->palette() : QApplication::palette();
439 
440  QTextCharFormat fmt;
441  QColor bg;
442  switch (s) {
445  break;
446  }
448  bg = pal.text().color();
449  fmt.setBackground(QBrush(bg));
450  fmt.setForeground(pal.background());
451  break;
452  }
453  }
454  return fmt;
455 }
The QColor class provides colors based on RGB, HSV or CMYK values.
Definition: qcolor.h:67
QPalette palette
the widget&#39;s palette
Definition: qwidget.h:180
The QTextCharFormat class provides formatting information for characters in a QTextDocument.
Definition: qtextformat.h:372
const QColor & color() const
Returns the brush color.
Definition: qbrush.h:183
const QBrush & background() const
Use window() instead.
Definition: qpalette.h:134
The QWidget class is the base class of all user interface objects.
Definition: qwidget.h:150
static QPalette palette()
Returns the application palette.
void setBackground(const QBrush &brush)
Sets the brush use to paint the document&#39;s background to the brush specified.
Definition: qtextformat.h:343
QWidget * focusWidget() const
Returns the widget that has an input focus for this input context.
The QBrush class defines the fill pattern of shapes drawn by QPainter.
Definition: qbrush.h:76
void setForeground(const QBrush &brush)
Sets the foreground brush to the specified brush.
Definition: qtextformat.h:350
void setUnderlineStyle(UnderlineStyle style)
Sets the style of underlining the text to style.
const QBrush & text() const
Returns the text foreground brush of the current color group.
Definition: qpalette.h:129
The QPalette class contains color groups for each widget state.
Definition: qpalette.h:61

◆ update()

void QInputContext::update ( )
virtual

This virtual function is called when a state in the focus widget has changed.

QInputContext can then use QWidget::inputMethodQuery() to query the new state of the widget.

Reimplemented in QXIMInputContext, QCoeFepInputContext, QWinInputContext, QMultiInputContext, QWSInputContext, and QBBInputContext.

Definition at line 329 of file qinputcontext.cpp.

Referenced by QWidget::setInputMethodHints(), QBBInputContext::update(), QMultiInputContext::update(), and QWidget::updateMicroFocus().

330 {
331 }

◆ widgetDestroyed()

void QInputContext::widgetDestroyed ( QWidget widget)
virtual

This virtual function is called when the specified widget is destroyed.

The widget is a widget on which this input context is installed.

Reimplemented in QCoeFepInputContext, QXIMInputContext, QMultiInputContext, QWSInputContext, and QBBInputContext.

Definition at line 338 of file qinputcontext.cpp.

Referenced by QWidgetPrivate::isBackgroundInherited(), isServerProcess(), QBBInputContext::widgetDestroyed(), QWSInputContext::widgetDestroyed(), QMultiInputContext::widgetDestroyed(), and QXIMInputContext::widgetDestroyed().

339 {
341  if (widget == d->focusWidget)
342  setFocusWidget(0);
343 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QInputContext class abstracts the input method dependent data and composing state.
Definition: qinputcontext.h:83
virtual void setFocusWidget(QWidget *w)
Sets the widget that has an input focus for this input context.

◆ x11FilterEvent()

bool QInputContext::x11FilterEvent ( QWidget keywidget,
XEvent event 
)
virtual

This function may be overridden only if input method is depending on X11 and you need raw XEvent.

Otherwise, this function must not.

This function is designed to filter raw key events for XIM, but other input methods may use this to implement some special features such as distinguishing Shift_L and Shift_R.

Return true if the event has been consumed. Otherwise, the unfiltered event will be translated into QEvent and forwarded to filterEvent(). Filtering at both x11FilterEvent() and filterEvent() in single input method is allowed.

keywidget is a client widget into which a text is inputted. event is inputted XEvent.

See also
filterEvent()

Reimplemented in QXIMInputContext, and QMultiInputContext.

Definition at line 476 of file qinputcontext.cpp.

Referenced by QMultiInputContext::x11FilterEvent(), and QApplication::x11ProcessEvent().

477 {
478  return false;
479 }

Friends and Related Functions

◆ QApplication

friend class QApplication
friend

Definition at line 127 of file qinputcontext.h.

◆ QInputContextFactory

friend class QInputContextFactory
friend

Definition at line 126 of file qinputcontext.h.

◆ QWidget

friend class QWidget
friend

Definition at line 124 of file qinputcontext.h.

◆ QWidgetPrivate

friend class QWidgetPrivate
friend

Definition at line 125 of file qinputcontext.h.


The documentation for this class was generated from the following files: