Fluent-Qt

Projekt-Updates

Releases und Migrationen

Updates und Migrationsanforderungen für UILib und Gallery, nach Version gruppiert.

1.12.1

Neueste

UILib

PropertyPanel erstellt Editoren, sobald ihre Zeilen in den sichtbaren Bereich kommen. AreaChart verwendet die Flächenfüllung bei Mausbewegungen erneut.

Gallery

Beim Scrollen im Dialog „What’s new“ bleiben die Trennlinien undurchsichtig. Die Fotobeispiele laden Bilder bei Bedarf.

Projekthinweise

Website, API-Referenzen der Komponenten und interaktive Eigenschafteneditoren stehen in neun Sprachen zur Verfügung.

1.12.0

UILib

Symbole und Beschriftungen von Schaltflächen stapeln, Spaltenköpfe in Baumansichten anzeigen und maximierte Fenster auf dem vorgesehenen Monitor wiederherstellen.

  • Verwenden Sie Button::IconAbove oder Button::IconBelow, um ein Symbol über oder unter seiner Beschriftung zu platzieren.
  • TreeView lässt Platz für sichtbare Spaltenköpfe. Verwenden Sie headerlessTopInset, um den Abstand zur ersten Zeile anzupassen, wenn Überschrift und Spaltenköpfe ausgeblendet sind.
  • Unter Windows nutzt das Wiederherstellen eines maximierten Window den Arbeitsbereich des Zielmonitors.

Gallery

Lesen Sie Versionshinweise offline und testen Sie das Beispiel für Spaltenköpfe in der Baumansicht.

  • Öffnen Sie What’s new in der Titelleiste. Nutzen Sie bei schmaler Breite das Megafon-Symbol für die mitgelieferten Gallery-Updates.
  • Das TreeView-Beispiel zeigt, wie Modell-Kopfzeilen über der ersten Zeile erscheinen.

Projekthinweise

Bearbeiten Sie interaktive Qt-Beispiele auf 99 Komponentendokumentationsseiten und kopieren Sie den resultierenden C++- oder PySide6-Code.

1.11.4

UILib

Diagnoseberichte, Windows 11 Snap-Layouts und gemeinsame Rahmeneinstellungen für Textfelder.

  • DiagnosticSession zeichnet aktuelle UI-Ereignisse und Widget-Schnappschüsse in ein In-Memory-ZIP-Archiv auf.
  • Bewegen Sie den Mauszeiger über die Maximieren-Schaltfläche eines größenveränderbaren Window, um Windows 11 Snap-Layouts zu nutzen.
  • Textfelder teilen sich die LineEdit-Rahmeneinstellungen. Die unfokussierte Unterlinie hat standardmäßig die Breite null, und Rahmen mit Breite null zeichnen keine Haarlinie mehr.
  • Toast korrigiert Eigentümerschaft und Layout von Aktions-Widgets in schmalen Fenstern.

Gallery

Melden Sie Gallery-Probleme mit einer ZIP-Datei aktueller Diagnosedaten.

  • Wählen Sie „Report a problem“ neben den Einstellungen, um ein Diagnose-ZIP samt passender lokaler Absturzberichte zu kopieren. Klicken Sie in der Benachrichtigung auf „Open GitHub issue“ und fügen Sie die Datei anschließend ein.
  • In der Web-Gallery wird das ZIP heruntergeladen, sodass Sie es an Ihren Bericht anhängen können.

Projekthinweise

Die Website-Versionshistorie trennt UILib- und Gallery-Updates mit Bereichsfiltern sowie stabilen Versions- und Migrationslinks.

1.11.3

UILib

Fügt Transfer, Einheitensuffixe und nachgestellte Widgets für LineEdit und ComboBox, TextEdit-Caret-Geometrie sowie Layout-Korrekturen für editierbare Felder hinzu.

  • LineEdit und ComboBox zeigen Einheitensuffixe wie px an (getrennt vom bearbeiteten Text) oder nehmen ein benutzerdefiniertes nachgestelltes Widget auf.
  • Transfer verschiebt Elemente zwischen zwei durchsuchbaren Listen anhand stabiler Schlüssel und überspringt deaktivierte Einträge.
  • TextEdit stellt sein Caret-Rechteck und Änderungssignal bereit, um Inline-Vervollständigungs-Popups zu positionieren.
  • Behebt die Textgrenzen editierbarer ComboBox-Steuerelemente nach Auswahl- oder Modellaktualisierungen sowie die Zentrierung des Zieh-Symbols von NumberBox über verschiedene Anzeigeskalierungen hinweg.

