View source for How to Enable Split-View Input for Text Editors in Symbian Qt Apps

{{Outdated|reason=The Symbian platform is no longer supported.}}
{{Cleanup | reason=Auto-imported from ExpressionEngine.}}

= How to Enable Split-View Input for Text Editors in Symbian Qt Apps =
Symbian^3 OS release has supported partial screen text input keyboard (also known as '''split-view input''') from the beginning but the initial release Symbian^3 didn't much take that into use. Later Symbian Anna and Belle releases' applications actually utilize the feature in most applications for text input. '''In Qt 4.7.4 the split-view input is also supported by the Qt''' implementation allowing '''extremely easy utilization''' of this feature in Qt applications.

Here's an example where touch input keyboards are closed:
[[Image:http://www.developer.nokia.com/Community/Wiki/images/4/46/Split-view_input_vkb_closed_60p.png |Example with editor but touch input keyboards are closed]]

By default Symbian opens full screen virtual keyboard when user taps an editor:
[[Image:http://www.developer.nokia.com/Community/Wiki/images/4/4b/Fullscreen_input_60p.png |Full screen input keyboard in Symbian]]

By default the text input keyboard takes up the whole screen when active. Prior to Qt 4.7.4 release there has also been no way to enable the partial screen text input keyboard in Qt apps without hacking deep into Avkon land. Starting from Qt 4.7.4 supporting partial screen text input keyboard becomes much easier. Application just needs to define one application attribute to achieve that virtual keyboard changes to split-view input as presented in following screen shots:

[[Image:http://www.developer.nokia.com/Community/Wiki/images/6/6a/Split-view_input_vkb_open_60p.png |Split-view input keyboard in Symbian - portrait]]
[[Image:http://www.developer.nokia.com/Community/Wiki/images/0/00/Split-view_input_vkb_open_in_landscape_60p.png |Split-view input keyboard in Symbian - portrait]]

Already Qt 4.7.3 defines an ApplicationAttribute flag [http://doc.qt.nokia.com/4.7-snapshot/qt.html#ApplicationAttribute-enum Qt::AA_S60DisablePartialScreenInputMode] for disabling partial screen input mode. By default the flag is set to true. In Qt 4.7.3 the flag has no effect, but starting from Qt 4.7.4 the flag can be used ''by setting it to false'' to enable partial screen keyboard for text editors.

Enabling the partial screen keyboard can be done simply by setting the ''Qt::AA_S60DisablePartialScreenInputMode'' flag to false somewhere in the main.cpp by calling ''QCoreApplication::setAttribute()'' in following way:

<code>QCoreApplication::setAttribute(Qt::AA_S60DisablePartialScreenInputMode, false);<code>

If the cursor of the input widget would get obscured by the partial screen keyboard when it opens, the widget is automatically moved so that the cursor will be visible on plaint Qt Quick (using QML) and C++ graphics view-based UIs. Text input widgets on QWidget-based UIs will not get moved automatically. Instead, the application will receive a resize event. Then it is up to the application to make sure that the input widget will not get obscured by the keyboard.

From the above screenshots from the [http://www.developer.nokia.com/Community/Wiki/images/6/6e/Split-ViewKeyboardForQtAppInSymbian.zip attached example application] which illustrate how the partial screen text input keyboard looks like, when enabled.

You can try out the new functionality with Qt 4.7.4 for Symbian which is already available as a beta target with the latest version of Qt SDK. Since all it takes to enable the partial screen text input keyboard is to add one line of code, it is easy to test if it will cause some issues in your application.
Qt 4.7.4 is not available in Smart Installer yet, so deploying partial screen text input-enabled applications to Nokia Store will need to wait some more time. However, since the flag that is needed to enable partial screen text input keyboard is available already in Qt 4.7.3, there should not be any harm in setting the ''Qt::AA_S60DisablePartialScreenInputMode'' to false already now.

One additional thing to note is that at the moment the application must have SwEvent capability in order to support predictive text input in partial screen input mode. SwEvent is one of the 13 capabilities for which Nokia Publish offers [https://www.developer.nokia.com/Distribute/Packaging_and_signing.xhtml free Symbian Signed certifications], so any publisher can safely take this capability into use once he/she obtains a valid developer certificate from Nokia Publish.

== Resources ==

* [http://www.developer.nokia.com/Community/Wiki/images/6/6e/Split-ViewKeyboardForQtAppInSymbian.zip Download example as source package]

[[Category:HowTo]]