Fluent-Qt

Actualizaciones del proyecto

Versiones y migraciones

Actualizaciones y requisitos de migración para UILib y Gallery, agrupados por versión.

1.12.1

Última versión

UILib

PropertyPanel crea los editores a medida que las filas entran en pantalla. AreaChart reutiliza el relleno al mover el puntero por el gráfico.

Gallery

Al desplazarse por el diálogo What’s new, las líneas divisorias permanecen opacas. Los ejemplos de fotos cargan las imágenes cuando se necesitan.

Notas del proyecto

El sitio web, la referencia de la API de los componentes y los editores de propiedades interactivos están disponibles en nueve idiomas.

1.12.0

UILib

Apila iconos y etiquetas en botones, muestra encabezados de columna en árboles y restaura ventanas maximizadas en el monitor correcto.

  • Usa Button::IconAbove o Button::IconBelow para situar un icono encima o debajo de su etiqueta.
  • TreeView deja espacio para los encabezados de columna visibles. Usa headerlessTopInset para ajustar el espacio sobre la primera fila cuando el título y los encabezados de columna están ocultos.
  • En Windows, al restaurar una Window maximizada se utiliza el área de trabajo del monitor de destino.

Gallery

Lee las notas de la versión sin conexión y prueba el ejemplo de encabezados de columna en vista de árbol.

  • Abre What’s new en la barra de título. En anchos compactos, usa el icono de megáfono para leer las novedades incluidas en Gallery.
  • El ejemplo de TreeView muestra cómo aparecen los encabezados del modelo encima de la primera fila.

Notas del proyecto

Edita ejemplos interactivos de Qt en 99 páginas de documentación de componentes y copia el código C++ o PySide6 resultante.

1.11.4

UILib

Informes de diagnóstico, Snap Layouts de Windows 11 y ajustes compartidos de marco para campos de texto.

  • DiagnosticSession registra eventos recientes de la interfaz y capturas de widgets en un archivo ZIP en memoria.
  • Pasa el cursor sobre el botón de maximizar en un Window redimensionable para usar Snap Layouts de Windows 11.
  • Los campos de texto comparten la configuración de marco de LineEdit. El subrayado sin foco tiene ancho cero por defecto y los bordes de ancho cero ya no dibujan una línea fina.
  • Toast corrige la propiedad de los widgets de acción y el diseño en ventanas estrechas.

Gallery

Informa problemas de Gallery con un archivo ZIP de diagnósticos recientes.

  • Elige Reportar un problema junto a Configuración para copiar un ZIP de diagnóstico, incluidos los informes de fallos locales coincidentes. Elige Abrir incidencia en GitHub en la notificación y luego pega el archivo.
  • En Gallery web, el ZIP se descarga para que puedas adjuntarlo a tu informe.

Notas del proyecto

El historial de versiones del sitio web separa las actualizaciones de UILib y Gallery, con filtros de ámbito y enlaces estables a versiones y migración.

1.11.3

UILib

Añade Transfer, sufijos de unidad y widgets finales para LineEdit y ComboBox, geometría del cursor en TextEdit y correcciones de diseño en campos editables.

  • LineEdit y ComboBox muestran sufijos de unidad como px (separados del texto editado) o alojan un widget final personalizado.
  • Transfer mueve elementos entre dos listas con búsqueda mediante claves estables y omite las entradas deshabilitadas.
  • TextEdit expone el rectángulo del cursor y su señal de cambio para posicionar ventanas emergentes de autocompletado en línea.
  • Corrige los límites de texto en ComboBox editable tras seleccionar o actualizar el modelo, y el centrado del icono de arrastre de NumberBox en distintas escalas de pantalla.

Gallery

Añade un ejemplo de autocompletado de miembros @ en línea y corrige el recorte redirigido en versiones antiguas de Qt.

  • Escribe @ en el ejemplo de autocompletado de miembros de TextEdit. Usa las teclas de flecha para elegir un nombre e insertarlo sin salir del editor.

1.11.2

UILib

Omite las llamadas nativas de estilo Win32 y fondo en identificadores de ventana sintéticos offscreen y minimal.

Gallery

Añade estados deshabilitados a los ejemplos de CheckBox en C++ y PySide6.

1.11.1

UILib