Gallery

Fügt ein Inline-Beispiel zur @-Member-Vervollständigung hinzu und behebt umgeleitetes Clipping unter älteren Qt-Versionen.

  • Geben Sie @ im TextEdit-Beispiel für Mitgliedervervollständigung ein. Wählen Sie mit den Pfeiltasten einen Namen aus und fügen Sie ihn direkt im Editor ein.

1.11.2

UILib

Überspringt native Win32-Styling- und Backdrop-Aufrufe bei synthetischen offscreen- und minimal-Fenster-IDs.

Gallery

Ergänzt die C++- und PySide6-Beispiele für CheckBox um deaktivierte Zustände.

1.11.1

UILib

Fügt RangeSlider und ImageViewer hinzu, samt Korrekturen für Textausrichtung, Overlays und das Rendering bei gebrochenen Skalierungsfaktoren.

  • RangeSlider wählt einen unteren und oberen Wert mit Mindestabstand, Tastaturschritten, Wert-QuickInfos und barrierefreien Doppelschiebern aus.
  • ImageViewer ergänzt zeigerzentriertes Zoomen, Schwenken, Einpassungsmodi, Pinch- und Tastaturnavigation sowie zwischengespeicherte Miniaturansichten, auch innerhalb von FlipView.
  • Behebt Artefakte bei gebrochenen Skalierungen und Skalierungen unter 100 % durch Neuzeichnen lokaler Bereiche und vermeidet vollständige Fenster-Widget-Neuzeichnungen bei reinen GPU-Frames.
  • Behebt die Textausrichtung kompakter Steuerelemente, Abstände von Menüsymbolen, den Überlauf-Fokus von SelectorBar sowie Hintergrundaufnahmen von Popups.

Gallery

Migration erforderlich

Speichert den UI-Zoom von 50 %–200 % und paginiert Suchergebnisse für Komponenten und Beispiele. Quellcode-Builds erfordern passende private Qt-Header.

1.11.0

UILib

Migration erforderlich

Lagert Partikeleffekte in das optionale Modul FluentQt::Particles aus, ergänzt FontIcon um benutzerdefinierte Symbolschriftarten und liefert Python-Wheels mit stabilem ABI.

  • FontIcon ergänzt fontFamily() und setFontFamily() für benutzerdefinierte Symbolschriftarten. Übergeben Sie das Unicode-Zeichen der Glyphe direkt, oder lassen Sie die Schriftfamilie leer, um die gebündelten Fluent-Symbole zu nutzen.
  • Partikeleffekte wechseln aus der Kernbibliothek in das optionale Ziel FluentQt::Particles (fluentqt.particles in Python).
  • Desktop-Debug-Builds linken standardmäßig gegen die Release-Qt-Laufzeit. Setzen Sie FLUENT_QT_DEBUG_RELEASE_RUNTIME=OFF, um gegen Debug-Qt-Bibliotheken zu linken.
  • Geöffnete Overlays folgen Bewegungen der Host-Oberfläche, Bildlaufleisten-Schieber richten sich am Trefferbereich aus, und Python-Wheels nutzen das stabile CPython-ABI (abi3).

ParticleBackdrop wechselt in das Modul Particles

fluent::layout::ParticleBackdrop und fluentqt.layout.ParticleBackdrop wurden entfernt. Das alleinige Verknüpfen von FluentQt::FluentQt bindet keine Partikeleffekte mehr ein.

Aktivieren Sie FLUENT_QT_BUILD_PARTICLES bei Quellcode-Builds oder fordern Sie COMPONENTS Particles an und linken Sie FluentQt::Particles; aktualisieren Sie anschließend Includes, Namespaces und Imports.

Vorher
FluentQt::FluentQt
#include <FluentQt/Layout.h>
fluent::layout::ParticleBackdrop
from fluentqt.layout import ParticleBackdrop
Nachher
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

