Fluent-Qt

Actualités du projet

Versions et migrations

Mises à jour et exigences de migration pour UILib et Gallery, regroupées par version.

1.12.1

Dernière version

UILib

PropertyPanel crée les éditeurs à mesure que les lignes deviennent visibles. AreaChart réutilise le remplissage lorsque le pointeur se déplace sur le graphique.

Gallery

Les séparateurs de la boîte de dialogue What’s new restent opaques pendant le défilement. Les exemples de photos chargent les images à la demande.

Notes du projet

Le site, la référence des API des composants et les éditeurs de propriétés interactifs sont disponibles en neuf langues.

1.12.0

UILib

Empilez icônes et libellés dans les boutons, affichez les en-têtes de colonnes d’arborescence et restaurez les fenêtres maximisées sur le bon écran.

  • Utilisez Button::IconAbove ou Button::IconBelow pour placer une icône au-dessus ou en dessous de son libellé.
  • TreeView réserve de l’espace pour les en-têtes de colonnes visibles. Utilisez headerlessTopInset pour ajuster l’écart de la première ligne lorsque la légende et les en-têtes de colonnes sont masqués.
  • Sous Windows, la restauration d’une Window maximisée utilise la zone de travail de l’écran de destination.

Gallery

Lisez les notes de version hors ligne et essayez l’exemple d’en-têtes de colonnes d’arborescence.

  • Ouvrez What’s new dans la barre de titre. À largeur réduite, cliquez sur l’icône de mégaphone pour lire les mises à jour fournies avec Gallery.
  • L’exemple TreeView montre comment les en-têtes du modèle s’affichent au-dessus de la première ligne.

Notes du projet

Modifiez des exemples Qt interactifs sur 99 pages de documentation de composants et copiez le code C++ ou PySide6 généré.

1.11.4

UILib

Rapports de diagnostic, Windows 11 Snap Layouts et réglages partagés de cadre des champs texte.

  • DiagnosticSession enregistre les événements d’interface récents et les instantanés de widgets dans une archive ZIP en mémoire.
  • Survolez le bouton d'agrandissement d'une Window redimensionnable pour utiliser Windows 11 Snap Layouts.
  • Les champs de texte partagent les réglages de cadre de LineEdit. Le soulignement sans focus a une largeur nulle par défaut, et les bordures de largeur nulle ne dessinent plus de trait fin.
  • Toast corrige la propriété des widgets d’action et la mise en page dans les fenêtres étroites.

Gallery

Signalez les problèmes de Gallery avec une archive ZIP des diagnostics récents.

  • Choisissez Signaler un problème à côté de Paramètres pour copier un ZIP de diagnostic, y compris les rapports de plantage locaux correspondants. Choisissez Ouvrir un ticket GitHub dans la notification, puis collez le fichier.
  • Dans la Gallery web, le ZIP se télécharge afin que vous puissiez le joindre à votre rapport.

Notes du projet

L’historique des versions sur le site web sépare les mises à jour d’UILib et de Gallery, avec des filtres de portée ainsi que des liens stables vers les versions et la migration.

1.11.3

UILib

Ajoute Transfer, les suffixes d'unité et widgets de fin pour LineEdit et ComboBox, la géométrie du curseur de TextEdit et des correctifs de disposition des champs éditables.

  • LineEdit et ComboBox affichent des suffixes d’unité tels que px (séparés du texte saisi) ou accueillent un widget personnalisé en fin de champ.
  • Transfer déplace des éléments entre deux listes avec recherche à l’aide de clés stables et ignore les entrées désactivées.
  • TextEdit expose le rectangle de son curseur et son signal de modification pour positionner les infobulles de complétion en ligne.
  • Corrige les limites du texte des ComboBox éditables après sélection ou mise à jour du modèle, ainsi que le centrage de l'icône de glissement de NumberBox selon les échelles d'affichage.

Gallery

Ajoute un exemple de complétion de membres en ligne avec @ et corrige le découpage redirigé sur les anciennes versions de Qt.

  • Saisissez @ dans l’exemple de complétion de membres de TextEdit. Utilisez les flèches pour choisir un nom et l’insérer sans quitter l’éditeur.

1.11.1

UILib

