QInputMethod Class

Documentation des fonctions membres

[slot] void QInputMethod::commit()

Enregistre le mot que l'utilisateur est en train de rédiger dans l'éditeur. Cette fonction est principalement utilisée par les méthodes de saisie dotées de fonctionnalités de prédiction de texte et par celles où le script utilisé pour saisir les caractères diffère de celui qui est effectivement ajouté à l'éditeur. Toute action interrompant la saisie de texte doit vider l'état de saisie en appelant la fonction commit(), par exemple lorsque le curseur est déplacé ailleurs.

[slot] void QInputMethod::hide()

Demande la fermeture du clavier virtuel.

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

QRectF QInputMethod::inputItemRectangle() const

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

Voir également setInputItemRectangle().

QTransform QInputMethod::inputItemTransform() const

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

Voir aussi setInputItemTransform().

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

Appelée par l'élément de saisie lorsque l'utilisateur appuie sur le mot en cours de saisie, comme indiqué par l'action a et l'cursorPosition fournie. Les méthodes de saisie utilisent souvent ces informations pour proposer davantage de suggestions de mots à l'utilisateur.

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

Envoie la fonction « query » à l'objet actuellement sélectionné avec les paramètres « argument » et renvoie le résultat.

[slot] void QInputMethod::reset()

Réinitialise l'état de la méthode de saisie. Par exemple, un éditeur de texte appelle généralement cette méthode avant d'insérer du texte afin de préparer le widget à accepter du texte.

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

void QInputMethod::setInputItemRectangle(const QRectF &rect)

Définit la géométrie de l'élément d'entrée sur rect, dans les coordonnées de l'élément d'entrée. Cette valeur doit être mise à jour par la fenêtre active (telle que QQuickCanvas) chaque fois que l'élément est déplacé à l'intérieur de la scène ou que le focus change.

Voir également ` inputItemRectangle()`.

void QInputMethod::setInputItemTransform(const QTransform &transform)

Définit la transformation des coordonnées des éléments d'entrée en coordonnées de la fenêtre comme suit : transform. La transformation des éléments doit être mise à jour par la fenêtre active, telle que QQuickCanvas, chaque fois qu'un é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 à l'appel de ` show()` (si ` visible ` vaut ` true`) ou de ` hide()` (si ` visible ` vaut ` false`).

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

[slot] void QInputMethod::show()

Demande l'ouverture du clavier virtuel. Si la plateforme ne propose pas de clavier virtuel, la propriété « visibility » reste définie sur « false ».

Normalement, les applications ne devraient pas avoir besoin d'appeler cette fonction ; le clavier devrait s'ouvrir automatiquement lorsque l'éditeur de texte reçoit le focus.

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

Appelée par l'élément de saisie pour informer les méthodes de saisie de la plateforme lorsqu'il y a eu des changements d'état dans les attributs de requête de la méthode de saisie de l'éditeur. Lors de l'appel de la fonction, le paramètre ` queries ` doit être utilisé pour indiquer ce qui a changé ; chaque méthode de saisie peut ainsi effectuer des requêtes sur les attributs qui l'intéressent via ` QInputMethodQueryEvent`.

Il est notamment important d’appeler `update` chaque fois que la position du curseur change, car cela entraîne souvent la modification d’autres attributs de requête, tels que le texte environnant et la sélection de texte. Pour plus de commodité, les attributs qui changent souvent en même temps que la position du curseur ont été regroupés dans la valeur ` Qt::ImQueryInput `.