QVirtualKeyboardInputContext Class
Permet d'accéder à un contexte de saisie. En savoir plus...
| En-tête : | #include <QVirtualKeyboardInputContext> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard) target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
| qmake : | QT += virtualkeyboard |
| En QML : | InputContext |
| Hérite de : | QObject |
Propriétés
|
|
Fonctions publiques
| int | anchorPosition() const |
| bool | anchorRectIntersectsClipRect() const |
| QRectF | anchorRectangle() const |
| void | clear() |
| void | commit() |
| void | commit(const QString &text, int replaceFrom = 0, int replaceLength = 0) |
| int | cursorPosition() const |
| bool | cursorRectIntersectsClipRect() const |
| QRectF | cursorRectangle() const |
| QVirtualKeyboardInputEngine * | inputEngine() const |
| Qt::InputMethodHints | inputMethodHints() const |
| bool | isAnimating() const |
| bool | isCapsLockActive() const |
| bool | isSelectionControlVisible() const |
| bool | isShiftActive() const |
| bool | isUppercase() const |
| QVirtualKeyboardObserver * | keyboardObserver() const |
| QString | locale() const |
| QString | preeditText() const |
| QString | selectedText() const |
| void | sendKeyClick(int key, const QString &text, int modifiers = 0) |
| void | setAnimating(bool isAnimating) |
| void | setPreeditText(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0) |
| QString | surroundingText() const |
Signaux
| void | anchorPositionChanged() |
| void | anchorRectIntersectsClipRectChanged() |
| void | anchorRectangleChanged() |
| void | animatingChanged() |
| void | capsLockActiveChanged() |
| void | cursorPositionChanged() |
| void | cursorRectIntersectsClipRectChanged() |
| void | cursorRectangleChanged() |
| void | inputMethodHintsChanged() |
| void | localeChanged() |
| void | preeditTextChanged() |
| void | selectedTextChanged() |
| void | selectionControlVisibleChanged() |
| void | shiftActiveChanged() |
| void | surroundingTextChanged() |
| void | uppercaseChanged() |
Documentation sur les propriétés
[read-only] anchorPosition : int
Cette propriété contient la position de l'ancrage.
Cette propriété est modifiée lorsque la position d'ancrage change.
Fonctions d'accès :
| int | anchorPosition() const |
Signal de notification :
| void | anchorPositionChanged() |
[read-only] anchorRectIntersectsClipRect : bool
Renvoie « true » si le rectangle englobant du point d'ancrage de sélection recoupe le rectangle de l'élément d'entrée visible.
Fonctions d’accès :
| bool | anchorRectIntersectsClipRect() const |
Signal de notification :
| void | anchorRectIntersectsClipRectChanged() |
Voir également Qt::ImAnchorRectangle et Qt::ImInputItemClipRectangle.
[read-only] anchorRectangle : QRectF
Cette propriété contient le rectangle d'ancrage.
Cette propriété est modifiée lorsque le rectangle d'ancrage change.
Fonctions d'accès :
| QRectF | anchorRectangle() const |
Signal de notification :
| void | anchorRectangleChanged() |
animating : bool
Cette propriété contient l'état d'animation.
Utilisez cette propriété pour définir l'état d'animation, par exemple lors des transitions de l'interface utilisateur.
Fonctions d'accès :
| bool | isAnimating() const |
| void | setAnimating(bool isAnimating) |
Signal de notification :
| void | animatingChanged() |
[read-only] capsLockActive : bool
Cette propriété indique l'état de la touche Verr Maj.
Cette propriété est modifiée lorsque l'état du verrouillage des majuscules change.
Fonctions d'accès :
| bool | isCapsLockActive() const |
Signal de notification :
| void | capsLockActiveChanged() |
[read-only] cursorPosition : int
Cette propriété contient la position du curseur.
Cette propriété est modifiée lorsque la position du curseur change.
Fonctions d'accès :
| int | cursorPosition() const |
Signal de notification :
| void | cursorPositionChanged() |
[read-only] cursorRectIntersectsClipRect : bool
Renvoie « true » si le rectangle englobant du curseur de saisie recoupe le rectangle de l'élément de saisie exposé.
Fonctions d’accès :
| bool | cursorRectIntersectsClipRect() const |
Signal de notification :
| void | cursorRectIntersectsClipRectChanged() |
Voir également Qt::ImCursorRectangle et Qt::ImInputItemClipRectangle.
[read-only] cursorRectangle : QRectF
Cette propriété contient le rectangle du curseur.
Cette propriété est modifiée lorsque le rectangle du curseur change.
Fonctions d'accès :
| QRectF | cursorRectangle() const |
Signal de notification :
| void | cursorRectangleChanged() |
[read-only] inputEngine : QVirtualKeyboardInputEngine* const
Cette propriété contient le moteur d'entrée.
Cette propriété stocke le moteur de saisie.
Fonctions d'accès :
| QVirtualKeyboardInputEngine * | inputEngine() const |
[read-only] inputMethodHints : Qt::InputMethodHints
Cette propriété contient les suggestions de la méthode de saisie.
Cette propriété est modifiée lorsque les conseils relatifs à la méthode de saisie changent.
Fonctions d'accès :
| Qt::InputMethodHints | inputMethodHints() const |
Signal de notification :
| void | inputMethodHintsChanged() |
[read-only, since 6.1] keyboardObserver : QVirtualKeyboardObserver* const
Contient l'objet observateur du clavier, qui peut être utilisé pour recevoir des notifications d'événements liés aux modifications du clavier.
Cette énumération a été introduite dans Qt 6.1.
Fonctions d'accès :
| QVirtualKeyboardObserver * | keyboardObserver() const |
[read-only] locale : QString
Cette propriété contient les paramètres régionaux.
Cette propriété est modifiée lorsque les paramètres régionaux de saisie changent.
Fonctions d'accès :
| QString | locale() const |
Signal de notification :
| void | localeChanged() |
preeditText : QString
Cette propriété contient le texte d'aperçu.
Cette propriété définit le texte d'aperçu.
Fonctions d'accès :
| QString | preeditText() const |
| void | setPreeditText(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0) |
Signal de notification :
| void | preeditTextChanged() |
[read-only] selectedText : QString
Cette propriété contient le texte sélectionné.
Cette propriété est modifiée lorsque le texte sélectionné change.
Fonctions d'accès :
| QString | selectedText() const |
Signal de notification :
| void | selectedTextChanged() |
[read-only] selectionControlVisible : bool
Contient la valeur « true » si le contrôle de sélection est actuellement visible.
Fonctions d'accès :
| bool | isSelectionControlVisible() const |
Signal de notification :
| void | selectionControlVisibleChanged() |
[read-only] shiftActive : bool
Cette propriété contient l'état de l'équipe.
Cette propriété est modifiée lorsque le statut de l'équipe change.
Fonctions d'accès :
| bool | isShiftActive() const |
Signal de notification :
| void | shiftActiveChanged() |
[read-only] surroundingText : QString
Cette propriété contient le texte entourant le curseur.
Cette propriété est modifiée lorsque le texte entourant le curseur change.
Fonctions d'accès :
| QString | surroundingText() const |
Signal de notification :
| void | surroundingTextChanged() |
[read-only] uppercase : bool
Cette propriété indique si le texte est en majuscules.
Cette propriété est d true e lorsque l'une des propriétés suivantes ( shiftActive ou capsLockActive ) est d true.
Fonctions d'accès :
| bool | isUppercase() const |
Signal de notification :
| void | uppercaseChanged() |
Documentation des fonctions membres
[invokable] void QVirtualKeyboardInputContext::clear()
Efface le texte pré-édité.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QVirtualKeyboardInputContext::commit()
Valide le texte en cours de pré-édition.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QVirtualKeyboardInputContext::commit(const QString &text, int replaceFrom = 0, int replaceLength = 0)
Applique l’ text ation finale à l’élément d’entrée et modifie, si nécessaire, le texte par rapport au début du texte avant modification. Si replaceFrom est différent de zéro, l’ text remplace le contenu situé à partir de replaceFrom par une longueur de replaceLength.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QVirtualKeyboardInputContext::sendKeyClick(int key, const QString &text, int modifiers = 0)
Envoie un événement de clic de touche avec les paramètres key, text et modifiers fournis à l'élément de saisie qui a actuellement le focus.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
© 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.
