An error occurred while loading the file. Please try again.
-
Jarkko Koivikko authored
This change adds support for automatically hiding word candidate list when inactive. This feature includes the following enhancements: - Added new settings: * VirtualKeyboardSettings.wordCandidateList.autoHideDelay * VirtualKeyboardSettings.wordCandidateList.alwaysVisible - Automatic hiding of word candidate list when inactive and when autoHideDelay elapsed. - alwaysVisible setting restores the old functionality. - Added new signal selectionListsChanged() to input method, allowing the input method to dynamically allocate or deallocate selection lists. - HunspellInputMethod does not allocate selection list when dictionary cannot be loaded, or Qt::ImhNoPredictiveText is enabled. Also, it will no longer use pre-edit text in this case. - OpenWnnInputMethod does not allocate selection list if not needed. [ChangeLog] Automatically hide word candidate list when inactive. Change-Id: Ifa95ae8a7c47a96719ffdc2929601ff2ef9c0d2e Reviewed-by:
Gordan Markus <gordan.markus@pelagicore.com> Reviewed-by:
Mitch Curtis <mitch.curtis@qt.io>
839a0afe
abstractinputmethod.cpp 10.36 KiB
/******************************************************************************** Copyright (C) 2016 The Qt Company Ltd.** Contact: https://www.qt.io/licensing/**** This file is part of the Qt Virtual Keyboard module of the Qt Toolkit.**** $QT_BEGIN_LICENSE:GPL$** Commercial License Usage** Licensees holding valid commercial Qt licenses may use this file in** accordance with the commercial license agreement provided with the** Software or, alternatively, in accordance with the terms contained in** a written agreement between you and The Qt Company. For licensing terms** and conditions see https://www.qt.io/terms-conditions. For further** information use the contact form at https://www.qt.io/contact-us.**** GNU General Public License Usage** Alternatively, this file may be used under the terms of the GNU** General Public License version 3 or (at your option) any later version** approved by the KDE Free Qt Foundation. The licenses are as published by** the Free Software Foundation and appearing in the file LICENSE.GPL3** included in the packaging of this file. Please review the following** information to ensure the GNU General Public License requirements will** be met: https://www.gnu.org/licenses/gpl-3.0.html.**** $QT_END_LICENSE$******************************************************************************/#include "abstractinputmethod.h"namespace QtVirtualKeyboard {/*! \class QtVirtualKeyboard::AbstractInputMethodPrivate \internal*/AbstractInputMethodPrivate::AbstractInputMethodPrivate() : QObjectPrivate(), inputEngine(0){}/*! \class QtVirtualKeyboard::AbstractInputMethod \internal \inmodule qtvirtualkeyboard \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 dd as the private data from the derived class and \a parent as the parent.*/AbstractInputMethod::AbstractInputMethod(AbstractInputMethodPrivate &dd, QObject *parent) : QObject(dd, parent){}/*! Constructs an input method with \a parent.*/AbstractInputMethod::AbstractInputMethod(QObject *parent) : QObject(*new AbstractInputMethodPrivate(), parent)7172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
{
}
/*!
Destroys the input method and frees all allocated resources.
*/
AbstractInputMethod::~AbstractInputMethod()
{
}
/*!
Returns the input context associated with the input method.
This method returns \c NULL if the input method is not active.
*/
InputContext *AbstractInputMethod::inputContext() const
{
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.
*/
InputEngine *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(InputEngine *inputEngine)
{
Q_D(AbstractInputMethod);
if (d->inputEngine) {
d->inputEngine->disconnect(this, SLOT(reset()));
d->inputEngine->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<SelectionListModel::Type> AbstractInputMethod::selectionLists()
{
141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210
return QList<SelectionListModel::Type>();
}
int AbstractInputMethod::selectionListItemCount(SelectionListModel::Type type)
{
Q_UNUSED(type)
return 0;
}
QVariant AbstractInputMethod::selectionListData(SelectionListModel::Type type, int index, int role)
{
Q_UNUSED(type)
Q_UNUSED(index)
switch (role) {
case SelectionListModel::DisplayRole:
return QVariant("");
case SelectionListModel::WordCompletionLengthRole:
return QVariant(0);
}
return QVariant();
}
void AbstractInputMethod::selectionListItemSelected(SelectionListModel::Type type, int index)
{
Q_UNUSED(type)
Q_UNUSED(index)
}
/*!
\since QtQuick.VirtualKeyboard 2.0
Returns list of supported pattern recognition modes.
This method is called by the input engine to query the list of
supported pattern recognition modes.
*/
QList<InputEngine::PatternRecognitionMode> AbstractInputMethod::patternRecognitionModes() const
{
return QList<InputEngine::PatternRecognitionMode>();
}
/*!
\since QtQuick.VirtualKeyboard 2.0
This method is called when a trace interaction starts with the specified \a patternRecognitionMode.
The trace is uniquely identified by the \a traceId.
The \a traceCaptureDeviceInfo provides information about the source device and the
\a traceScreenInfo provides information about the screen context.
If the input method accepts the event and wants to capture the trace input, it must return
a new Trace object. This object must remain valid until the traceEnd() method is called. If the
Trace is rendered on screen, it remains there until the Trace object is destroyed.
*/
Trace *AbstractInputMethod::traceBegin(int traceId, InputEngine::PatternRecognitionMode patternRecognitionMode,
const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo)
{
Q_UNUSED(traceId)
Q_UNUSED(patternRecognitionMode)
Q_UNUSED(traceCaptureDeviceInfo)
Q_UNUSED(traceScreenInfo)
return 0;
}
/*!
\since QtQuick.VirtualKeyboard 2.0
This method is called when the trace interaction ends. The input method should destroy the \a trace object
at some point after this function is called. See the \l Trace API how to access the gathered
data.
211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280
The method returns \c true if the trace interaction is accepted.
*/
bool AbstractInputMethod::traceEnd(Trace *trace)
{
Q_UNUSED(trace)
return false;
}
/*!
\since QtQuick.VirtualKeyboard 2.0
This function attempts to reselect a word located at the \a cursorPosition.
The \a reselectFlags define the rules for how the word should be selected in
relation to the cursor position.
The function returns \c true if the word was successfully reselected.
*/
bool AbstractInputMethod::reselect(int cursorPosition, const InputEngine::ReselectFlags &reselectFlags)
{
Q_UNUSED(cursorPosition)
Q_UNUSED(reselectFlags)
return false;
}
/*!
\fn QList<InputEngine::InputMode> AbstractInputMethod::inputModes(const QString& locale)
Returns the list of input modes for \a locale.
*/
/*!
\fn bool AbstractInputMethod::setInputMode(const QString& locale, InputEngine::InputMode inputMode)
Sets the \a inputMode and \a locale for this input method. Returns \c true
if successful.
*/
/*!
\fn bool AbstractInputMethod::setTextCase(InputEngine::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<SelectionListModel::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 and every time the input method hints are updated. The input method
can reserve selection lists by returning the desired selection list types.
The input method may request the input engine to update the selection lists
281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332
at any time by emitting selectionListsChanged() signal. This signal will
trigger a call to this method, allowing the input method to update the selection
list types.
*/
/*!
\fn int AbstractInputMethod::selectionListItemCount(SelectionListModel::Type type)
Returns the number of items in the selection list identified by \a type.
*/
/*!
\fn QVariant AbstractInputMethod::selectionListData(SelectionListModel::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(SelectionListModel::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.
*/
/*!
\fn void AbstractInputMethod::selectionListsChanged()
\since QtQuick.VirtualKeyboard 2.2
The input method emits this signal when the selection list types have
changed. This signal will trigger a call to selectionLists() method,
allowing the input method to update the selection list types.
*/
} // namespace QtVirtualKeyboard