InputContext QML Type (Singleton)
Permet d'accéder à un contexte de saisie. En savoir plus...
| Import Statement: | import QtQuick.VirtualKeyboard |
| In C++: | QVirtualKeyboardInputContext |
Remarque : ce type est un singleton QML. Il n'existe qu'une seule instance de ce type dans le moteur QML.
Propriétés
- anchorPosition : int
(since QtQuick.VirtualKeyboard 2.2) - anchorRectIntersectsClipRect : bool
- anchorRectangle : rect
(since QtQuick.VirtualKeyboard 2.1) - animating : bool
- capsLockActive : bool
(since QtQuick.VirtualKeyboard 2.4) - cursorPosition : int
- cursorRectIntersectsClipRect : bool
- cursorRectangle : rect
- inputEngine : InputEngine
- inputMethodHints : int
- keyboardObserver : KeyboardObserver
(since 6.1) - locale : string
- preeditText : string
- selectedText : string
- selectionControlVisible : bool
- shiftActive : bool
(since QtQuick.VirtualKeyboard 2.4) - surroundingText : string
- uppercase : bool
(since QtQuick.VirtualKeyboard 2.2)
Méthodes
- void clear()
- void commit()
- void commit(string text, int replaceFrom, int replaceLength)
- void sendKeyClick(int key, string text, int modifiers)
Description détaillée
L'InputContext est accessible en tant qu'instance singleton.
Documentation des propriétés
anchorPosition : int [read-only, since QtQuick.VirtualKeyboard 2.2]
Cette propriété est modifiée lorsque la position de l'ancrage change.
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 2.2.
anchorRectIntersectsClipRect : bool [read-only]
Renvoie « true » si le rectangle englobant du point d'ancrage de sélection recoupe le rectangle de l'élément d'entrée exposé.
Voir également Qt::ImAnchorRectangle et Qt::ImInputItemClipRectangle.
anchorRectangle : rect [read-only, since QtQuick.VirtualKeyboard 2.1]
Cette propriété est modifiée lorsque le rectangle d'ancrage change.
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 2.1.
animating : bool
Utilisez cette propriété pour définir l'état d'animation, par exemple lors des transitions entre les états de l'interface utilisateur.
capsLockActive : bool [read-only, since QtQuick.VirtualKeyboard 2.4]
Cette propriété est modifiée lorsque l'état du verrouillage des majuscules change.
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 2.4.
cursorPosition : int [read-only]
Cette propriété change lorsque la position du curseur change.
cursorRectIntersectsClipRect : bool [read-only]
Renvoie true si le rectangle englobant du curseur de saisie coupe le rectangle de l'élément de saisie exposé.
Voir également Qt::ImCursorRectangle et Qt::ImInputItemClipRectangle.
cursorRectangle : rect [read-only]
Cette propriété est modifiée lorsque le rectangle du curseur change.
inputEngine : InputEngine [read-only]
Cette propriété stocke le moteur de saisie.
inputMethodHints : int [read-only]
Cette propriété est modifiée lorsque les suggestions de la méthode de saisie changent.
keyboardObserver : KeyboardObserver [read-only, since 6.1]
Contient l'objet observateur du clavier, qui permet de recevoir des notifications d'événements liés aux modifications du clavier.
Cette propriété a été introduite dans Qt 6.1.
locale : string [read-only]
Cette propriété est modifiée lorsque les paramètres régionaux de saisie changent.
preeditText : string
Cette propriété définit le texte d'aperçu.
selectedText : string [read-only]
Cette propriété est modifiée lorsque le texte sélectionné change.
selectionControlVisible : bool [read-only]
Contient la valeur « true » si le contrôle de sélection est actuellement visible.
shiftActive : bool [read-only, since QtQuick.VirtualKeyboard 2.4]
Cette propriété est modifiée lorsque l'état du mode Maj change.
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 2.4.
surroundingText : string [read-only]
Cette propriété est modifiée lorsque le texte entourant le curseur change.
uppercase : bool [read-only, since QtQuick.VirtualKeyboard 2.2]
Cette propriété est définie comme « true » lorsque l'une des valeurs suivantes est « true » : « shiftActive » ou « capsLockActive ».
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 2.2.
Documentation de la méthode
void clear()
Efface le texte saisi avant la modification.
void commit()
Valide le texte en cours de pré-édition.
void commit(string text, int replaceFrom = 0, int replaceLength = 0)
Applique l’ text ation finale à l’élément d’entrée et, le cas échéant, modifie le texte par rapport au début du texte avant modification. Si la valeur de `replaceFrom` est différente de zéro, l’ text ation remplace le contenu situé à partir de `replaceFrom` sur une longueur de `replaceLength`.
void sendKeyClick(int key, string text, int modifiers = 0)
Envoie un événement de clic de touche avec les valeurs suivantes : ` key`, ` text ` et ` modifiers ` à l'élément de saisie qui a actuellement le focus.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.