Fluent-Qt

Collections

Transfer

Search and move items between two lists without changing the source model.

Example

Transfer: Choose a project team

Usage

Choose a project team

Search either list, select members, and move them together. Disabled members stay unavailable.

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

#pragma once

#include <FluentQt/FluentQt.h>
#include <QItemSelectionModel>
#include <QStandardItemModel>
#include <QVBoxLayout>

namespace fluent::gallery {

class TransferSample final : public QWidget {
public:
    explicit TransferSample(QWidget* parent = nullptr) : QWidget(parent)
    {
        setObjectName(QStringLiteral("transferSample"));
        setMaximumWidth(740);
        auto* layout = new QVBoxLayout(this);
        layout->setContentsMargins(0, 0, 0, 0);
        layout->setSpacing(::Spacing::Standard);
        auto* model = new QStandardItemModel(this);
        const QList<QStringList> members{{"lin", "Lin Xiao", "Design"}, {"lin-yue", "Lin Yue", "Engineering"},
            {"xu", "Xu An", "QA"}, {"song", "Song Ke", "Unavailable"}, {"zhou", "Zhou Ning", "Engineering"},
            {"shen", "Shen Yi", "Product"}};
        for (const auto& member : members) {
            auto* item = new QStandardItem(member.at(1));
            item->setData(member.at(0), Qt::UserRole);
            item->setData(member.at(2), Qt::UserRole + 1);
            item->setEnabled(member.at(0) != QStringLiteral("song"));
            model->appendRow(item);
        }
        auto* transfer = new collections::Transfer(this);
        transfer->setObjectName(QStringLiteral("projectMemberTransfer"));
        transfer->setAccessibleName(QStringLiteral("Project members"));
        transfer->setSourceHeader(QStringLiteral("Available members"));
        transfer->setTargetHeader(QStringLiteral("Project members"));
        transfer->setSearchPlaceholderText(QStringLiteral("Search members"));
        transfer->setDescriptionRole(Qt::UserRole + 1);
        transfer->setModel(model);
        transfer->setSelectedKeys({QStringLiteral("zhou"), QStringLiteral("shen")});
        layout->addWidget(transfer);
        auto* status = new textfields::Label(this);
        status->setObjectName(QStringLiteral("transferMemberCount"));
        status->setFluentTypography(Typography::FontRole::Caption);
        status->setTextColorRole(textfields::Label::TextColorRole::Secondary);
        status->setWordWrap(true);
        const auto updateStatus = [transfer, status]() {
            status->setText(
                QStringLiteral("%1 project members · Source data stays unchanged").arg(transfer->selectedCount()));
        };
        connect(transfer, &collections::Transfer::countsChanged, status, updateStatus);
        updateStatus();
        layout->addWidget(status);
    }
};

} // namespace fluent::gallery

fluent::collections::Transfer

Inherits QWidget · FluentElement · QMLPlus

Searchable dual-list selection backed by a caller-owned flat model.

Constructors

Properties

QAbstractItemModel* model
Read model()Write setModel()Notify modelChanged()
int keyRole
Read keyRole()Write setKeyRole()Notify keyRoleChanged()
int descriptionRole
Read descriptionRole()Write setDescriptionRole()Notify descriptionRoleChanged()
QStringList selectedKeys
Read selectedKeys()Write setSelectedKeys()Notify selectedKeysChanged()
int selectedCount
Read selectedCount()Notify countsChanged()
int availableCount
Read availableCount()Notify countsChanged()
QString sourceHeader
Read sourceHeader()Write setSourceHeader()Notify sourceHeaderChanged()
QString targetHeader
Read targetHeader()Write setTargetHeader()Notify targetHeaderChanged()
QString sourceFilter
Read sourceFilter()Write setSourceFilter()Notify sourceFilterChanged()
QString targetFilter
Read targetFilter()Write setTargetFilter()Notify targetFilterChanged()
QString searchPlaceholderText
Read searchPlaceholderText()Write setSearchPlaceholderText()Notify searchPlaceholderTextChanged()

Methods

void setModel(QAbstractItemModel* model)

Borrows the model; destruction clears the surface without taking ownership.

void setSelectedKeys(const QStringList& keys)

Keeps unique known keys in the supplied order; disabled keys may be assigned programmatically.

ListView* sourceView() const

Owned views for delegates, keyboard selection, and inspection; keep their internal models installed.

Signals

Destructors

Subclass interfaces

Methods

Inherited from fluent::FluentElement

Methods

static void setTheme(Theme theme)

Updates the global theme and notifies active FluentElement instances.

static void setThemeDeferred(Theme theme)

Schedules a visible-first batched theme refresh without blocking the current interaction.

static Theme currentTheme()

Returns the currently active global theme.

static bool themeUsesDarkAppearance(Theme theme)

Returns whether a theme uses dark-backed chrome and material tokens.

static void refreshTheme()

Re-broadcasts the current theme to repaint after a design-token change.

static int themeGeneration()

Monotonic counter bumped on every theme change, for staleness checks.

Theme effectiveTheme() const

Resolves the theme used by this element, honoring an inherited QWidget override.

bool effectiveThemeUsesDarkAppearance() const

Returns whether this element's effective theme uses dark-backed chrome.

QJsonObject themeOverrides() const

Returns this element's authored overrides.

void clearThemeOverrides()

Restores all token fields to global theme defaults.

const Colors& themeColorsRef() const

Non-copying access to the active color set (for hot paint paths).

Material::AcrylicToken themeAcrylic() const

Material, elevation, and adaptive layout tokens.

QColor themeBackdrop(bool active) const

Window-chrome backdrop color for the given activation state.

virtual void onThemeUpdated()

Called after the global theme changes.

Enumerations

enum Theme

Global visual theme used when resolving design tokens.

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

Types and aliases

struct Colors

Design token snapshots returned to components.

Inherited from fluent::QMLPlus

Methods

AnchorLayout::Anchors* anchors()

Returns mutable anchors for the QWidget host.

void setState(const QString& name)

Applies a named state, or clears state when name is empty.

void addState(const QMLState& state)

Registers or replaces a named state definition.

void evaluateStates()

Reevaluates conditions; the first registered true condition wins.

QMLPlusRuntime* runtime()

Returns the lazy host-owned state observation object.

void setAnchors(const AnchorLayout::Anchors& anchors)

Replaces all host anchors and invalidates the parent layout.

void resetAnchors()

Clears all host anchors and invalidates the parent layout.

void addTransition(const StateTransition& transition)

Registers a state transition in precedence order.

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

Sets the default animation for this host's managed property writes.

void clearBehavior(const char* propertyName)

Removes the default animation for future managed writes.

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

Writes a host property through Behavior without removing its binding.

All inherited Qt members:QWidget