Базовый ввод
FileDropZone Область перетаскивания файлов
Принимает перетаскивание локальных файлов и запрашивает у приложения диалог выбора при нажатии кнопки обзора.
Пример
Не удалось загрузить предпросмотр свойств. Выберите предпросмотр свойств ещё раз для повтора.

Использование
Добавление в рабочую область
filesDropped передаёт локальные URL при перетаскивании. Подключите browseRequested для открытия диалога выбора файлов и проверяйте типы и размеры файлов в приложении.
#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;
auto* panel = new QWidget(this);
auto* layout = new QVBoxLayout(panel);
layout->setContentsMargins(0, 0, 0, 0);
layout->setSpacing(24);
auto* drop = new FileDropZone(panel);
drop->setObjectName("fileDropZone");
drop->setDescription("Add documents, images or a ZIP archive.");
drop->setHintText("PDF, PNG, JPG, ZIP · Up to 20 MB per file");
layout->addWidget(drop);
auto* heading = new Label("Files", panel);
heading->setFluentTypography(Typography::FontRole::BodyStrong);
layout->addWidget(heading);
auto* model = new QStandardItemModel(panel);
auto addFile = [model](const QString& name, const QString& detail,
FileListView::Status state, qreal progress) {
auto* item = new QStandardItem(name);
item->setData(detail, FileListView::MetadataRole);
item->setData(state, FileListView::StatusRole);
item->setData(progress, FileListView::ProgressRole);
model->appendRow(item);
};
addFile("brand-guidelines.pdf", "2.4 MB · Ready to use", FileListView::Ready, 1.0);
addFile("product-shot.png", "3.6 / 5.8 MB · Uploading", FileListView::Uploading, 0.62);
addFile("archive.zip", "28 MB · Exceeds the 20 MB limit", FileListView::Rejected, 0.0);
auto* files = new FileListView(panel);
files->setObjectName("selectedFiles");
files->setAccessibleName("Selected files");
files->setBackgroundVisible(false);
files->setBorderVisible(false);
files->setProperty("fluentPreserveParentSurface", true);
files->viewport()->setProperty("fluentPreserveParentSurface", true);
files->setMinimumHeight(260);
files->setModel(model);
layout->addWidget(files);
QObject::connect(files, &FileListView::removeRequested, panel,
[model](const QModelIndex& index) { model->removeRow(index.row()); });
auto acceptFile = [drop, addFile](const QString& name, qint64 bytes) {
const QString suffix = QFileInfo(name).suffix().toLower();
const bool typeAllowed = QStringList{"pdf", "png", "jpg", "jpeg", "zip"}.contains(suffix);
const bool sizeAllowed = bytes <= 20 * 1024 * 1024;
if (!typeAllowed || !sizeAllowed) {
const QString reason = !typeAllowed ? "This file type is not supported."
: "Choose a file under 20 MB.";
drop->setErrorMessage(name + " · " + reason);
addFile(name, reason, FileListView::Rejected, 0.0);
return;
}
drop->clearError();
addFile(name, QString::number(bytes / (1024.0 * 1024.0), 'f', 1) + " MB · Ready to use",
FileListView::Ready, 1.0);
};
QObject::connect(drop, &FileDropZone::filesDropped, panel,
[acceptFile](const QList<QUrl>& urls) {
for (const QUrl& url : urls) {
const QFileInfo file(url.toLocalFile());
if (file.isFile())
acceptFile(file.fileName(), file.size());
}
});
QObject::connect(drop, &FileDropZone::browseRequested, panel, [panel, acceptFile]() {
platform::chooseFiles(panel, "Documents (*.pdf *.png *.jpg *.jpeg *.zip)", acceptFile);
});import fluentqt
from PySide6.QtCore import QFileInfo, Qt
from PySide6.QtGui import QStandardItem, QStandardItemModel
from PySide6.QtWidgets import QFileDialog, QVBoxLayout, QWidget
panel = QWidget()
layout = QVBoxLayout(panel)
layout.setContentsMargins(0, 0, 0, 0)
layout.setSpacing(24)
model = QStandardItemModel(panel)
roles = fluentqt.FileListView.DataRole
states = fluentqt.FileListView.Status
def add_file(name, detail, state, progress):
item = QStandardItem(name)
item.setData(detail, roles.MetadataRole)
item.setData(state, roles.StatusRole)
item.setData(progress, roles.ProgressRole)
model.appendRow(item)
add_file("brand-guidelines.pdf", "2.4 MB · Ready to use", states.Ready, 1.0)
add_file("product-shot.png", "3.6 / 5.8 MB · Uploading", states.Uploading, 0.62)
add_file("archive.zip", "28 MB · Exceeds the 20 MB limit", states.Rejected, 0.0)
drop = fluentqt.FileDropZone(panel)
drop.setObjectName("fileDropZone")
drop.setDescription("Add documents, images or a ZIP archive.")
drop.setHintText("PDF, PNG, JPG, ZIP · Up to 20 MB per file")
layout.addWidget(drop)
heading = fluentqt.Label("Files", panel)
heading.setFluentTypography(fluentqt.FontRole.BodyStrong)
layout.addWidget(heading)
files = fluentqt.FileListView(panel)
files.setObjectName("selectedFiles")
files.setAccessibleName("Selected files")
files.setBackgroundVisible(False)
files.setBorderVisible(False)
files.setProperty("fluentPreserveParentSurface", True)
files.viewport().setProperty("fluentPreserveParentSurface", True)
files.setMinimumHeight(260)
files.setModel(model)
layout.addWidget(files)
files.removeRequested.connect(lambda index: model.removeRow(index.row()))
def accept_file(path):
file = QFileInfo(path)
if not file.isFile():
return
type_allowed = file.suffix().lower() in ("pdf", "png", "jpg", "jpeg", "zip")
size_allowed = file.size() <= 20 * 1024 * 1024
if not type_allowed or not size_allowed:
reason = "Choose a file under 20 MB."
if not type_allowed:
reason = "This file type is not supported."
drop.setErrorMessage(file.fileName() + " · " + reason)
add_file(file.fileName(), reason, states.Rejected, 0.0)
return
drop.clearError()
detail = f"{file.size() / (1024 * 1024):.1f} MB · Ready to use"
add_file(file.fileName(), detail, states.Ready, 1.0)
def dropped(urls):
for url in urls:
accept_file(url.toLocalFile())
def browse():
dialog = QFileDialog(panel, "Choose files")
dialog.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
dialog.setFileMode(QFileDialog.FileMode.ExistingFiles)
dialog.setNameFilter("Documents (*.pdf *.png *.jpg *.jpeg *.zip)")
dialog.filesSelected.connect(
lambda paths: [accept_file(path) for path in paths]
)
dialog.open()
panel._file_dialog = dialog
drop.filesDropped.connect(dropped)
drop.browseRequested.connect(browse)API
ОбъявлениеНет подходящих элементов API.
fluent::basicinput::FileDropZone
Наследует QWidget · FluentElement · QMLPlus
Область сброса локальных файлов с кнопкой открытия диалога выбора файлов приложения. Принимает только локальные файлы (перетаскивания с удалёнными URL игнорируются); файловые диалоги и ввод-вывод обрабатываются приложением.
Конструкторы
Методы
QString hintText() constНеобязательный текст подсказки о формате или ограничении размера.
void setHintText(const QString& text)Необязательный текст подсказки о формате или ограничении размера.
QString errorMessage() constТекст ошибки проверки, временно заменяющий описание до его очистки. Последующие перетаскивания не очищают его автоматически.
void setErrorMessage(const QString& message)Текст ошибки проверки, временно заменяющий описание до его очистки. Последующие перетаскивания не очищают его автоматически.
Свойства
QString title- Чтение
title()ЗаписьsetTitle()УведомлениеtitleChanged() QString description- Чтение
description()ЗаписьsetDescription()УведомлениеdescriptionChanged() QString hintTextНеобязательный текст подсказки о формате или ограничении размера.
ЧтениеhintText()ЗаписьsetHintText()УведомлениеhintTextChanged()QString browseText- Чтение
browseText()ЗаписьsetBrowseText()УведомлениеbrowseTextChanged() QString errorMessageТекст ошибки проверки, временно заменяющий описание до его очистки. Последующие перетаскивания не очищают его автоматически.
ЧтениеerrorMessage()ЗаписьsetErrorMessage()УведомлениеerrorMessageChanged()bool dragActive- Чтение
isDragActive()УведомлениеdragActiveChanged()
Сигналы
void hintTextChanged(const QString& text)Необязательный текст подсказки о формате или ограничении размера.
void errorMessageChanged(const QString& message)Текст ошибки проверки, временно заменяющий описание до его очистки. Последующие перетаскивания не очищают его автоматически.
void browseRequested()Запрашивает предоставленный приложением диалог выбора файлов.
void filesDropped(const QList<QUrl>& urls)Испускается со списком URL сброшенных локальных файлов в их исходном порядке.
Защищённые члены
Методы
Унаследовано от fluent::FluentElement
Перечисления
enum ThemeГлобальная визуальная тема, используемая при разрешении дизайн-токенов.
Light = 0Dark = 1HighContrast = 2
Методы
static void setTheme(Theme theme)Обновляет глобальную тему и уведомляет активные экземпляры FluentElement.
static void setThemeDeferred(Theme theme)Планирует пакетное обновление темы с приоритетом видимых элементов без блокировки текущего взаимодействия.
static Theme currentTheme()Возвращает текущую активную глобальную тему.
static bool themeUsesDarkAppearance(Theme theme)Возвращает, использует ли тема токены тёмного оформления и материалов.
static void refreshTheme()Повторно рассылает текущую тему для перерисовки после изменения дизайн-токенов.
static int themeGeneration()Монотонный счётчик, увеличиваемый при каждом изменении темы для проверки актуальности.
Theme effectiveTheme() constОпределяет тему, используемую этим элементом, с учётом унаследованного переопределения QWidget.
bool effectiveThemeUsesDarkAppearance() constВозвращает, использует ли действующая тема этого элемента тёмную основу оформления.
bool setThemeOverrides(const QJsonObject& overrides)Заменяет разреженные переопределения токенов цвета, скругления и шрифта этого элемента.
QJsonObject themeOverrides() constВозвращает заданные переопределения этого элемента.
void clearThemeOverrides()Восстанавливает для всех полей токенов значения глобальной темы по умолчанию.
const Colors& themeColorsRef() constДоступ без копирования к активному набору цветов для горячих путей отрисовки.
Material::AcrylicToken themeAcrylic() constТокены материалов, возвышения и адаптивной компоновки.
QColor themeBackdrop(bool active) constЦвет фона рамки окна для заданного состояния активации.
virtual void onThemeUpdated()Вызывается после изменения глобальной темы.
Типы и псевдонимы
struct ColorsСнимки дизайн-токенов, возвращаемые компонентам.
Унаследовано от fluent::QMLPlus
Методы
AnchorLayout::Anchors* anchors()Возвращает изменяемые привязки для хоста QWidget.
void setState(const QString& name)Применяет зарегистрированное состояние по имени или восстанавливает состояние по умолчанию, если @p name пусто. Неизвестные имена игнорируются, а при выходе из состояния возобновляются прежние привязки.
void addState(const QMLState& state)Регистрирует или заменяет именованное определение состояния; замена активного состояния применяется немедленно.
void evaluateStates()Повторно вычисляет условия состояний в порядке регистрации и активирует первое совпадение или состояние по умолчанию, если совпадений нет. Также выполняется автоматически при уведомлениях свойств-зависимостей; производные состояния с extend наследуют изменения предков, если нет циклов или пропусков.
QMLPlusRuntime* runtime()Возвращает лениво создаваемый наблюдатель состояния, принадлежащий этому хосту.
void setAnchors(const AnchorLayout::Anchors& anchors)Заменяет все привязки хоста и инвалидирует родительскую компоновку.
void resetAnchors()Очищает все привязки хоста и делает родительский макет недействительным.
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)Связывает @p sourceProp объекта @p source со свойством @p targetProp этого хоста QWidget через PropertyBinder::bind().
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Устанавливает управляемую прямую привязку на этом хосте QWidget.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Устанавливает C++-выражение с явными зависимостями на этом хосте QWidget.
void addTransition(const StateTransition& transition)Регистрирует переход состояния в порядке приоритета.
void setBehavior(const char* propertyName, const PropertyAnimation& animation)Задаёт анимацию по умолчанию при записи @p propertyName через writeProperty() или привязку. Явные правила StateTransition имеют приоритет; прямые вызовы C++ сеттеров не анимируются.
void clearBehavior(const char* propertyName)Удаляет анимацию по умолчанию для последующих управляемых записей.
bool writeProperty(const char* propertyName, const QVariant& value)Записывает свойство хоста через Behavior без удаления его привязки.
Документация базового класса Qt: QWidget