Añade RangeSlider e ImageViewer, con correcciones para la alineación de texto, superposiciones y renderizado con escalado fraccionario.

  • RangeSlider selecciona un valor inferior y superior con espaciado mínimo, pasos de teclado, indicaciones de valor y controles duales accesibles.
  • ImageViewer añade zoom centrado en el puntero, desplazamiento panorámico, modos de ajuste, navegación táctil por pellizco y por teclado, y miniaturas en caché, incluso dentro de FlipView.
  • Corrige artefactos en escalas fraccionarias e inferiores al 100% mediante repintados por región local y evita repintar toda la ventana en fotogramas solo de GPU.
  • Corrige la alineación de texto en controles compactos, los márgenes de iconos de menú, el foco de desbordamiento de SelectorBar y las capturas de fondo en ventanas emergentes.

Gallery

Requiere migración

Guarda el zoom de la interfaz (50%–200%) y pagina los resultados de búsqueda de componentes y ejemplos. Las compilaciones desde el código fuente requieren encabezados privados de Qt coincidentes.

1.11.0

UILib

Requiere migración

Mueve los efectos de partículas al módulo opcional FluentQt::Particles, añade fuentes de iconos personalizadas a FontIcon y publica wheels de Python con ABI estable.

  • FontIcon añade fontFamily() y setFontFamily() para fuentes de iconos personalizadas. Pasa el carácter Unicode del glifo directamente o deja la familia vacía para usar los iconos Fluent incluidos.
  • Los efectos de partículas pasan de la biblioteca principal al destino opcional FluentQt::Particles (fluentqt.particles en Python).
  • Las compilaciones Debug de escritorio enlazan por defecto el entorno de ejecución Release de Qt. Establece FLUENT_QT_DEBUG_RELEASE_RUNTIME=OFF para enlazar bibliotecas Qt de depuración.
  • Las superposiciones abiertas siguen el movimiento de la superficie anfitriona, el indicador de las barras de desplazamiento se alinea con su área interactiva y los wheels de Python usan la ABI estable de CPython (abi3).

ParticleBackdrop se traslada al módulo Particles

Se eliminan fluent::layout::ParticleBackdrop y fluentqt.layout.ParticleBackdrop. Vincular solo FluentQt::FluentQt ya no incluye los efectos de partículas.

Activa FLUENT_QT_BUILD_PARTICLES al compilar desde el código fuente o solicita COMPONENTS Particles y enlaza FluentQt::Particles; luego actualiza las inclusiones, espacios de nombres e importaciones.

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

Introducido en b674c94

Gallery

3D Gallery solo carga las filas de textura modificadas, restaura el renderizado nítido al detenerse el movimiento, limita la memoria caché de texturas y vuelve a 2D ante fotogramas lentos sostenidos.

1.10.3

UILib

Añade edición numérica y de propiedades, exportación de gráficos y nuevos controles de selección.

  • Los valores de NumberBox pueden ajustarse arrastrando además de escribiendo, y el arrastre puede cancelarse. PropertyPanel agrupa campos, los busca por nombre y los restablece a los valores predeterminados.
  • Los gráficos guardan un PNG o exportan las filas de origen como CSV, para el rango visible o todos los datos.
  • AutoSuggestBox acepta sugerencias asíncronas y descarta las obsoletas. Novedades: TagInput para etiquetas con ID estables y TreeSelect para seleccionar desde un modelo en árbol.
  • DataGrid permite fijar columnas y DataGridToolBar añade búsqueda, filtros y controles de columnas.

Notas del proyecto

Cada página de componente del sitio web muestra un ejemplo interactivo, código en C++ y PySide6 y la API pública, en inglés y chino.

1.10.2

UILib

Añade CommandPalette, FormController y CodeBlock. Popup, Dialog y DrawerView comparten un conjunto de opciones de desenfoque y atenuación de fondo, y las superficies modales bloquean los clics y atajos detrás de ellas.

1.10.1

UILib

CommandBar y CommandBarFlyout aceptan acciones con submenús anidados de FluentMenu. TextEdit::appendPlainText() añade líneas de registro sin perder la selección ni el historial de deshacer. Las casillas de verificación y los botones de opción desmarcados tienen contornos más definidos.

1.10.0