Ajoute RangeSlider et ImageViewer, ainsi que des correctifs pour l'alignement du texte, les superpositions et le rendu à échelle fractionnaire.

  • RangeSlider sélectionne une valeur inférieure et supérieure avec un espacement minimal, des pas au clavier, des infobulles de valeur et deux curseurs accessibles.
  • ImageViewer ajoute le zoom centré sur le pointeur, le panoramique, les modes d’ajustement, la navigation au pincement et au clavier ainsi que les miniatures en cache, y compris dans FlipView.
  • Corrige les artefacts aux échelles fractionnaires et inférieures à 100 % grâce aux redessins par région locale, et évite les redessins complets des widgets de fenêtre lors des images uniquement GPU.
  • Corrige l'alignement du texte des contrôles compacts, les marges des icônes de menu, le focus de débordement de SelectorBar et les captures d'arrière-plan des popups.

Gallery

Migration requise

Enregistre le zoom d’interface de 50 % à 200 % et pagine les résultats de recherche de composants et d’exemples. Les compilations depuis les sources nécessitent les en-têtes privés Qt correspondants.

1.11.0

UILib

Migration requise

Déplace les effets de particules vers le module optionnel FluentQt::Particles, ajoute des polices d’icônes personnalisées à FontIcon et fournit des wheels Python à ABI stable.

  • FontIcon ajoute fontFamily() et setFontFamily() pour les polices d’icônes personnalisées. Passez directement le caractère Unicode du glyphe ou laissez la famille vide pour utiliser les icônes Fluent intégrées.
  • Les effets de particules sont déplacés de la bibliothèque principale vers la cible optionnelle FluentQt::Particles (fluentqt.particles en Python).
  • Les builds Debug bureau lient par défaut le runtime Qt release. Définissez FLUENT_QT_DEBUG_RELEASE_RUNTIME=OFF pour lier les bibliothèques Qt debug.
  • Les surcouches ouvertes suivent les déplacements de la surface hôte, les curseurs de barre de défilement s’alignent sur la zone de clic et les wheels Python utilisent l’ABI stable de CPython (abi3).

ParticleBackdrop passe dans le module Particles

fluent::layout::ParticleBackdrop et fluentqt.layout.ParticleBackdrop sont supprimés. Lier uniquement FluentQt::FluentQt n’inclut plus les effets de particules.

Activez FLUENT_QT_BUILD_PARTICLES lors des builds depuis les sources ou demandez COMPONENTS Particles et liez FluentQt::Particles, puis mettez à jour les inclusions, espaces de noms et imports.

Avant
FluentQt::FluentQt
#include <FluentQt/Layout.h>
fluent::layout::ParticleBackdrop
from fluentqt.layout import ParticleBackdrop
Après
find_package(FluentQt CONFIG REQUIRED COMPONENTS Particles)
target_link_libraries(app PRIVATE FluentQt::Particles)
#include <FluentQt/Particles.h>
fluent::particles::ParticleBackdrop
from fluentqt.particles import ParticleBackdrop

Introduit dans b674c94

Gallery

3D Gallery ne charge que les lignes de texture modifiées, rétablit un rendu net à l'arrêt du mouvement, plafonne la mémoire du cache de textures et repasse en 2D en cas de ralentissement prolongé.

1.10.3

UILib

Ajoute l'édition numérique et de propriétés, l'exportation de graphiques et de nouveaux contrôles de sélection.

  • Les valeurs de NumberBox peuvent être ajustées par glissement en plus de la saisie, et un glissement peut être annulé. PropertyPanel regroupe les champs, les recherche par nom et les réinitialise par défaut.
  • Les graphiques enregistrent un PNG ou exportent les lignes sources en CSV, pour la plage visible ou toutes les données.
  • AutoSuggestBox accepte les suggestions asynchrones et ignore celles qui sont obsolètes. Nouveautés : TagInput pour les étiquettes avec identifiants stables et TreeSelect pour sélectionner depuis un modèle arborescent.
  • DataGrid permet d’épingler des colonnes et DataGridToolBar ajoute la recherche, les filtres et les contrôles de colonnes.

Notes du projet

Chaque page de composant du site présente un exemple interactif, le code C++ et PySide6 ainsi que l'API publique, en anglais et en chinois.

1.10.2

UILib

Ajoute CommandPalette, FormController et CodeBlock. Popup, Dialog et DrawerView partagent les mêmes options de flou d'arrière-plan et d'assombrissement, et les surfaces modales bloquent les clics et raccourcis situés derrière elles.

