InputMethod QML Type (Singleton)

Permet aux applications QML d'accéder à QInputMethod. En savoir plus...

Remarque : ce type est un singleton QML. Il n'existe qu'une seule instance de ce type dans le moteur QML.

• Liste de tous les membres, y compris les membres hérités

Propriétés

• anchorRectangle : rect
• animating : bool
• cursorRectangle : rect
• inputDirection : enumeration
• inputItemClipRectangle : rect
• keyboardRectangle : rect
• locale : Locale
• visible : bool

Méthodes

• void commit()
• void hide()
• void invokeAction(var a, int cursorPosition)
• void reset()
• void show()
• void update(enumeration queries)

Description détaillée

Le singleton InputMethod permet d'accéder à l'objet ` QInputMethod ` de l'application ainsi qu'à toutes ses propriétés et ses slots. Pour plus d'informations, consultez la documentation relative à l'interface ` QInputMethod `.

Documentation sur les propriétés

anchorRectangle : rect

Saisissez les coordonnées du rectangle d'ancrage de l'élément dans le système de coordonnées de la fenêtre.

Le rectangle d'ancrage est souvent utilisé par divers contrôles d'édition de texte, tels que les fenêtres contextuelles de prédiction de texte, pour suivre la sélection de texte.

animating : bool

Vrai lorsque le clavier virtuel est en cours d'ouverture ou de fermeture.

La valeur de cette propriété est « false » lorsque le clavier est complètement ouvert ou fermé. Lorsque animating vaut true et que visibility vaut true, le clavier est en cours d'ouverture. Lorsque animating vaut true et que visibility vaut « false », le clavier est en cours de fermeture.

cursorRectangle : rect

Rectangle du curseur de l'élément de saisie en coordonnées de fenêtre.

Le rectangle du curseur est souvent utilisé par divers contrôles d'édition de texte, tels que les fenêtres contextuelles de prédiction de texte, pour suivre le texte en cours de saisie.

inputDirection : enumeration

Sens d'entrée du courant.

Valeurs possibles :

inputItemClipRectangle : rect

Rectangle de découpe de l'élément de saisie en coordonnées de fenêtre.

Le rectangle de saisie découpé est souvent utilisé par diverses méthodes de saisie pour déterminer l'espace disponible à l'écran pour la méthode de saisie (par exemple, le clavier virtuel).

keyboardRectangle : rect

Géométrie du clavier virtuel en coordonnées de fenêtre.

Il peut s'agir d'un rectangle vide s'il n'est pas possible de connaître la géométrie du clavier. C'est le cas pour un clavier flottant sous Android.

locale : Locale

Locale de saisie actuelle.

visible : bool

Visibilité du clavier virtuel à l'écran

La valeur de cette propriété reste « false » pour les appareils ne disposant pas de clavier virtuel.

Voir également show() et hide().

Documentation des méthodes

void 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 fonctionnalités de prédiction de texte, ainsi que 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.

void hide()

Demande la fermeture du clavier virtuel.

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

void invokeAction(var 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.

Voir également QInputMethod::Action.

void 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 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 ».

En règle générale, les applications ne devraient pas avoir besoin d'appeler cette fonction, car le clavier devrait s'ouvrir automatiquement lorsque l'éditeur de texte reçoit le focus.

void update(enumeration queries)

Appelée par l'élément d'entrée pour informer les méthodes de saisie de la plateforme lorsque des changements d'état sont survenus 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é. Une méthode de saisie peut s'en servir pour interroger les attributs qui l'intéressent à l'aide de ` 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 `.

Voir également Qt::InputMethodQueries.