QVirtualKeyboardAbstractInputMethod Class

Documentation des fonctions membres

[explicit] QVirtualKeyboardAbstractInputMethod::QVirtualKeyboardAbstractInputMethod(QObject *parent = nullptr)

Crée une méthode de saisie à l'aide de ` parent`.

[virtual noexcept] QVirtualKeyboardAbstractInputMethod::~QVirtualKeyboardAbstractInputMethod()

Supprime la méthode de saisie et libère toutes les ressources allouées.

[virtual slot, since 6.1] void QVirtualKeyboardAbstractInputMethod::clearInputMode()

Efface le mode de saisie.

Cette méthode est appelée par le clavier virtuel lorsque cette méthode de saisie est remplacée par une autre. Elle doit effacer les opérations effectuées par la méthode ` setInputMode()`, par exemple pour déconnecter les gestionnaires de signaux du clavier virtuel ou libérer des ressources.

Le mode de saisie peut être réactivé en appelant ` setInputMode()`. Notez toutefois que les appels à `setInputMethod()` et `clearInputMethod()` ne sont pas équilibrés. Ainsi, par exemple, `setInputMethod()` peut être appelée plusieurs fois sans qu'il y ait d'appels correspondants à `clearInputMethod()`.

L'implémentation par défaut ne fait rien.

Cette fonction a été introduite dans Qt 6.1.

[virtual, since QtQuick.VirtualKeyboard 2.4] bool QVirtualKeyboardAbstractInputMethod::clickPreeditText(int cursorPosition)

Appelée lorsque l'utilisateur clique sur un texte pré-édité à l'adresse cursorPosition.

La fonction doit renvoyer true si elle gère l'événement. Sinon, la saisie est redirigée vers reselect() pour un traitement ultérieur.

Cette fonction a été introduite dans QtQuick.VirtualKeyboard 2.4.

QVirtualKeyboardInputContext *QVirtualKeyboardAbstractInputMethod::inputContext() const

Renvoie le contexte de saisie associé à la méthode de saisie. Cette méthode renvoie « NULL » si la méthode de saisie n'est pas active.

QVirtualKeyboardInputEngine *QVirtualKeyboardAbstractInputMethod::inputEngine() const

Renvoie le moteur de saisie associé à la méthode de saisie. Cette méthode renvoie « NULL » si la méthode de saisie n'est pas active.

[pure virtual] QList<QVirtualKeyboardInputEngine::InputMode> QVirtualKeyboardAbstractInputMethod::inputModes(const QString &locale)

Renvoie la liste des modes de saisie pour locale.

[pure virtual] bool QVirtualKeyboardAbstractInputMethod::keyEvent(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)

Cette méthode a pour but de gérer les événements de touche générés par le moteur d'entrée.

Le paramètre ` key ` spécifie le code de la touche à traiter. Le code de la touche ne fait pas la distinction entre les majuscules et les minuscules. Le paramètre ` text ` contient le texte Unicode correspondant à la touche. Le paramètre ` modifiers ` contient les modificateurs de touche qui s'appliquent à cette touche.

Cette méthode renvoie ` true ` si l'événement de touche a été géré avec succès. Si la valeur de retour est ` false`, l'événement de touche est redirigé vers la méthode de saisie par défaut pour un traitement ultérieur.

[virtual, since QtQuick.VirtualKeyboard 2.0] QList<QVirtualKeyboardInputEngine::PatternRecognitionMode> QVirtualKeyboardAbstractInputMethod::patternRecognitionModes() const

Renvoie la liste des modes de reconnaissance de motifs pris en charge.

Cette méthode est appelée par le moteur de saisie pour interroger la liste des modes de reconnaissance de motifs pris en charge.

Cette fonction a été introduite dans QtQuick.VirtualKeyboard 2.0.

[virtual, since QtQuick.VirtualKeyboard 2.0] bool QVirtualKeyboardAbstractInputMethod::reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags)

Cette fonction tente de resélectionner un mot situé à l'cursorPosition. Les paramètres reselectFlags définissent les règles de sélection du mot par rapport à la position du curseur.

La fonction renvoie true si le mot a été resélectionné avec succès.

Cette fonction a été introduite dans QtQuick.VirtualKeyboard 2.0.

[virtual slot] void QVirtualKeyboardAbstractInputMethod::reset()

Cette méthode est appelée par le moteur de saisie lorsque la méthode de saisie doit être réinitialisée. La méthode de saisie doit uniquement réinitialiser son état interne. La principale différence par rapport à la méthode ` update()` réside dans le fait que `reset()` ne modifie que l'état de la méthode de saisie ; en d'autres termes, elle ne doit pas modifier le contexte de saisie.

[signal] void QVirtualKeyboardAbstractInputMethod::selectionListActiveItemChanged(QVirtualKeyboardSelectionListModel::Type type, int index)

La méthode d'entrée émet ce signal lorsque l'index e actuelle a changé dans la liste de sélection identifiée par type.

[signal] void QVirtualKeyboardAbstractInputMethod::selectionListChanged(QVirtualKeyboardSelectionListModel::Type type)