1.10.1

UILib

CommandBar et CommandBarFlyout acceptent les actions avec des sous-menus FluentMenu imbriqués. TextEdit::appendPlainText() ajoute des lignes de journal sans perdre la sélection ni l’historique d’annulation. Les cases à cocher et boutons radio décochés ont des contours plus marqués.

1.10.0

UILib

Ajoute DateTimeRangePicker, QmlBridge pour héberger des pages QML dans des fenêtres Widgets, ainsi que le module optionnel Plugins pour les dépendances, l'activation et le nettoyage des extensions.

Gallery

Python Live Scene recharge désormais les aperçus dans la même fenêtre.

1.9.3

UILib

Corrige l'arrière-plan des fenêtres au démarrage et lors des changements de matériau. Les nouvelles fenêtres n'émettent plus de flash blanc en mode sombre, et quitter Mica ou Acrylic conserve l'ancien matériau jusqu'à ce que le nouvel arrière-plan soit dessiné.

1.9.1

UILib

Les wheels Python incluent désormais le module optionnel Spatial absent de la version 1.9.0.

Gallery

La version empaquetée de Gallery 3D utilise Direct3D 11 sous Windows ARM64 et bascule en 2D lorsque l’accélération matérielle est indisponible.

  • Les wheels 1.9.0 ont été publiés sans Spatial. Mettez à niveau FluentQt et FluentQt-Gallery vers la version 1.9.1 pour obtenir Gallery 3D.

1.9.0

UILib

Ajoute le module optionnel Spatial. SpatialView place des widgets ordinaires sur des surfaces 3D en perspective, tout en conservant leur gestion des entrées et leurs signaux.

Gallery

Ajoute un mode 3D aux Galleries bureau et navigateur.

1.8.5

UILib

Ajoute un module Charts (courbes, aires, barres, secteurs, anneaux, nuages de points et sparklines) dessiné avec Qt Widgets sans dépendre de Qt Charts, ainsi que FileDropZone et FileListView. Toast adopte un nouveau style de carte et un bouton de fermeture optionnel.

1.8.3

UILib

Ajoute ParticleBackdrop, un arrière-plan de particules rendu sur CPU, ainsi qu'un SplashScreen réutilisable. Corrige la sélection au clavier et l'édition de texte.

Gallery

Facilite la lecture et la copie du code source des exemples.

1.8.2

UILib

UserTheme::applyOverrides() modifie les couleurs, rayons d’angle et polices pour toute l’application, et setThemeOverrides() fait de même pour un seul composant. Les listes déroulantes de ComboBox utilisent désormais les polices personnalisées. Corrige également des bogues de rappel, de navigation et de curseur sur les versions de Qt prises en charge.

1.8.0

UILib

Ajoute HighContrast et les modes globaux MotionPolicy (Full, Reduced, Disabled). Un TextEdit ayant le focus anime ses changements de hauteur automatique.

Gallery

Ajoute les réglages de contraste élevé et d'animation aux Galleries C++, PySide6 et navigateur.

1.7.5

UILib

Les boutons, interrupteurs et sélecteurs de date/heure partagent les règles de fontRole, un appel explicite à setFont() restant prioritaire. Le Skill build-fluentqt-gui couvre de l'analyse du projet jusqu'à la revue indépendante.

Gallery

Aligne le comportement des exemples entre C++, PySide6 et WebAssembly.

1.7.4

UILib

Les touches d’accès des menus restent actives pendant l’animation des menus.

Gallery

Les aperçus natifs rejouent les actions du pointeur et du clavier avant la capture et signalent la géométrie des widgets ainsi que les résultats de l’Inspector.

1.7.3

UILib

Les contours de sélection de CalendarView sont arrondis, les menus volants des sélecteurs s’alignent sur leurs champs et les ombres de TeachingTip se répartissent uniformément.

Gallery

Live Scene garde une fenêtre d'aperçu PySide6 ouverte et l'actualise à l'enregistrement.

1.7.2

UILib

Ajoute MultiSelectComboBox ainsi que les commandes fluentqt doctor, create et trial pour vérifier l'installation Qt locale et générer un projet de démarrage C++ ou PySide6. Corrige aussi plusieurs problèmes de sélecteurs et de listes sur différentes plateformes.

1.7.0

UILib

Migration requise

