QVirtualKeyboardAbstractInputMethod Class

Documentation des fonctions membres

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

Construit une méthode d'entrée avec parent.

[virtual noexcept] QVirtualKeyboardAbstractInputMethod::~QVirtualKeyboardAbstractInputMethod()

Détruit la méthode d'entrée 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 méthode de saisie. 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 la méthode setInputMode(). Notez cependant que les appels à setInputMethod() et clearInputMethod() ne sont pas équilibrés. Ainsi, par exemple, setInputMethod() peut être appelé plusieurs fois sans que les appels à clearInputMethod() ne correspondent.

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 le texte pré-édité à l'adresse cursorPosition.

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

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

QVirtualKeyboardInputContext *QVirtualKeyboardAbstractInputMethod::inputContext() const

Renvoie le contexte d'entrée associé à la méthode d'entrée. Cette méthode renvoie NULL si la méthode d'entrée 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 d'entrée pour locale.

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

L'objectif de cette méthode est de gérer les événements de clé générés par le moteur de saisie.

Le paramètre key spécifie le code de la clé à gérer. Le code de la clé ne fait pas de distinction entre les lettres majuscules et non majuscules. Le paramètre text contient le texte Unicode de la clé. Le paramètre modifiers contient les modificateurs de clé qui s'appliquent à la clé.

Cette méthode renvoie true si l'événement clé a été traité avec succès. Si la valeur de retour est false, l'événement clé est redirigé vers la méthode d'entrée par défaut pour la suite du traitement.

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

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

Cette méthode est appelée par le moteur de saisie pour demander la liste des modes de reconnaissance des formes 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'adresse cursorPosition. L'adresse reselectFlags définit 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 d'entrée doit uniquement réinitialiser son état interne. La principale différence avec la méthode update() est que reset() ne modifie que l'état de la méthode d'entrée, c'est-à-dire qu'elle ne doit pas modifier le contexte d'entrée.

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

La méthode d'entrée émet ce signal lorsque le site index en cours 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 indique la liste de sélection qui a été modifiée.

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

Renvoie les données relatives à la liste de sélection identifiée par type. Le paramètre role spécifie les données demandées. Le paramètre index est un index basé sur zéro dans la liste.

[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 lorsque l'utilisateur a sélectionné un élément à l'adresse index. 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 retiré du dictionnaire. La liste de sélection est identifiée par le paramètre type. La fonction renvoie true si le mot a été supprimé avec succès.

[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 lorsque la méthode de saisie est activée et à chaque fois que les indices de la méthode de saisie sont mis à jour. 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 d'entrée peut demander au moteur d'entrée de mettre à jour les listes de sélection à tout moment en émettant le signal selectionListsChanged(). Ce signal déclenche un appel à cette méthode, ce qui permet à 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 input émet ce signal lorsque les types de la liste de sélection ont changé. Ce signal déclenche un appel à la méthode selectionLists(), ce qui permet à la méthode input 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 valeurs inputMode et locale pour cette méthode d'entrée. Retourne true en cas de succès.

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

Met à jour le site textCase pour cette méthode d'entrée. La méthode renvoie true en cas de succès.

[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 traçage commence avec l'adresse patternRecognitionMode spécifiée. La trace est identifiée de manière unique par l'objet traceId. L'objet traceCaptureDeviceInfo fournit des informations sur le périphérique source et l'objet traceScreenInfo fournit des informations sur le contexte de l'écran.

Si la méthode d'entrée accepte l'événement et souhaite capturer l'entrée de la 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 la trace se termine. La méthode d'entrée doit détruire l'objet trace à un moment donné après l'appel de cette fonction. Voir l'API 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 traçage 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 cours de pré-édition et rétablir son état interne par défaut.