Fluent-Qt

Referencia de API

WindowChromeCompat

Adaptador multiplataforma para el comportamiento del marco de ventana, pruebas de impacto y fondos del sistema.

compatibility::WindowChromeOptions

Opciones para la integración del marco de ventana de la plataforma.

Campos

QRect titleBarRect

Área arrastrable de la barra de título en coordenadas locales de la ventana.

QVector<QRect> dragExclusionRects

Rectángulos de controles hijos dentro de la barra de título que conservan el área cliente normal.

int resizeBorderWidth = 8

Ancho del borde de prueba de impacto para redimensionar en píxeles independientes del dispositivo.

bool useCustomWindowChrome = false

Habilita la integración personalizada de la barra de título de Fluent dando prioridad a la gestión nativa de ventanas donde sea compatible.

bool preferNativeMacControls = true

Conserva los botones nativos de semáforo de macOS cuando están disponibles.

bool chromeInteractive = true

Bloquea el movimiento y el cambio de tamaño de la ventana cuando es false (p. ej., mientras una superposición modal está activa).

QPointer<QAbstractButton> maximizeButton

Botón de maximizar/restaurar usado para la prueba de impacto de la barra de título nativa.

compatibility::WindowChromeCompat

Constructores

Enumeraciones

enum class Platform

Familia de plataforma en tiempo de ejecución usada para decidir la política del cromo de ventana.

  • Windows
  • MacOS
  • Linux
  • Other
enum class HitTest

Resultado lógico de prueba de impacto asignado a códigos de impacto específicos de la plataforma.

  • Client
  • Caption
  • Left
  • Right
  • Top
  • Bottom
  • TopLeft
  • TopRight
  • BottomLeft
  • BottomRight

Métodos

void configure(const WindowChromeOptions& options)

Actualiza las opciones del marco de ventana y sincroniza la geometría de la barra de título de la plataforma.

void applyPlatformWindowFlags()

Aplica los indicadores de ventana de plataforma requeridos por la configuración actual del marco.

bool systemBackdropSupported() const

Indica si esta plataforma admite un fondo del sistema translúcido.

BackdropCapabilities backdropCapabilities() const

Devuelve las capacidades de la plataforma por efecto para la sesión actual.

bool applySystemBackdrop(BackdropEffect effect, bool dark, bool forceRecomposite = false)

Aplica el efecto de fondo del sistema solicitado (ayudante heredado; usa applySystemBackdropDetailed() para obtener los detalles del backend resuelto).

BackdropApplyResult applySystemBackdropDetailed(BackdropEffect effect, bool dark, bool forceRecomposite = false)

Aplica un efecto de fondo y devuelve el backend resuelto, la fidelidad y el motivo de respaldo.

bool handleNativeEvent(const QByteArray& eventType, void* message, FluentNativeEventResult* result)

Gestiona eventos nativos reenviados y devuelve true cuando se procesan.

bool beginSystemMove(const QPoint& globalPos)

Inicia una operación de movimiento de sistema de la plataforma.

bool beginSystemResize(Qt::Edges edges, const QPoint& globalPos)

Inicia una operación de redimensionamiento de sistema de la plataforma para los bordes indicados.

bool performTitleBarDoubleClick()

Ejecuta la acción de doble clic en la barra de título de la plataforma.

bool showSystemMenu(const QPoint& globalPos)

Muestra el menú del sistema de la plataforma en la posición global indicada.

bool requestForegroundActivation()

Solicita la activación en primer plano mediante el gestor de ventanas de la plataforma.

HitTest hitTestLocal(const QPoint& localPos) const

Clasifica un punto local según las regiones configuradas de barra de título y redimensionado.

compatibility

Tipos y alias

using FluentNativeEventResult = qintptr

Tipo de resultado de evento nativo usado por QWidget::nativeEvent() entre versiones de Qt.