Supprime les langages de conception Material et Cupertino pour ne conserver que Fluent. Ajoute Field et DataGrid, et documente le comportement d’ouverture, de fermeture et de modalité pour chaque surcouche.

Suppression des API de langage de conception et de thème de style

DesignLanguage, StyleTheme et StyleThemeCatalog sont supprimés sans alias. Les applications utilisant uniquement les thèmes Fluent clair et sombre ne sont pas affectées.

Choisissez l'apparence avec Theme et personnalisez les jetons avec UserTheme. En Python, utilisez current_theme(), apply_user_theme(), set_accent_color() et reset_theme_tokens(). La Gallery ignore l'ancien réglage styleTheme.

Avant
FluentElement::DesignLanguage
StyleTheme / StyleThemeCatalog
current_design_language()
apply_style_theme()
Après
FluentElement::Theme
fluent::UserTheme
current_theme()
apply_user_theme()

1.6.4

UILib

TextEdit respecte les marges de contenu personnalisées. Le Skill build-fluentqt-gui adapte ses vérifications à la taille de l’application.

Gallery

Les exemples de code dans le navigateur permettent de basculer entre C++ et PySide6.

1.6.3

UILib

Fournit le Skill build-fluentqt-gui pour les agents de code, avec un catalogue de composants reliant les API C++ et PySide6 aux exemples de Gallery. ListView reçoit un délégué par défaut et les paquets installés n’intègrent plus les chemins SDK de la machine de compilation.

1.6.1

UILib

Ajoute la documentation complète du paquet et les liens du projet sur la page PyPI de FluentQt.

Gallery

Ajoute la documentation complète du paquet et les liens du projet sur la page PyPI de FluentQt-Gallery.

1.5.0

UILib

Migration requise

Ajoute des en-têtes par catégorie tels que <FluentQt/BasicInput.h>, des rôles de police et modes de sélection typés, ainsi qu'une propriété explicite pour les widgets hébergés. Les applications fournissent désormais leurs propres textes localisés pour les sélecteurs et interrupteurs.

Rôles de police typés, modes de sélection partagés et propriété explicite

Le code qui passe les rôles de police sous forme de chaînes, utilise des énumérations de sélection propres à chaque vue, inclut des en-têtes d'implémentation ou repose sur la propriété implicite des widgets hébergés doit être mis à jour.

N'incluez que les en-têtes publics et passez WidgetOwnership lorsqu'une API le demande. Fournissez depuis l'application les textes localisés des sélecteurs, les libellés de ToggleSwitch et les noms d'accessibilité.

Avant
"Body"
FlowSelectionMode / GridSelectionMode
ListSelectionMode / TreeSelectionMode
Après
Typography::FontRole::Body
fluent::collections::SelectionMode
fluent::WidgetOwnership

1.4.2

UILib

Corrige les ancres droite et bas de AnchorLayout, les transitions d'état QMLPlus et l'accès aux ressources intégrées avant l'existence de QApplication. TextEdit transmet correctement le focus et conserve l'historique d'annulation lorsque son texte est redéfini.

1.4.1

UILib

Les contrôles restent nets aux échelles d'affichage fractionnaires jusqu'à 300 %. Dialog et CoachMark s'ouvrent comme superpositions dans la fenêtre parente au lieu de fenêtres natives distinctes, ce qui corrige les blocages d'entrée sous macOS.

1.4.0

UILib

Intègre les polices et Fluent System Icons, supprimant la dépendance à une installation système de Segoe.

Gallery

Ajoute les pages de typographie, couleur, icônes et espacement, et suit l'échelle d'affichage du système.

1.3.2

Date non enregistrée

UILib

Les paquets installés n'exposent qu'une liste explicite d'en-têtes publics.

Gallery

Les pages de composants affichent l'en-tête, le type C++ et la cible CMake. Le changement de page est plus rapide.

1.3.1

Date non enregistrée

UILib

La bibliothèque dépend uniquement de Qt Widgets. Les versions incluent une archive source contenant uniquement la bibliothèque.

Gallery

Conserve spdlog dans la Gallery et supprime les modules Qt inutilisés de ses paquets.

1.3.0

Date non enregistrée

UILib

Ajoute la prise en charge de Linux (X11 et Wayland sur x64 et ARM64) avec des paquets Debian. Window::setBackdropEffect() fournit une API Mica/Acrylic unique sur chaque plateforme.