Fluent-Qt

Vistas de colección

SplitView Vista dividida

Aloja paneles redimensionables separados por tiradores arrastrables.

Ejemplo

SplitView Vista dividida: Paneles redimensionables

Uso

Paneles redimensionables

Arrastra el tirador entre los paneles para cambiar su tamaño.

#include <FluentQt/Collections.h>
using namespace fluent::collections;

auto* splitView = new SplitView(this);
splitView->addPane(firstPane);
splitView->addPane(secondPane);
splitView->addPane(thirdPane);
splitView->setPanePreferredSize(0, 150);
splitView->setPaneFill(2, true);

fluent::collections::SplitView

Hereda de QWidget · FluentElement · QMLPlus

Contenedor multipanel redimensionable con controladores divisores Fluent arrastrables. Administra el orden de paneles, los límites de tamaño, el estiramiento del panel de relleno, la orientación y la serialización del estado.

Constructores

Destructores

Métodos

int addPane(QWidget* pane, WidgetOwnership ownership, const SplitViewPaneOptions& options = SplitViewPaneOptions())

Añade al final un widget de panel con un modo de eliminación WidgetOwnership explícito.

int insertPane(int index, QWidget* pane, WidgetOwnership ownership, const SplitViewPaneOptions& options = SplitViewPaneOptions())

Inserta un widget de panel en el índice con un modo de eliminación WidgetOwnership explícito.

bool removePane(QWidget* pane)

Eliminación heredada que desvincula el panel sin eliminarlo.

QWidget* removePaneAt(int index)

Eliminación heredada que desvincula y devuelve el panel en index sin eliminarlo.

bool releasePane(QWidget* pane)

Quita un panel y lo libera según su modo WidgetOwnership.

bool releasePaneAt(int index)

Quita el panel en index y lo libera según su modo WidgetOwnership.

QWidget* takePaneAt(int index)

Quita y devuelve el panel en index sin eliminarlo.

WidgetOwnership paneOwnershipAt(int index) const

Devuelve el modo de eliminación configurado para el panel en index.

Qt::Orientation orientation() const

Orientación principal de diseño o movimiento.

void setOrientation(Qt::Orientation orientation)

Orientación principal de diseño o movimiento.

bool resizing() const

Indica si se está arrastrando activamente un controlador de división.

int handleWidth() const

Ancho interactivo del controlador de división.

void setHandleWidth(int width)

Ancho interactivo del controlador de división.

int handleVisualThickness() const

Grosor pintado del indicador del controlador de división.

void setHandleVisualThickness(int thickness)

Grosor pintado del indicador del controlador de división.

int fillPaneIndex() const

Índice del panel que consume el espacio restante de SplitView.

void setFillPaneIndex(int index)

Índice del panel que consume el espacio restante de SplitView.

QSize defaultSizeHint() const

Sugerencia de tamaño alternativo del panel cuando un panel no proporciona una.

void setDefaultSizeHint(const QSize& size)

Sugerencia de tamaño alternativo del panel cuando un panel no proporciona una.

QSize defaultMinimumSizeHint() const

Sugerencia de tamaño mínimo alternativo del panel.

void setDefaultMinimumSizeHint(const QSize& size)

Sugerencia de tamaño mínimo alternativo del panel.

Propiedades

Qt::Orientation orientation

Orientación principal de diseño o movimiento.

Lectura orientation()Escritura setOrientation()Notificación orientationChanged()
bool resizing

Indica si se está arrastrando activamente un controlador de división.

Lectura resizing()Notificación resizingChanged()
int handleWidth

Ancho interactivo del controlador de división.

Lectura handleWidth()Escritura setHandleWidth()Notificación handleWidthChanged()
int handleVisualThickness

Grosor pintado del indicador del controlador de división.

Lectura handleVisualThickness()Escritura setHandleVisualThickness()Notificación handleVisualThicknessChanged()
int fillPaneIndex

Índice del panel que consume el espacio restante de SplitView.

Lectura fillPaneIndex()Escritura setFillPaneIndex()Notificación fillPaneIndexChanged()
QSize defaultSizeHint

Sugerencia de tamaño alternativo del panel cuando un panel no proporciona una.

Lectura defaultSizeHint()Escritura setDefaultSizeHint()Notificación defaultSizeHintChanged()
QSize defaultMinimumSizeHint

Sugerencia de tamaño mínimo alternativo del panel.

Lectura defaultMinimumSizeHint()Escritura setDefaultMinimumSizeHint()Notificación defaultMinimumSizeHintChanged()

Señales

void orientationChanged(Qt::Orientation orientation)

Orientación principal de diseño o movimiento.

void resizingChanged(bool resizing)

Indica si se está arrastrando activamente un controlador de división.

void handleWidthChanged(int width)

Ancho interactivo del controlador de división.

void handleVisualThicknessChanged(int thickness)

Grosor pintado del indicador del controlador de división.

void fillPaneIndexChanged(int index)

Índice del panel que consume el espacio restante de SplitView.

