Thèmes
Thèmes intégrés
Deux thèmes sont inclus. Définissez la propriété theme sur le composant ou via le singleton :
VirtualKeyboard {
theme: Lnvk.Dark // par défaut
// theme: Lnvk.Light
}
// Changer à l'exécution
Lnvk.theme = Lnvk.Light
Couleurs personnalisées
Surchargez n'importe quel jeton visuel sur le composant VirtualKeyboard. Les propriétés non définies héritent des valeurs du thème actif.
VirtualKeyboard {
panelBackground: "#1a1a2e"
keyBackground: "#16213e"
keyForeground: "#e2e2e2"
keyPressedBackground: "#0f3460"
specialKeyBackground: "#533483"
accentColor: "#e94560"
popupBackground: "#16213e"
keyRadius: 8
keySpacing: 4
fontSize: 20
}
Les polices embarquées sont optionnelles. Enregistrez vos propres fichiers de police depuis C++ avant l'initialisation du plugin (voir Déploiement avancé — Polices). En QML, utilisez la famille résolue en lecture seule : font.family: Lnvk.effectiveFontFamily.
Référence des propriétés de couleur
| Propriété | Type | Défaut sombre | Description |
|---|---|---|---|
panelBackground | color | #132538 | Fond du panneau clavier |
keyBackground | color | #1E3550 | Couleur de remplissage des touches |
keyForeground | color | #F9F8F7 | Couleur du libellé des touches |
keyPressedBackground | color | #23A4DD | Remplissage de la touche enfoncée |
specialKeyBackground | color | #454D9B | Touches Maj, retour arrière, entrée |
accentColor | color | #00AB97 | Couleur d'accentuation et barre candidats |
popupBackground | color | #1E3550 | Fond du popup appui long |
keyRadius | int | 12 | Rayon des coins des touches (px) |
keySpacing | int | 5 | Espacement entre les touches (px) |
fontSize | int | 22 | Taille de base du libellé (px) |
Polices
Appelez FontPaths::setHostFontFiles avant engine.load() :
#include <lnvk>
lnvk::qt::FontPaths::setHostFontFiles({
"/opt/myapp/fonts/Inter-Variable.ttf",
"/opt/myapp/fonts/NotoSansCJKsc-Regular.otf",
});
Lorsqu'elle est définie, la liste hôte remplace la découverte des polices embarquées. La sélection par script est automatique via Lnvk.effectiveFontFamily lors du changement de langue. Voir Déploiement avancé — Polices (optionnelles).
Dimensions
Contraignez la largeur et la hauteur du clavier avec maxWidth et maxHeight. Le clavier se centre dans l'espace disponible.
VirtualKeyboard {
maxWidth: 600
maxHeight: 300
}
Mettez -1 (valeur par défaut) pour laisser la dimension sans contrainte.