Eingeführt in b674c94

Gallery

Die 3D Gallery lädt nur geänderte Texturzeilen hoch, stellt nach Bewegungsende wieder eine scharfe Darstellung her, begrenzt den Texturcache und fällt bei anhaltend niedrigen Bildraten auf 2D zurück.

1.10.3

UILib

Fügt numerische und Eigenschaftsbearbeitung, Diagrammexport sowie neue Auswahlsteuerelemente hinzu.

  • NumberBox-Werte lassen sich sowohl eingeben als auch ziehen, und ein Ziehvorgang kann abgebrochen werden. PropertyPanel gruppiert Felder, findet sie nach Namen und setzt sie auf Standardwerte zurück.
  • Diagramme speichern ein PNG oder exportieren die Quellzeilen als CSV – wahlweise für den sichtbaren Bereich oder alle Daten.
  • AutoSuggestBox verarbeitet asynchrone Vorschläge und verwirft veraltete. Neu: TagInput für Tags mit stabilen IDs und TreeSelect zur Auswahl aus einem Baummodell.
  • DataGrid kann Spalten anheften, und DataGridToolBar ergänzt Suche, Filter und Spaltensteuerung.

Projekthinweise

Jede Komponentenseite auf der Website zeigt ein Live-Beispiel, C++- und PySide6-Code sowie die öffentliche API auf Englisch und Chinesisch.

1.10.2

UILib

Fügt CommandPalette, FormController und CodeBlock hinzu. Popup, Dialog und DrawerView teilen sich dieselben Optionen für Hintergrundunschärfe und Abdunklung, und modale Oberflächen blockieren dahinterliegende Klicks und Tastenkürzel.

1.10.1

UILib

CommandBar und CommandBarFlyout akzeptieren Aktionen mit verschachtelten FluentMenu-Untermenüs. TextEdit::appendPlainText() hängt Protokollzeilen an, ohne Auswahl oder Rückgängig-Verlauf zu verlieren. Nicht aktivierte Kontrollkästchen und Optionsfelder haben kräftigere Konturen.

1.10.0

UILib

Fügt DateTimeRangePicker, QmlBridge zum Einbetten von QML-Seiten in Widgets-Fenster sowie optionale Plugins für Erweiterungsabhängigkeiten, Aktivierung und Bereinigung hinzu.

Gallery

Python Live Scene lädt Vorschauen im selben Fenster neu.

1.9.3

UILib

Behebt Fensterhintergründe beim Start und bei Materialwechseln. Neue Fenster blitzen im dunklen Modus nicht mehr weiß auf, und beim Wechsel weg von Mica oder Acrylic bleibt das alte Material erhalten, bis der neue Hintergrund gezeichnet ist.

1.9.1

UILib

Python-Wheels enthalten jetzt das optionale Spatial-Modul, das in 1.9.0 fehlte.

Gallery

Die paketierte 3D-Gallery nutzt unter Windows ARM64 Direct3D 11 und fällt ohne Hardwarebeschleunigung auf 2D zurück.

  • Die 1.9.0-Wheels wurden ohne Spatial ausgeliefert. Aktualisieren Sie sowohl FluentQt als auch FluentQt-Gallery auf 1.9.1, um die 3D-Gallery zu erhalten.

1.9.0

UILib

Fügt das optionale Spatial-Modul hinzu. SpatialView platziert gewöhnliche Widgets perspektivisch auf 3D-Oberflächen, wobei deren vorhandene Eingabeverarbeitung und Signale erhalten bleiben.

Gallery

Fügt der Desktop- und Browser-Gallery einen 3D-Modus hinzu.

1.8.5

UILib

Fügt ein Charts-Modul (Linien-, Flächen-, Balken-, Kreis-, Ring-, Streudiagramm und Sparkline) hinzu, das mit Qt Widgets ohne Abhängigkeit von Qt Charts gezeichnet wird, sowie FileDropZone und FileListView. Toast erhält einen neuen Kartenstil und eine optionale Schließen-Schaltfläche.

1.8.3

UILib