void defaultSizeHintChanged(const QSize& size)

Sugerencia de tamaño alternativo del panel cuando un panel no proporciona una.

void defaultMinimumSizeHintChanged(const QSize& size)

Sugerencia de tamaño mínimo alternativo del panel.

Adiciones de PySide6

addOwnedPane(pane, options=None)

Añade al final un panel que se elimina al retirarlo de SplitView.

addBorrowedPane(pane, options=None)

Añade al final un panel que queda sin padre al retirarlo de SplitView.

addReparentedPane(pane, options=None)

Añade al final un panel que, al retirarse, vuelve a su QWidget padre anterior.

insertOwnedPane(index, pane, options=None)

Inserta un panel que se elimina al retirarlo de SplitView.

insertBorrowedPane(index, pane, options=None)

Inserta un panel que queda sin padre al retirarlo de SplitView.

insertReparentedPane(index, pane, options=None)

Inserta un panel que, al retirarse, vuelve a su QWidget padre anterior.

Miembros protegidos

Métodos

Heredado de fluent::FluentElement

Enumeraciones

enum Theme

Tema visual global usado al resolver los tokens de diseño.

  • Light = 0
  • Dark = 1
  • HighContrast = 2

Métodos

static void setTheme(Theme theme)

Actualiza el tema global y notifica a las instancias activas de FluentElement.

static void setThemeDeferred(Theme theme)

Programa una actualización de tema por lotes dando prioridad a lo visible sin bloquear la interacción actual.

static Theme currentTheme()

Devuelve el tema global activo actualmente.

static bool themeUsesDarkAppearance(Theme theme)

Devuelve si un tema utiliza cromo sobre fondo oscuro y tokens de material.

static void refreshTheme()

Vuelve a difundir el tema actual para repintar tras un cambio de token de diseño.

static int themeGeneration()

Contador monótono incrementado en cada cambio de tema para comprobaciones de obsolescencia.

Theme effectiveTheme() const

Resuelve el tema usado por este elemento, respetando una invalidación heredada de QWidget.

bool effectiveThemeUsesDarkAppearance() const

Devuelve si el tema efectivo de este elemento usa cromo sobre fondo oscuro.

bool setThemeOverrides(const QJsonObject& overrides)

Reemplaza las invalidaciones dispersas de tokens de color, radio y fuente de este elemento.

QJsonObject themeOverrides() const

Devuelve las anulaciones definidas en este elemento.

void clearThemeOverrides()

Restaura todos los campos de token a los valores predeterminados del tema global.

const Colors& themeColorsRef() const

Acceso sin copia al conjunto de colores activo para rutas críticas de pintado.

Material::AcrylicToken themeAcrylic() const

Tokens de material, elevación y diseño adaptable.

QColor themeBackdrop(bool active) const

Color de fondo del chrome de la ventana para el estado de activación indicado.

virtual void onThemeUpdated()

Se llama después de que cambia el tema global.

Tipos y alias

struct Colors

Instantáneas de tokens de diseño devueltas a los componentes.

Heredado de fluent::QMLPlus

Métodos

AnchorLayout::Anchors* anchors()

Devuelve los anclajes mutables del host QWidget.

void setState(const QString& name)

Aplica un estado registrado por nombre o restaura el estado predeterminado cuando @p name está vacío. Los nombres desconocidos se ignoran y los enlaces existentes se reanudan al salir del estado.

void addState(const QMLState& state)

Registra o reemplaza una definición de estado con nombre; reemplazar el estado activo lo aplica de inmediato.

void evaluateStates()

Reevalúa las condiciones de estado en orden de registro y activa la primera coincidencia, o el estado predeterminado si ninguna coincide. También se ejecuta automáticamente cuando notifican las propiedades dependientes; los estados derivados que usan extend heredan cambios de ancestros salvo que sean cíclicos o falten.

QMLPlusRuntime* runtime()

Devuelve el observador de estado creado de forma diferida y propiedad de este host.

void setAnchors(const AnchorLayout::Anchors& anchors)

Reemplaza todos los anclajes del host e invalida el diseño padre.

void resetAnchors()

Limpia todos los anclajes del host e invalida el diseño padre.

void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)

Vincula @p sourceProp en @p source con @p targetProp en este host QWidget mediante PropertyBinder::bind().

void addTransition(const StateTransition& transition)

Registra una transición de estado por orden de precedencia.

void setBehavior(const char* propertyName, const PropertyAnimation& animation)

Establece la animación por defecto usada al escribir @p propertyName mediante writeProperty() o un enlace. Las reglas StateTransition explícitas tienen prioridad; las llamadas directas a setters de C++ no se animan.

void clearBehavior(const char* propertyName)

Quita la animación predeterminada para futuras escrituras administradas.

bool writeProperty(const char* propertyName, const QVariant& value)

Escribe una propiedad del host mediante Behavior sin eliminar su enlace.

Documentación de la clase base de Qt: QWidget

fluent::collections::SplitViewPaneOptions

Campos