1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
|
/****************************************************************************
**
** 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 "declarativeinputmethod.h"
#include <QVariant>
/*!
\qmltype InputMethod
\instantiates DeclarativeInputMethod
\inqmlmodule QtQuick.Enterprise.VirtualKeyboard
\ingroup qtvirtualkeyboard-qml
\brief Base type for creating input method in QML.
The InputMethod type lets you create a custom input method
which can be assigned to InputEngine.
*/
/*!
\qmlproperty string InputMethod::className
See AbstractInputMethod::className.
*/
/*!
\qmlproperty InputContext InputMethod::inputContext
The input context.
*/
/*!
\qmlproperty InputEngine InputMethod::inputEngine
The input engine.
*/
/*!
\qmlmethod list<int> InputMethod::inputModes(string locale)
Returns a list of input modes for \a locale.
*/
/*!
\qmlmethod bool InputMethod::setInputMode(string locale, int inputMode)
Changes \a inputMode and \a locale for this input method. The method returns
\c true if successful.
*/
/*!
\qmlmethod bool InputMethod::setTextCase(int textCase)
Updates \a textCase for this input method. The method returns \c true if
successful.
The possible values for the text case are:
\list
\li \c InputEngine.Lower Lower case text.
\li \c InputEngine.Upper Upper case text.
\endlist
*/
/*!
\qmlmethod bool InputMethod::keyEvent(int key, string text, int 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 \a 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.
*/
/*!
\qmlmethod InputMethod::reset()
This method is called by the input engine when this 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; it must not modify the input context.
*/
/*!
\qmlmethod InputMethod::update()
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 the internal state to the default.
*/
/*!
\qmlmethod list<int> InputMethod::selectionLists()
Returns the list of selection types used for this input method.
This method is called by the 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.
*/
/*!
\qmlmethod int InputMethod::selectionListItemCount(int type)
Returns the number of items in the selection list identified by \a type.
*/
/*!
\qmlmethod var InputMethod::selectionListData(int type, int index, int role)
Returns item data for a 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 selecteion list.
*/
/*!
\qmlmethod void InputMethod::selectionListItemSelected(int 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.
*/
/*!
\qmlsignal InputMethod::selectionListChanged(int type)
The input method emits this signal when the contents of the selection list
are changed. The \a type parameter specifies which selection list has
changed.
*/
/*!
\qmlsignal InputMethod::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.
*/
DeclarativeInputMethod::DeclarativeInputMethod(QObject *parent) :
AbstractInputMethod(parent)
{
}
DeclarativeInputMethod::~DeclarativeInputMethod()
{
}
QList<DeclarativeInputEngine::InputMode> DeclarativeInputMethod::inputModes(const QString &locale)
{
QVariant result;
QMetaObject::invokeMethod(this, "inputModes",
Q_RETURN_ARG(QVariant, result),
Q_ARG(QVariant, locale));
QList<DeclarativeInputEngine::InputMode> inputModeList;
foreach (const QVariant &inputMode, result.toList()) {
inputModeList.append(static_cast<DeclarativeInputEngine::InputMode>(inputMode.toInt()));
}
return inputModeList;
}
bool DeclarativeInputMethod::setInputMode(const QString &locale, DeclarativeInputEngine::InputMode inputMode)
{
QVariant result;
QMetaObject::invokeMethod(this, "setInputMode",
Q_RETURN_ARG(QVariant, result),
Q_ARG(QVariant, locale),
Q_ARG(QVariant, static_cast<int>(inputMode)));
return result.toBool();
}
bool DeclarativeInputMethod::setTextCase(DeclarativeInputEngine::TextCase textCase)
{
QVariant result;
QMetaObject::invokeMethod(this, "setTextCase",
Q_RETURN_ARG(QVariant, result),
Q_ARG(QVariant, static_cast<int>(textCase)));
return result.toBool();
}
bool DeclarativeInputMethod::keyEvent(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)
{
QVariant result;
QMetaObject::invokeMethod(this, "keyEvent",
Q_RETURN_ARG(QVariant, result),
Q_ARG(QVariant, key),
Q_ARG(QVariant, text),
Q_ARG(QVariant, (int)modifiers));
return result.toBool();
}
QList<DeclarativeSelectionListModel::Type> DeclarativeInputMethod::selectionLists()
{
QVariant result;
QMetaObject::invokeMethod(this, "selectionLists",
Q_RETURN_ARG(QVariant, result));
QList<DeclarativeSelectionListModel::Type> selectionListsList;
foreach (const QVariant &selectionListType, result.toList()) {
selectionListsList.append(static_cast<DeclarativeSelectionListModel::Type>(selectionListType.toInt()));
}
return selectionListsList;
}
int DeclarativeInputMethod::selectionListItemCount(DeclarativeSelectionListModel::Type type)
{
QVariant result;
QMetaObject::invokeMethod(this, "selectionListItemCount",
Q_RETURN_ARG(QVariant, result),
Q_ARG(QVariant, static_cast<int>(type)));
return result.toInt();
}
QVariant DeclarativeInputMethod::selectionListData(DeclarativeSelectionListModel::Type type, int index, int role)
{
QVariant result;
QMetaObject::invokeMethod(this, "selectionListData",
Q_RETURN_ARG(QVariant, result),
Q_ARG(QVariant, static_cast<int>(type)),
Q_ARG(QVariant, index),
Q_ARG(QVariant, role));
if (result.isNull()) {
result = AbstractInputMethod::selectionListData(type, index, role);
}
return result;
}
void DeclarativeInputMethod::selectionListItemSelected(DeclarativeSelectionListModel::Type type, int index)
{
QMetaObject::invokeMethod(this, "selectionListItemSelected",
Q_ARG(QVariant, static_cast<int>(type)),
Q_ARG(QVariant, index));
}
void DeclarativeInputMethod::reset()
{
QMetaObject::invokeMethod(this, "reset");
}
void DeclarativeInputMethod::update()
{
QMetaObject::invokeMethod(this, "update");
}
|