Fügt ParticleBackdrop, einen CPU-gezeichneten Partikelhintergrund, und einen wiederverwendbaren SplashScreen hinzu. Behebt Probleme bei Tastaturauswahl und Textbearbeitung.

Gallery

Beispielquellcode lässt sich leichter lesen und kopieren.

1.8.2

UILib

UserTheme::applyOverrides() ändert Farben, Eckenradien und Schriftarten für die gesamte App, und setThemeOverrides() tut dasselbe für eine einzelne Komponente. ComboBox-Dropdowns nutzen jetzt benutzerdefinierte Schriftarten. Behebt zudem Callback-, Navigations- und Slider-Fehler in unterstützten Qt-Versionen.

1.8.1

UILib

Fügt ToggleSwitch::visualScale hinzu. Behebt Eingabesignale in Sammlungsansichten, das FlowView-Layout nach dem Entfernen von Zeilen sowie NumberBox-Callbacks, die das Widget löschen.

1.8.0

UILib

Fügt HighContrast und app-weite MotionPolicy-Modi (Full, Reduced, Disabled) hinzu. Ein fokussiertes TextEdit animiert automatische Höhenänderungen.

Gallery

Fügt der C++-, PySide6- und Browser-Gallery Einstellungen für hohen Kontrast und Bewegung hinzu.

1.7.6

UILib

MultiSelectComboBox verbindet ausgewählte Beschriftungen mit 、 statt mit einem übersetzten „und“, und reine Symbolschaltflächen in TabView stellen barrierefreie Namen bereit.

1.7.5

UILib

Schaltflächen, Umschalter und Datums-/Zeitauswahlfelder teilen sich fontRole-Regeln, wobei ein explizites setFont() Vorrang hat. Der build-fluentqt-gui-Skill deckt alles von der Projektanalyse bis zur unabhängigen Prüfung ab.

Gallery

Gleicht das Beispielverhalten über C++, PySide6 und WebAssembly hinweg an.

1.7.4

UILib

Menüzugriffstasten bleiben während Menüanimationen funktionsfähig.

Gallery

Native Vorschauen spielen Zeiger- und Tastaturaktionen vor der Aufnahme ab und melden Widget-Geometrien sowie Inspector-Ergebnisse.

1.7.3

UILib

Auswahlkonturen in CalendarView sind abgerundet, Picker-Flyouts richten sich an ihren Feldern aus und TeachingTip-Schatten verteilen sich gleichmäßig.

Gallery

Live Scene hält ein PySide6-Vorschaufenster geöffnet und aktualisiert es beim Speichern.

1.7.2

UILib

Fügt MultiSelectComboBox sowie die Befehle fluentqt doctor, create und trial hinzu, die das lokale Qt-Setup prüfen und ein C++- oder PySide6-Starterprojekt erzeugen. Behebt zudem mehrere plattformübergreifende Auswahl- und Listenprobleme.

1.7.0

UILib

Migration erforderlich

Entfernt die Designsprachen Material und Cupertino, sodass nur Fluent bleibt. Fügt Field und DataGrid hinzu und dokumentiert das Öffnungs-, Schließ- und Modalverhalten aller Overlays.

APIs für Designsprache und Stil-Theme entfernt

DesignLanguage, StyleTheme und StyleThemeCatalog wurden ersatzlos ohne Aliase entfernt. Apps, die nur Fluent Hell und Dunkel genutzt haben, sind nicht betroffen.

Wählen Sie das Erscheinungsbild mit Theme und passen Sie Tokens mit UserTheme an. Verwenden Sie in Python current_theme(), apply_user_theme(), set_accent_color() und reset_theme_tokens(). Die Gallery ignoriert die alte Einstellung styleTheme.

Vorher
FluentElement::DesignLanguage
StyleTheme / StyleThemeCatalog
current_design_language()
apply_style_theme()
Nachher
FluentElement::Theme
fluent::UserTheme
current_theme()
apply_user_theme()

1.6.4

UILib

TextEdit berücksichtigt benutzerdefinierte Inhaltsränder. Der Skill build-fluentqt-gui skaliert Prüfungen passend zur App-Größe.

Gallery

Codebeispiele im Browser können zwischen C++ und PySide6 umschalten.

1.6.3

