QVirtualKeyboardInputContext Class
Permet d'accéder à un contexte d'entrée. Plus d'informations...
| 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éritages : | 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é indique la position de l'ancre.
Cette propriété est modifiée lorsque la position de l'ancre change.
Fonctions d'accès :
| int | anchorPosition() const |
Signal de notification :
| void | anchorPositionChanged() |
[read-only] anchorRectIntersectsClipRect : bool
Tient true si le rectangle de délimitation de l'ancre de sélection coupe le rectangle de l'élément d'entrée exposé.
Fonctions d'accès :
| bool | anchorRectIntersectsClipRect() const |
Signal du notificateur :
| 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 du notificateur :
| void | anchorRectangleChanged() |
animating : bool
Cette propriété contient le statut d'animation.
Utilisez cette propriété pour définir l'état d'animation, par exemple lors des états de transition de l'interface utilisateur.
Fonctions d'accès :
| bool | isAnimating() const |
| void | setAnimating(bool isAnimating) |
Signal du notificateur :
| void | animatingChanged() |
[read-only] capsLockActive : bool
Cette propriété contient l'état du verrouillage des majuscules.
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
Tient true si le rectangle de délimitation du curseur de saisie intersecte le rectangle exposé de l'élément de saisie.
Fonctions d'accès :
| bool | cursorRectIntersectsClipRect() const |
Signal du notificateur :
| 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 du notificateur :
| void | cursorRectangleChanged() |
[read-only] inputEngine : QVirtualKeyboardInputEngine* const
Cette propriété contient le moteur d'entrée.
Cette propriété stocke le moteur d'entrée.
Fonctions d'accès :
| QVirtualKeyboardInputEngine * | inputEngine() const |
[read-only] inputMethodHints : Qt::InputMethodHints
Cette propriété contient les indices de la méthode d'entrée.
Cette propriété est modifiée lorsque les indices de la méthode d'entrée 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 de clavier, qui peut être utilisé pour recevoir des notifications d'événements de changement de clavier.
Cette propriété a été introduite dans Qt 6.1.
Fonctions d'accès :
| QVirtualKeyboardObserver * | keyboardObserver() const |
[read-only] locale : QString
Cette propriété contient la locale.
Cette propriété est modifiée lorsque la locale d'entrée change.
Fonctions d'accès :
| QString | locale() const |
Signal de notification :
| void | localeChanged() |
preeditText : QString
Cette propriété contient le texte de pré-édition.
Cette propriété définit le texte de pré-édition.
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 du notificateur :
| 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
Tient 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 le statut de l'équipe.
Cette propriété est modifiée lorsque l'état 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é contient le statut de la majuscule.
Cette propriété est true lorsque shiftActive ou capsLockActive est true.
Fonctions d'accès :
| bool | isUppercase() const |
Signal du notificateur :
| void | uppercaseChanged() |
Member Function Documentation
[invokable] void QVirtualKeyboardInputContext::clear()
Efface le texte pré-édité.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QVirtualKeyboardInputContext::commit()
Valide le texte en cours de pré-édition.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QVirtualKeyboardInputContext::commit(const QString &text, int replaceFrom = 0, int replaceLength = 0)
Commence la version finale de text dans l'élément d'entrée et modifie éventuellement le texte par rapport au début du texte pré-édité. Si replaceFrom est différent de zéro, text remplace le contenu relatif à replaceFrom avec une longueur de replaceLength.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de 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 valeurs key, text et modifiers à l'élément de saisie qui est actuellement au centre de l'attention.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de 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.