UILib

Añade DateTimeRangePicker, QmlBridge para alojar páginas QML en ventanas Widgets y el módulo opcional Plugins para dependencias, activación y limpieza de extensiones.

Gallery

Python Live Scene recarga las vistas previas en la misma ventana.

1.9.3

UILib

Corrige el fondo de las ventanas al iniciar y al cambiar de material. Las ventanas nuevas ya no parpadean en blanco en modo oscuro y, al cambiar desde Mica o Acrylic, se mantiene el material anterior hasta dibujar el nuevo fondo.

1.9.1

UILib

Los wheels de Python ahora incluyen el módulo opcional Spatial que faltaba en 1.9.0.

Gallery

La versión empaquetada de Gallery 3D usa Direct3D 11 en Windows ARM64 y recurre a 2D cuando no hay aceleración por hardware.

  • Los wheels de la versión 1.9.0 se publicaron sin Spatial. Actualiza tanto FluentQt como FluentQt-Gallery a 1.9.1 para obtener Gallery 3D.

1.9.0

UILib

Añade el módulo opcional Spatial. SpatialView coloca widgets comunes sobre superficies 3D en perspectiva, manteniendo su manejo de entrada y señales.

Gallery

Añade un modo 3D a Gallery de escritorio y navegador.

1.8.5

UILib

Añade un módulo Charts (líneas, áreas, barras, circular, anillo, dispersión y minigráfico) dibujado con Qt Widgets y sin dependencia de Qt Charts, además de FileDropZone y FileListView. Toast estrena estilo de tarjeta y un botón de cierre opcional.

1.8.4

UILib

SplashScreen realiza menos repintados durante su animación de aparición.

Gallery

Actualiza el icono de la aplicación, las imágenes del instalador y las capturas de pantalla del sitio web.

1.8.3

UILib

Añade ParticleBackdrop, un fondo de partículas dibujado por CPU, y un SplashScreen reutilizable. Corrige la selección por teclado y la edición de texto.

Gallery

Facilita la lectura y copia del código fuente de los ejemplos.

1.8.2

UILib

UserTheme::applyOverrides() cambia colores, radios de esquina y fuentes en toda la aplicación, y setThemeOverrides() hace lo mismo para un solo componente. Los desplegables de ComboBox ahora usan fuentes personalizadas. También corrige errores de devolución de llamada, navegación y controles deslizantes en las versiones de Qt compatibles.

1.8.0

UILib

Añade HighContrast y modos globales de MotionPolicy (Full, Reduced, Disabled). Un TextEdit con foco anima sus cambios de altura automática.

Gallery

Añade ajustes de alto contraste y movimiento a Gallery en C++, PySide6 y navegador.

1.7.5

UILib

Los botones, interruptores y selectores de fecha/hora comparten las reglas de fontRole, con prioridad para setFont() explícito. La Skill build-fluentqt-gui abarca desde el análisis del proyecto hasta la revisión independiente.

Gallery

Alinea el comportamiento de los ejemplos entre C++, PySide6 y WebAssembly.

1.7.4

UILib

Las teclas de acceso de los menús siguen funcionando durante la animación.

Gallery

Las vistas previas nativas reproducen acciones de puntero y teclado antes de la captura e informan la geometría de los widgets y los hallazgos del Inspector.

1.7.3

UILib

Los contornos de selección de CalendarView son redondeados, los menús flotantes de selección se alinean con sus campos y las sombras de TeachingTip se difuminan uniformemente.

Gallery

Live Scene mantiene abierta una ventana de vista previa de PySide6 y la actualiza al guardar.

1.7.2

UILib

Añade MultiSelectComboBox y los comandos fluentqt doctor, create y trial para comprobar la configuración local de Qt y generar un proyecto inicial en C++ o PySide6. También corrige varios problemas de selectores y listas entre plataformas.

1.7.0

UILib

Requiere migración

Elimina los lenguajes de diseño Material y Cupertino, dejando Fluent como único lenguaje. Añade Field y DataGrid, y documenta el comportamiento de apertura, cierre y modalidad de cada superposición.

Se eliminaron las API de lenguaje de diseño y tema de estilo

