QInputMethod Class

Documentation des fonctions membres

[slot] void QInputMethod::commit()

Enregistre le mot que l'utilisateur est en train de composer dans l'éditeur. Cette fonction est principalement utilisée par les méthodes de saisie dotées de fonctions de prédiction de texte et par les méthodes dans lesquelles le script utilisé pour taper les caractères est différent du script qui est réellement ajouté à l'éditeur. Toute action interrompant la composition du texte doit effacer l'état de composition en appelant la fonction commit(), par exemple lorsque le curseur est déplacé ailleurs.

[slot] void QInputMethod::hide()

Demande la fermeture du clavier virtuel.

Normalement, les applications ne devraient pas avoir besoin d'appeler cette fonction, le clavier devant se fermer automatiquement lorsque l'éditeur de texte perd le focus, par exemple lorsque la vue parentale est fermée.

QRectF QInputMethod::inputItemRectangle() const

Renvoie la géométrie de l'élément d'entrée dans les coordonnées de l'élément d'entrée.

Voir aussi setInputItemRectangle().

QTransform QInputMethod::inputItemTransform() const

Renvoie la transformation des coordonnées de l'élément d'entrée en coordonnées de la fenêtre.

Voir aussi setInputItemTransform().

[slot] void QInputMethod::invokeAction(QInputMethod::Action a, int cursorPosition)

Appelé par l'élément de saisie lorsque le mot en cours de composition est touché par l'utilisateur, comme indiqué par l'action a et la donnée cursorPosition. Les méthodes de saisie utilisent souvent cette information pour proposer davantage de suggestions de mots à l'utilisateur.

[static] QVariant QInputMethod::queryFocusObject(Qt::InputMethodQuery query, const QVariant &argument)

Envoyer query à l'objet focus actuel avec les paramètres argument et renvoyer le résultat.

[slot] void QInputMethod::reset()

Réinitialise l'état de la méthode de saisie. Par exemple, un éditeur de texte appelle normalement cette méthode avant d'insérer un texte pour que le widget soit prêt à accepter un texte.

La méthode de saisie se réinitialise automatiquement lorsque l'éditeur ciblé change.

void QInputMethod::setInputItemRectangle(const QRectF &rect)

Définit la géométrie de l'élément d'entrée comme étant rect, dans les coordonnées de l'élément d'entrée. Ceci doit être mis à jour par la fenêtre focalisée comme QQuickCanvas chaque fois que l'élément est déplacé à l'intérieur de la scène, ou que le focus est changé.

Voir aussi inputItemRectangle().

void QInputMethod::setInputItemTransform(const QTransform &transform)

Définit la transformation des coordonnées de l'élément d'entrée en coordonnées de la fenêtre à transform. La transformation de l'élément doit être mise à jour par la fenêtre focalisée, comme QQuickCanvas, chaque fois que l'élément est déplacé à l'intérieur de la scène.

Voir également inputItemTransform().

void QInputMethod::setVisible(bool visible)

Contrôle la visibilité du clavier. Équivaut à appeler show() (si visible est true) ou hide() (si visible est false).

Voir également isVisible(), show() et hide().

[slot] void QInputMethod::show()

Demande l'ouverture du clavier virtuel. Si la plate-forme ne fournit pas de clavier virtuel, la visibilité reste fausse.

Normalement, les applications ne devraient pas avoir besoin d'appeler cette fonction, car le clavier devrait s'ouvrir automatiquement lorsque l'éditeur de texte est mis en évidence.

[slot] void QInputMethod::update(Qt::InputMethodQueries queries)

Appelée par l'élément d'entrée pour informer les méthodes d'entrée de la plate-forme des changements d'état dans les attributs d'interrogation de la méthode d'entrée de l'éditeur. Lors de l'appel de la fonction queries, le paramètre doit être utilisé pour indiquer ce qui a changé, ce que la méthode d'entrée peut utiliser pour effectuer des requêtes pour les attributs qui l'intéressent QInputMethodQueryEvent.

En particulier, il est important d'appeler la mise à jour chaque fois que la position du curseur change, car cela entraîne souvent la modification d'autres attributs de la requête, tels que le texte environnant et la sélection de texte. Les attributs qui changent souvent en même temps que la position du curseur ont été regroupés dans la valeur Qt::ImQueryInput pour des raisons de commodité.