Android User Navigation (Vorschau)

Devcorner
Dasher, Teil II
Wichtige Attribute
Zusätzlich zum extra Editierfeld wird automatisch
rechts daneben ein Aktion-Knopf angezeigt.
Dieser wird mit dem
android:imeOptions-Attribut des darunterliegenden
Texteditors definiert, und ermöglicht
dem Benutzer einen schnellen Zugang zu
den gebräuchlichen Funktionen wie zum
Beispiel Go, Search, Send, Next und Done,
ohne in die ursprüngliche Applikation zurückkehren
zu müssen. Ein zweites wichtiges
Attribut des Texteditors,
android:inputType, informiert die Inputmethode,
welche Art von Text zu erwarten ist.
Die Input-Methode erhält beim Starten jeder
neuen Texteingabe diese Informationen in
Form eines EditorInfo-Objektes. Je nach
Textart könnte somit eine spezielle Textvorhersage-Datenbank
angewendet werden.
Daher ist es ratsam, diese Attribute im Hinblick
auf verschiedene mögliche Texteingabe-
Methoden genau zu definieren.
Abb. 4: Dasher Input-Feld auf einem Android-Bildschirm in horizontaler Lage. Grau markiert
sind Leerzeichen. Der Button ^ stellt von Klein- auf Großbuchstaben um.
Die Eingabemethode
Damit Dasher jeder Text-Änderung angepasst
werden kann, muss die Eingabemethode sowohl
den aktuellen Text als auch die Cursor-
Position im Editor-Feld der Applikation ermitteln
können. Das InputConnection-Interface
des InputMethodService dient als Kommunikationskanal
zwischen dem Texteditor
und der Eingabemethode. Da eine Applikation
mehrere Texteditorfelder enthalten kann,
muss der aktuelle Kanal mithilfe von getCurrentInputConnection()
immer neu bestimmt
werden. Listing 1 zeigt als Beispiel, wie der
Dasher-Service die aktuelle Cursor-Position
innerhalb des Editor-Textes eruiert.
Wie bereits betont, stellt das extra Editierfeld,
das im Fullscreeen-Modus erscheint,
eine Art Kopie des darunterliegenden aktiven
Textfeldes dar. Die beiden kommunizieren
aber miteinander: Wird dem Applikationstextfeld
neuer Text via InputConnection geschickt,
so wird dieser im extra Editierfeld
sofort aufgefrischt. Des Weiteren wird das
Erstere benachrichtigt, sobald der Text im
extra Editierfeld angeklickt oder über die
Standard-Funktionen cut oder paste geändert
wurde. Damit neue Symbole nicht nur
am Ende, sondern auch innerhalb des aktuellen
Textes eingefügt werden können, hält das
System standardmässig jede Änderung der
Cursorposition fest. Der neue Text wird dann
mithilfe von setComposingText(,1)
an der entsprechenden Stelle angefügt (Listing
2).
Die angefügten Zeichen müssen aber wieder
gelöscht werden können; entweder sobald
man im Dasher eine neue Richtung einschlägt
und das Wahrscheinlichkeits-Quadrat
des bereits gesetzten Symbols das zentrale
Kreuz wieder verlässt, oder aber wenn man
mit Dasher rückwärts navigiert. Um das zuletzt
gesetzte Zeichen aus dem Textfeld zu
löschen, werden die folgenden zwei rohen
Tastenereignisse (raw key events) via Input-
Connection an die Applikation geschickt (Listing
3).
Alle Ereignisse, die durch eine Selektionsänderung
im extra Editierfeld verursacht
werden, müssen über die Methode onUpdate-
Selection(...) abgefangen werden. Hier
muss die Methode der super-Klasse aufgerufen
werden, damit das Default-Verhalten bei
solchen Ereignissen gewährleistet ist. Dasher
wird entsprechend der Änderung der Cursorposition
aufgefrischt: Das Quadrat des letzten
Buchstabens vor dem Cursor wird in der
Mitte des Bildschirms platziert, als ob es gerade
das Zentralkreuz passiert hätte. Wichtig
ist auch der Aufruf von finishComposing-
Text(), damit die neue Position des Cursors
Listing 2: Neuen Text einfügen
public void pushSymbol(Symbol symbol, boolean alt) {
mComposing.append((alt symbol.getVariant() : symbol.getLabel()));
...
InputConnection icx = getCurrentInputConnection();
if (icx != null)
icx.setComposingText(mComposing, 1);
}
Listing 3: Text löschen
icx.sendKeyEvent(new KeyEvent(KeyEvent.ACTION_DOWN, KeyEvent.KEYCODE_DEL));
icx.sendKeyEvent(new KeyEvent(KeyEvent.ACTION_UP, KeyEvent.KEYCODE_DEL));
Android-user.de März 2012 111