DesignLanguage, StyleTheme y StyleThemeCatalog se han eliminado sin alias. Las aplicaciones que solo usaban los temas Fluent claro y oscuro no se ven afectadas.

Elige la apariencia con Theme y personaliza los tokens con UserTheme. En Python, usa current_theme(), apply_user_theme(), set_accent_color() y reset_theme_tokens(). Gallery ignora el antiguo ajuste styleTheme.

Antes
FluentElement::DesignLanguage
StyleTheme / StyleThemeCatalog
current_design_language()
apply_style_theme()
Después
FluentElement::Theme
fluent::UserTheme
current_theme()
apply_user_theme()

1.6.4

UILib

TextEdit respeta los márgenes de contenido personalizados. La Skill build-fluentqt-gui adapta las comprobaciones al tamaño de la aplicación.

Gallery

Los ejemplos de código en el navegador permiten alternar entre C++ y PySide6.

1.6.3

UILib

Incluye la Skill build-fluentqt-gui para agentes de programación, con un catálogo de componentes que asigna las API de C++ y PySide6 a ejemplos de Gallery. ListView incorpora un delegado predeterminado y los paquetes instalados ya no incrustan rutas del SDK de la máquina de compilación.

1.6.1

UILib

Añade documentación completa del paquete y enlaces del proyecto a la página de FluentQt en PyPI.

Gallery

Añade documentación completa del paquete y enlaces del proyecto a la página de FluentQt-Gallery en PyPI.

1.5.2

UILib

Añade CommandBar, CommandBarFlyout y EditingCommandRouter para deshacer, copiar, pegar y acciones relacionadas. Toast incorpora botones de acción, pausa al pasar el cursor y actualizaciones in situ.

1.5.0

UILib

Requiere migración

Añade cabeceras por categoría como <FluentQt/BasicInput.h>, roles de fuente y modos de selección tipados, y propiedad explícita para widgets alojados. Ahora las aplicaciones proporcionan su propio texto localizado para selectores e interruptores.

Roles de fuente tipados, modos de selección compartidos y propiedad explícita

El código que pasa roles de fuente como cadenas, usa enumeraciones de selección por vista, incluye cabeceras de implementación o depende de la propiedad implícita de widgets alojados debe actualizarse.

Incluye solo cabeceras públicas y pasa WidgetOwnership donde lo requiera una API. Proporciona desde la aplicación el texto localizado de los selectores, las etiquetas de ToggleSwitch y los nombres accesibles.

Antes
"Body"
FlowSelectionMode / GridSelectionMode
ListSelectionMode / TreeSelectionMode
Después
Typography::FontRole::Body
fluent::collections::SelectionMode
fluent::WidgetOwnership

1.4.2

UILib

Corrige los anclajes derecho e inferior de AnchorLayout, las transiciones de estado de QMLPlus y el acceso a recursos integrados antes de que exista QApplication. TextEdit transfiere el foco correctamente y conserva el historial de deshacer al volver a establecer su texto.

1.4.1

UILib

Los controles se mantienen nítidos en escalas de pantalla fraccionarias de hasta el 300%. Dialog y CoachMark se abren como superposiciones dentro de la ventana propietaria en lugar de ventanas nativas separadas, lo que corrige el bloqueo de entrada en macOS.

1.4.0

UILib

Incluye fuentes y Fluent System Icons integrados, eliminando la dependencia de tener Segoe instalado en el sistema.

Gallery

Añade páginas de tipografía, color, iconos y espaciado, y sigue la escala de pantalla del sistema.

1.3.2

Fecha no registrada

UILib

Los paquetes instalados solo exponen una lista explícita de cabeceras públicas.

Gallery

Las páginas de componentes muestran la cabecera, el tipo C++ y el objetivo de CMake. Cambiar de página es más rápido.

1.3.1

Fecha no registrada

UILib

La biblioteca depende únicamente de Qt Widgets. Las versiones incluyen un archivo de código fuente solo de la biblioteca.

Gallery

Mantiene spdlog en Gallery y elimina los módulos de Qt sin uso de sus paquetes.

1.3.0

Fecha no registrada

UILib

Añade compatibilidad con Linux para X11 y Wayland en x64 y ARM64, con paquetes Debian. Window::setBackdropEffect() ofrece una única API de Mica/Acrylic en todas las plataformas.