UILib

Liefert den Skill build-fluentqt-gui für Coding-Agents samt Komponentenkatalog, der C++- und PySide6-APIs auf Gallery-Beispiele abbildet. ListView erhält einen Standarddelegaten, und installierte Pakete betten keine SDK-Pfade des Build-Rechners mehr ein.

1.6.1

UILib

Ergänzt die PyPI-Seite von FluentQt um eine vollständige Paketdokumentation und Projektlinks.

Gallery

Ergänzt die PyPI-Seite von FluentQt-Gallery um eine vollständige Paketdokumentation und Projektlinks.

1.5.3

UILib

Gedrückte Schaltflächen verdecken ihren unteren Rahmen nicht mehr. Unter macOS nutzen benutzerdefinierte Titelleisten natives Fensterziehen als Fallback, wenn Qt Trackpad-Ereignisse verwirft.

1.5.2

UILib

Fügt CommandBar, CommandBarFlyout sowie EditingCommandRouter für Rückgängig, Kopieren, Einfügen und verwandte Aktionen hinzu. Toast erhält Aktionsschaltflächen, Pausieren bei Hover und direkte Aktualisierungen.

1.5.0

UILib

Migration erforderlich

Fügt kategoriespezifische Header wie <FluentQt/BasicInput.h>, typisierte Schriftrollen und Auswahlmodi sowie explizite Eigentümerschaft für gehostete Widgets hinzu. Anwendungen stellen nun eigene lokalisierte Texte für Auswahlfelder und Schalter bereit.

Typisierte Schriftrollen, gemeinsame Auswahlmodi und explizite Eigentümerschaft

Code, der Schriftrollen als Zeichenketten übergibt, ansichtsspezifische Auswahl-Enums verwendet, Implementierungs-Header einbindet oder auf implizite Eigentümerschaft gehosteter Widgets setzt, muss aktualisiert werden.

Binden Sie nur öffentliche Header ein und übergeben Sie WidgetOwnership, wo eine API dies verlangt. Stellen Sie lokalisierte Auswahltexte, ToggleSwitch-Beschriftungen und barrierefreie Namen aus der Anwendung bereit.

Vorher
"Body"
FlowSelectionMode / GridSelectionMode
ListSelectionMode / TreeSelectionMode
Nachher
Typography::FontRole::Body
fluent::collections::SelectionMode
fluent::WidgetOwnership

1.4.2

UILib

Behebt rechte und untere Anker in AnchorLayout, QMLPlus-Zustandsübergänge sowie den Zugriff auf gebündelte Ressourcen vor Erstellung von QApplication. TextEdit leitet den Fokus korrekt weiter und behält den Rückgängig-Verlauf beim erneuten Setzen des Texts.

1.4.1

UILib

Steuerelemente bleiben bei gebrochenen Anzeigeskalierungen bis 300 % scharf. Dialog und CoachMark öffnen sich als Overlays im übergeordneten Fenster statt in separaten nativen Fenstern, was eingefrorene Eingaben unter macOS behebt.

1.4.0

UILib

Bündelt Schriftarten und Fluent System Icons, wodurch die Abhängigkeit von einer systemweiten Segoe-Installation entfällt.

Gallery

Fügt Seiten für Typografie, Farben, Symbole und Abstände hinzu und folgt der Anzeigeskalierung des Systems.

1.3.2

Datum nicht erfasst

UILib

Installierte Pakete legen nur eine explizite Liste öffentlicher Header offen.

Gallery

Komponentenseiten zeigen Header, C++-Typ und CMake-Target an. Der Seitenwechsel ist schneller.

1.3.1

Datum nicht erfasst

UILib

Die Bibliothek hängt nur von Qt Widgets ab. Releases enthalten ein reines Bibliotheks-Quellarchiv.

Gallery

Behält spdlog in der Gallery bei und entfernt ungenutzte Qt-Module aus den Paketen.

1.3.0

Datum nicht erfasst

UILib

Fügt Linux-Unterstützung für X11 und Wayland auf x64 und ARM64 samt Debian-Paketen hinzu. Window::setBackdropEffect() bietet eine einheitliche Mica/Acrylic-API auf jeder Plattform.