QInputMethodEvent Class

Ausführliche Beschreibung

Eingabemethode-Ereignisse werden an Widgets gesendet, wenn eine Eingabemethode zur Texteingabe in ein Widget verwendet wird. Eingabemethoden werden häufig zur Texteingabe für Sprachen mit nicht-lateinischen Alphabeten verwendet.

Beachten Sie, dass beim Erstellen benutzerdefinierter Textbearbeitungs-Widgets das Fensterattribut „ Qt::WA_InputMethodEnabled “ explizit (mithilfe der Funktion „ QWidget::setAttribute()“) gesetzt werden muss, um Eingabemethoden-Ereignisse empfangen zu können.

Die Ereignisse sind für Entwickler von Tastatureingabe-Widgets von Interesse, die Sprachen mit komplexer Zeicheneingabe korrekt verarbeiten möchten. Die Texteingabe in solchen Sprachen erfolgt in der Regel in drei Schritten:

1. Beginn der Eingabe

   Wenn der Benutzer die erste Taste auf einer Tastatur drückt, wird ein Eingabekontext erstellt. Dieser Eingabekontext enthält eine Zeichenkette aus den eingegebenen Zeichen.

2. Erstellen

   Mit jedem neuen Tastendruck versucht die Eingabemethode, eine passende Zeichenkette für den bisher eingegebenen Text zu erstellen, die als „Preedit-Zeichenkette“ bezeichnet wird. Solange der Eingabekontext aktiv ist, kann der Benutzer den Cursor nur innerhalb der zu diesem Eingabekontext gehörenden Zeichenkette bewegen.

3. Vervollständigung

   Zu einem bestimmten Zeitpunkt aktiviert der Benutzer eine Komponente der Benutzeroberfläche (möglicherweise über eine bestimmte Taste), in der er aus einer Reihe von Zeichenfolgen auswählen kann, die mit dem bisher eingegebenen Text übereinstimmen. Der Benutzer kann entweder seine Auswahl bestätigen oder die Eingabe abbrechen; in beiden Fällen wird der Eingabekontext geschlossen.

QInputMethodEvent modelliert diese drei Phasen und überträgt die Informationen, die zur korrekten Darstellung des Zwischenergebnisses benötigt werden. Ein QInputMethodEvent verfügt über zwei Hauptparameter: ` preeditString()` und ` commitString()`. Der Parameter ` preeditString()` gibt die aktuell aktive Preedit-Zeichenkette zurück. Der Parameter ` commitString()` gibt einen Text zurück, der dem Text des Editor-Widgets hinzugefügt werden (oder Teile davon ersetzen) soll. Er ist in der Regel das Ergebnis der Eingabeoperationen und muss direkt vor der Preedit-Zeichenkette in den Text des Widgets eingefügt werden.

Sollte die Funktion „ commitString()“ Teile des Textes im Editor ersetzen, enthält „ replacementLength()“ die Anzahl der zu ersetzenden Zeichen. „ replacementStart()“ enthält die Position, an der Zeichen relativ zum Anfang der Preedit-Zeichenkette ersetzt werden sollen.

Eine Reihe von Attributen steuert die visuelle Darstellung der Preedit-Zeichenkette (die visuelle Darstellung von Text außerhalb der Preedit-Zeichenkette wird ausschließlich vom Widget gesteuert). Die Enumeration ` AttributeType ` beschreibt die verschiedenen Attribute, die gesetzt werden können.

Eine Klasse, die QWidget::inputMethodEvent() oder QGraphicsItem::inputMethodEvent() implementiert, sollte zumindest die Attribute TextFormat und Cursor verstehen und berücksichtigen.

Da Eingabemethoden in der Lage sein müssen, bestimmte Eigenschaften vom Widget oder Grafikelement abzufragen, müssen Unterklassen ebenfalls die Methoden ` QWidget::inputMethodQuery()` bzw. ` QGraphicsItem::inputMethodQuery()` implementieren.

Beim Empfang eines Ereignisses der Eingabemethode muss das Text-Widget die folgenden Schritte ausführen:

1. Wenn das Widget ausgewählten Text enthält, sollte dieser entfernt werden.
2. Entferne den Text, beginnend bei ` replacementStart()` mit der Länge ` replacementLength()`, und ersetze ihn durch ` commitString()`. Ist ` replacementLength()` gleich 0, liefert ` replacementStart()` die Einfügeposition für ` commitString()`.

   Beim Ersetzen wird der Bereich der Preedit-Zeichenkette ignoriert. Daher entfernt ein Ersetzen, das bei -1 beginnt und eine Länge von 2 hat, das letzte Zeichen vor der Preedit-Zeichenkette und das erste Zeichen danach und fügt die Commit-Zeichenkette direkt vor der Preedit-Zeichenkette ein.

   Wenn das Widget „Rückgängig“ und „Wiederherstellen“ unterstützt, wird dieser Vorgang dem Rückgängig-Stapel hinzugefügt.

3. Wenn derzeit kein „preedit“-String vorhanden ist, wird der „ preeditString()“ an der aktuellen Cursorposition eingefügt; andernfalls wird der vorherige „ preeditString “ durch den aus diesem Ereignis empfangenen ersetzt.

   Wenn das Widget „Rückgängig/Wiederherstellen“ implementiert, darf die Funktion ` preeditString()` den Rückgängig-Stapel in keiner Weise beeinflussen.

   Das Widget sollte die Liste der Attribute prüfen, die auf die Vorbearbeitungszeichenfolge anzuwenden sind. Es muss mindestens die Attribute ` TextFormat ` und `Cursor` verstehen und diese wie angegeben darstellen.