-
Mitch Curtis authored
This restructures the repo to match other Qt modules, like the Enterprise Controls. It also renames the plugin and usages of its name in the documentation so that the abbreviated "VKB" is not used anywhere. Change-Id: I5de3fc67846a50438e52f4be057abfa0d9be0d91 Reviewed-by:Frederik Gladhorn <frederik.gladhorn@digia.com>
9778eb24
/******************************************************************************** Copyright (C) 2013 Digia Plc** All rights reserved.** For any questions to Digia, please use contact form at http://qt.digia.com**** This file is part of the Qt Quick Enterprise Controls add-on.**** Licensees holding valid Qt Enterprise licenses may use this file in** accordance with the Qt Enterprise License Agreement provided with the** Software or, alternatively, in accordance with the terms contained in** a written agreement between you and Digia.**** If you have questions regarding the use of this file, please use** contact form at http://qt.digia.com******************************************************************************/#include "abstractinputmethod.h"/*! \class AbstractInputMethod \inmodule InputFramework \brief The base class for input methods. Use this class if you want to implement a custom input method using C/C++ language.*//*! Constructs an input method with \a d_ptr as the private data from the derived class and \a parent as the parent.*/AbstractInputMethod::AbstractInputMethod(AbstractInputMethodPrivate *d_ptr, QObject *parent) : QObject(parent), d_ptr(d_ptr){}/*! Constructs an input method with \a parent.*/AbstractInputMethod::AbstractInputMethod(QObject *parent) : QObject(parent), d_ptr(new AbstractInputMethodPrivate()){}/*! Destroys the input method and frees all allocated resources.*/AbstractInputMethod::~AbstractInputMethod(){}/*! Returns the meta class name of this instance.*/QString AbstractInputMethod::className() const{ return metaObject()->className();}/*! Returns the input context associated with the input method. This method returns \c NULL if the input method is not active.*/DeclarativeInputContext *AbstractInputMethod::inputContext() const7172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
{
Q_D(const AbstractInputMethod);
return d->inputEngine ? d->inputEngine->inputContext() : 0;
}
/*!
Returns the input engine associated with the input method.
This method returns \c NULL if the input method is not active.
*/
DeclarativeInputEngine *AbstractInputMethod::inputEngine() const
{
Q_D(const AbstractInputMethod);
return d->inputEngine;
}
/*!
This method is called by the input engine when the input method needs
to be reset. The input method must reset its internal state only. The main
difference to the update() method is that reset() modifies only
the input method state, i.e. it must not modify the input context.
*/
void AbstractInputMethod::reset()
{
}
/*!
This method is called by the input engine when the input method needs to be
updated. The input method must close the current pre-edit text and
restore its internal state to the default.
*/
void AbstractInputMethod::update()
{
}
/*!
\internal
Called by the input engine when the input method is activated and
deactivated.
*/
void AbstractInputMethod::setInputEngine(DeclarativeInputEngine *inputEngine)
{
Q_D(AbstractInputMethod);
if (d->inputEngine) {
disconnect(this, SLOT(reset()));
disconnect(this, SLOT(update()));
}
d->inputEngine = inputEngine;
if (d->inputEngine) {
connect(d->inputEngine, SIGNAL(inputMethodReset()), SLOT(reset()));
connect(d->inputEngine, SIGNAL(inputMethodUpdate()), SLOT(update()));
}
}
QList<DeclarativeSelectionListModel::Type> AbstractInputMethod::selectionLists()
{
return QList<DeclarativeSelectionListModel::Type>();
}
int AbstractInputMethod::selectionListItemCount(DeclarativeSelectionListModel::Type type)
{
Q_UNUSED(type)
return 0;
}
QVariant AbstractInputMethod::selectionListData(DeclarativeSelectionListModel::Type type, int index, int role)
{
Q_UNUSED(type)
Q_UNUSED(index)
switch (role) {
case DeclarativeSelectionListModel::DisplayRole:
141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210
return QVariant("");
case DeclarativeSelectionListModel::WordCompletionLengthRole:
return QVariant(0);
}
return QVariant();
}
void AbstractInputMethod::selectionListItemSelected(DeclarativeSelectionListModel::Type type, int index)
{
Q_UNUSED(type)
Q_UNUSED(index)
}
/*!
\property AbstractInputMethod::className
\brief Class name of this input method.
This property is used to distinguish different input method classes.
The class name is taken from the Qt meta class object.
*/
/*!
\fn QList<DeclarativeInputEngine::InputMode> AbstractInputMethod::inputModes(const QString& locale)
Returns the list of input modes for \a locale.
*/
/*!
\fn bool AbstractInputMethod::setInputMode(const QString& locale, DeclarativeInputEngine::InputMode inputMode)
Sets the \a inputMode and \a locale for this input method. Returns \c true
if successful.
*/
/*!
\fn bool AbstractInputMethod::setTextCase(DeclarativeInputEngine::TextCase textCase)
Updates the \a textCase for this input method. The method returns \c true
if successful.
*/
/*!
\fn bool AbstractInputMethod::keyEvent(Qt::Key key, const QString& text, Qt::KeyboardModifiers modifiers)
The purpose of this method is to handle the key events generated by the the
input engine.
The \a key parameter specifies the code of the key to handle. The key code
does not distinguish between capital and non-capital letters. The \a
text parameter contains the Unicode text for the key. The \a modifiers
parameter contains the key modifiers that apply to key.
This method returns \c true if the key event was successfully handled.
If the return value is \c false, the key event is redirected to the default
input method for futher processing.
*/
/*!
\fn QList<DeclarativeSelectionListModel::Type> AbstractInputMethod::selectionLists()
Returns the list of selection lists used by this input method.
This method is called by input engine when the input method is being
activated. The input method can reserve the selection lists for its use
by returning a list of selection list types required.
*/
/*!
\fn int AbstractInputMethod::selectionListItemCount(DeclarativeSelectionListModel::Type type)
211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243
Returns the number of items in the selection list identified by \a type.
*/
/*!
\fn QVariant AbstractInputMethod::selectionListData(DeclarativeSelectionListModel::Type type, int index, int role)
Returns item data for the selection list identified by \a type. The \a role
parameter specifies which data is requested. The \a index parameter is a
zero based index into the list.
*/
/*!
\fn void AbstractInputMethod::selectionListItemSelected(DeclarativeSelectionListModel::Type type, int index)
This method is called when an item at \a index has been selected by the
user. The selection list is identified by the \a type parameter.
*/
/*!
\fn void AbstractInputMethod::selectionListChanged(int type)
The input method emits this signal when the contents of the selection list
has changed. The \a type parameter specifies which selection list has
changed.
*/
/*!
\fn void AbstractInputMethod::selectionListActiveItemChanged(int type, int index)
The input method emits this signal when the current \a index has changed
in the selection list identified by \a type.
*/