Référence API
Composant VirtualKeyboard
À instancier une seule fois par application dans votre Window ou ApplicationWindow racine.
import Ln.VirtualKeyboard 1.0
VirtualKeyboard { width: parent.width }
Propriétés
| Propriété | Type | Défaut | Description |
|---|---|---|---|
maxWidth | real | -1 | Largeur maximale du clavier |
maxHeight | real | -1 | Hauteur maximale du clavier |
inputProfiles | list<object> | (profils embarqués) | Optionnel ; omettre pour utiliser les 56 profils embarqués |
activeProfileIds | list<string> | ["en-qwerty"] | IDs de profils activés |
currentProfileId | string | "en-qwerty" | ID du profil actif |
theme | enum | Dark | Lnvk.Dark / Lnvk.Light |
numberRowEnabled | bool | false | Rangée de chiffres persistante |
predictionEnabled | bool | true | Prédiction de mots |
rememberLearning | bool | true | Conserver les mots appris |
customPredictionMode | enum | Lnvk.Disabled | Politique de prédiction personnalisée |
| Surcharges de thème : voir Thèmes | |||
Singleton Lnvk
Singleton global automatiquement disponible après l'import de Ln.VirtualKeyboard 1.0. Reflète l'état du clavier en temps réel et expose des méthodes.
Propriétés
| Propriété | Type | Défaut | Modifiable | Description |
|---|---|---|---|---|
visible | bool | false | oui | Visibilité du clavier |
inputProfiles | list<object> | (embarqués) | oui | Liste complète des profils |
activeProfileIds | list<string> | ["en-qwerty"] | oui | IDs de profils activés |
activeProfiles | list<object> | (depuis les ids) | non | Objets de profils activés (id, languageTag, layoutId, displayName, imeEngineId) |
currentProfileId | string | "en-qwerty" | oui | ID du profil actif |
currentLanguage | string | "en" | non | Tag BCP 47 du profil actif |
currentDisplayName | string | "English" | non | Nom d'affichage du profil actif |
shiftState | int | Off | non | Off, Shifted ou CapsLock |
layoutPage | int | 0 | non | Page de disposition active |
inputMethodHints | int | 0 | non | Hints du champ actif |
composingText | string | "" | non | Texte IME en cours |
keyboardHeight | real | 260 | non | Hauteur calculée actuelle |
maxWidth | real | 600 | oui | Largeur maximale |
maxHeight | real | -1 | oui | Hauteur maximale |
theme | enum | Dark | oui | Lnvk.Dark / Lnvk.Light |
effectiveFontFamily | string | - | non | Famille de rendu par script, en lecture seule. Lier avec font.family: Lnvk.effectiveFontFamily |
numberRowEnabled | bool | false | oui | Rangée de chiffres persistante |
predictionEnabled | bool | true | oui | Prédiction de mots |
rememberLearning | bool | true | oui | Conserver les mots appris |
customPredictionMode | enum | Lnvk.Disabled | oui | Politique de prédiction personnalisée |
Méthodes
| Méthode | Description |
|---|---|
selectProfile(string id) | Bascule vers un profil par ID |
selectLanguage(string bcp47) | Bascule vers le premier profil actif avec ce tag de langue |
profilesForLanguageTag(string languageTag) | Tous les profils configurés avec ce languageTag exact |
displayName(string bcp47) | Nom d'affichage générique pour un tag de langue |
profileDisplayName(string id) | Nom d'affichage pour un ID de profil |
setCustomPredictionDictionary(string languageTag, string predFilePath) | Définit un fichier .pred personnalisé |
clearCustomPredictionDictionary(string languageTag) | Efface le dictionnaire personnalisé d'une langue/tag |
clearCustomPredictionDictionaries() | Efface tous les dictionnaires personnalisés |
hide() | Masque le clavier |
API C++
L'API C++ publique est exposée via un en-tête unique :
#include <lnvk>Cela fournit FontPaths et KeyboardManager. Avec find_package(LNVK), ln_virtual_keyboard_deploy(myapp) ajoute le répertoire include/lnvk/ au chemin d'inclusion de votre cible.
Voir Langues pour les profils de saisie, Thème pour les polices et Configuration pour les dictionnaires de prédiction personnalisés.