La méthode d'entrée émet ce signal lorsque le contenu de la liste de sélection a changé. Le paramètre « type » précise quelle liste de sélection a changé.

[virtual] QVariant QVirtualKeyboardAbstractInputMethod::selectionListData(QVirtualKeyboardSelectionListModel::Type type, int index, QVirtualKeyboardSelectionListModel::Role role)

Renvoie les données relatives aux éléments de la liste de sélection identifiée par ` type`. Le paramètre ` role ` précise les données demandées. Le paramètre ` index ` correspond à un index de la liste, dont la valeur de départ est zéro.

[virtual] int QVirtualKeyboardAbstractInputMethod::selectionListItemCount(QVirtualKeyboardSelectionListModel::Type type)

Renvoie le nombre d'éléments de la liste de sélection identifiée par type.

[virtual] void QVirtualKeyboardAbstractInputMethod::selectionListItemSelected(QVirtualKeyboardSelectionListModel::Type type, int index)

Cette méthode est appelée lorsqu'un élément de l'index a été sélectionné par l'utilisateur. La liste de sélection est identifiée par le paramètre type.

[virtual] bool QVirtualKeyboardAbstractInputMethod::selectionListRemoveItem(QVirtualKeyboardSelectionListModel::Type type, int index)

Cette méthode est appelée lorsqu'un élément situé à l'adresse index doit être supprimé du dictionnaire. La liste de sélection est identifiée par le paramètre type. La fonction renvoie la valeur « true » si le mot a bien été supprimé.

[virtual] QList<QVirtualKeyboardSelectionListModel::Type> QVirtualKeyboardAbstractInputMethod::selectionLists()

Renvoie la liste des listes de sélection utilisées par cette méthode de saisie.

Cette méthode est appelée par le moteur de saisie lors de l’activation de la méthode de saisie et à chaque mise à jour des suggestions de la méthode de saisie. La méthode de saisie peut réserver des listes de sélection en renvoyant les types de listes de sélection souhaités.

La méthode de saisie peut demander au moteur de saisie de mettre à jour les listes de sélection à tout moment en émettant un signal ` selectionListsChanged()`. Ce signal déclenche un appel à cette méthode, permettant ainsi à la méthode de saisie de mettre à jour les types de listes de sélection.

[signal, since QtQuick.VirtualKeyboard 2.2] void QVirtualKeyboardAbstractInputMethod::selectionListsChanged()

La méthode de saisie émet ce signal lorsque les types de la liste de sélection ont changé. Ce signal déclenche l'appel de la méthode selectionLists(), ce qui permet à la méthode de saisie de mettre à jour les types de la liste de sélection.

Cette fonction a été introduite dans QtQuick.VirtualKeyboard 2.2.

[pure virtual] bool QVirtualKeyboardAbstractInputMethod::setInputMode(const QString &locale, QVirtualKeyboardInputEngine::InputMode inputMode)

Définit les paramètres « inputMode » et « locale » pour cette méthode de saisie. Renvoie « true » en cas de succès.

[pure virtual] bool QVirtualKeyboardAbstractInputMethod::setTextCase(QVirtualKeyboardInputEngine::TextCase textCase)

Met à jour l'textCase e de cette méthode de saisie. La méthode renvoie « true » en cas de réussite.

[virtual, since QtQuick.VirtualKeyboard 2.0] QVirtualKeyboardTrace *QVirtualKeyboardAbstractInputMethod::traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo)

Cette méthode est appelée lorsqu'une interaction de trace débute avec l'patternRecognitionMode spécifié. La trace est identifiée de manière unique par l'traceId. L'traceCaptureDeviceInfo fournit des informations sur le périphérique source et l'traceScreenInfo fournit des informations sur le contexte d'écran.

Si la méthode de saisie accepte l’événement et souhaite capturer la saisie de trace, elle doit renvoyer un nouvel objet ` QVirtualKeyboardTrace `. Cet objet doit rester valide jusqu’à ce que la méthode ` traceEnd()` soit appelée. Si l’objet ` QVirtualKeyboardTrace ` est affiché à l’écran, il y reste jusqu’à ce que l’objet ` QVirtualKeyboardTrace ` soit détruit.

Cette fonction a été introduite dans QtQuick.VirtualKeyboard 2.0.

[virtual, since QtQuick.VirtualKeyboard 2.0] bool QVirtualKeyboardAbstractInputMethod::traceEnd(QVirtualKeyboardTrace *trace)

Cette méthode est appelée lorsque l'interaction de trace prend fin. La méthode d'entrée doit détruire l'objet ` trace ` à un moment donné après l'appel de cette fonction. Consultez la section « API de trace pour les méthodes d'entrée » pour savoir comment accéder aux données collectées.

La méthode renvoie true si l'interaction de trace est acceptée.

Cette fonction a été introduite dans QtQuick.VirtualKeyboard 2.0.

[virtual slot] void QVirtualKeyboardAbstractInputMethod::update()

Cette méthode est appelée par le moteur de saisie lorsque la méthode de saisie doit être mise à jour. La méthode de saisie doit fermer le texte en pré-édition et rétablir son état interne par défaut.