ステータスと情報
SplashScreen スプラッシュスクリーン
アプリの起動中にコンテンツ領域を覆い、アイコンや読み込み進捗を表示して、準備完了後に閉じます。
サンプル
プロパティプレビューを読み込めませんでした。もう一度「プロパティプレビュー」を選択して再試行してください。

使い方
アプリケーションの起動
既定は Branded のライト表示です。Simple を選ぶと中央に読み込みリングが表示され、トランジションの再再生や読み込み完了後の dismiss() による非表示化も行えます。
#include <FluentQt/StatusInfo.h>
using namespace fluent::status_info;
auto* root = new QWidget(this);
auto* layout = new QVBoxLayout(root);
layout->setContentsMargins(0, 0, 0, 0);
layout->setSpacing(12);
const QIcon appIcon(":/app/assets/app-icon.png");
auto* host = new fluent::layout::Card(root);
host->setObjectName("splashPreviewHost");
host->setAppearance(fluent::layout::Card::Canvas);
host->setBorderVisible(false);
host->setFixedHeight(400);
auto* contentLayout = new QVBoxLayout(host);
contentLayout->setContentsMargins(24, 24, 24, 24);
auto* header = new QHBoxLayout;
auto* logo = new Label(host);
logo->setObjectName("splashDestinationIcon");
logo->setFixedSize(28, 28);
header->addWidget(logo);
header->addWidget(new Label("FluentQt Gallery", host));
contentLayout->addLayout(header);
contentLayout->addStretch();
auto* splash = new SplashScreen(host);
splash->setObjectName("sampleSplash");
splash->setIcon(appIcon);
splash->setTitle("FluentQt");
splash->setSubtitle("Small details. Fluent experiences.");
splash->setText("Starting FluentQt Gallery");
splash->setTransitionTarget(logo);
QObject::connect(splash, &SplashScreen::dismissed, logo,
[logo, appIcon]() { logo->setPixmap(appIcon.pixmap(28, 28)); });
splash->show();
// Demo timing only; applications report actual work and call dismiss when ready.
auto* loading = new QVariantAnimation(splash);
loading->setObjectName("sampleSplashLoading");
loading->setDuration(3600);
loading->setStartValue(0);
loading->setEndValue(120);
QObject::connect(loading, &QVariantAnimation::valueChanged, splash, [splash](const QVariant& value) {
const int step = value.toInt();
splash->setProgress(qMax(0, step - 20), 100);
splash->setIndeterminate(step < 20);
splash->setText(step < 100 ? "Loading resources" : "Opening Gallery");
});
QObject::connect(loading, &QVariantAnimation::finished, splash, &SplashScreen::dismiss);
auto restart = [splash, loading, logo]() {
loading->stop();
splash->hide();
logo->clear();
splash->setIndeterminate(true);
splash->show();
loading->start();
};
auto* presentation = new fluent::basicinput::ComboBox(root);
presentation->setObjectName("splashPresentation");
presentation->setAccessibleName("Splash presentation");
presentation->addItems({"Branded", "Simple"});
QObject::connect(presentation, QOverload<int>::of(&QComboBox::currentIndexChanged), splash,
[splash, restart](int index) {
splash->setPresentation(index == 0 ? SplashScreen::Presentation::Branded
: SplashScreen::Presentation::Simple);
restart();
});
auto* replay = new Button("Replay startup", root);
replay->setObjectName("replaySplashButton");
replay->setFluentStyle(Button::ButtonStyle::Accent);
QObject::connect(replay, &Button::clicked, splash, restart);
auto* controls = new QHBoxLayout;
controls->addWidget(presentation);
controls->addStretch();
controls->addWidget(replay);
layout->addWidget(host);
layout->addLayout(controls);import fluentqt
from PySide6.QtCore import QVariantAnimation
from PySide6.QtGui import QIcon
from PySide6.QtWidgets import QHBoxLayout, QVBoxLayout
from importlib.resources import files
# Gallery-only preview drawing/model helpers are omitted.
root = SplashScreenSampleSurface()
layout = QVBoxLayout(root)
layout.setContentsMargins(0, 0, 0, 0)
layout.setSpacing(12)
app_icon = QIcon(str(files("fluentqt_gallery") / "assets" / "app-icon.png"))
host = fluentqt.Card(root)
host.setObjectName("splashPreviewHost")
host.setAppearance(fluentqt.Card.Appearance.Canvas)
host.setBorderVisible(False)
host.setFixedHeight(400)
content_layout = QVBoxLayout(host)
content_layout.setContentsMargins(24, 24, 24, 24)
header = QHBoxLayout()
logo = fluentqt.Label(host)
logo.setObjectName("splashDestinationIcon")
logo.setFixedSize(28, 28)
header.addWidget(logo)
header.addWidget(fluentqt.Label("FluentQt Gallery", host))
content_layout.addLayout(header)
content_layout.addStretch()
splash = fluentqt.SplashScreen(host)
splash.setObjectName("sampleSplash")
splash.setIcon(app_icon)
splash.setTitle("FluentQt")
splash.setSubtitle("Small details. Fluent experiences.")
splash.setText("Starting FluentQt Gallery")
splash.setTransitionTarget(logo)
splash.dismissed.connect(lambda: logo.setPixmap(app_icon.pixmap(28, 28)))
splash.show()
# Demo timing only; applications report actual work and call dismiss when ready.
loading = QVariantAnimation(splash)
loading.setObjectName("sampleSplashLoading")
loading.setDuration(3600)
loading.setStartValue(0)
loading.setEndValue(120)
def update_progress(value):
splash.setProgress(max(0, int(value) - 20), 100)
splash.setIndeterminate(value < 20)
splash.setText("Loading resources" if value < 100 else "Opening Gallery")
loading.valueChanged.connect(update_progress)
loading.finished.connect(splash.dismiss)
def replay_startup():
loading.stop()
splash.hide()
logo.clear()
splash.setIndeterminate(True)
splash.show()
loading.start()
presentation = fluentqt.ComboBox(root)
presentation.setObjectName("splashPresentation")
presentation.setAccessibleName("Splash presentation")
presentation.addItems(["Branded", "Simple"])
def change_presentation(index):
mode = fluentqt.SplashScreen.Presentation
splash.setPresentation(mode(index))
replay_startup()
presentation.currentIndexChanged.connect(change_presentation)
replay = fluentqt.Button("Replay startup", root)
replay.setObjectName("replaySplashButton")
replay.setFluentStyle(fluentqt.Button.ButtonStyle.Accent)
replay.clicked.connect(replay_startup)
controls = QHBoxLayout()
controls.addWidget(presentation)
controls.addStretch()
controls.addWidget(replay)
layout.addWidget(host)
layout.addLayout(controls)API
宣言を表示一致する API メンバーはありません。
fluent::status_info::SplashScreen
継承元 QWidget · FluentElement · QMLPlus
アイコンと読み込み進捗を表示しながら親ウィジェットを覆う、再利用可能な起動オーバーレイです。覆われた領域内の入力のみをブロックし、dismiss() は自身を削除せずに非表示にして dismissed() を送出します。
コンストラクタ
デストラクタ
列挙型
enum class PresentationBranded は既定のライトリビール演出を使用し、Simple は中央の読み込みリングのみを表示します。
BrandedSimple
メソッド
void setPresentation(Presentation presentation)起動時の表示スタイルを選択します(未知の列挙値は無視されます)。
void setIconSize(const QSize& size)アートワークの推奨サイズを設定します。各辺は少なくとも 1 論理ピクセルになります。
void setText(const QString& text)プレーンなステータステキストを設定します。長いテキストは表示上省略されますが、アクセシビリティでは全文を読み取れます。
void setTitle(const QString& title)Branded 表示で表示される任意のプレーンテキストのブランドタイトルを設定します。
void setSubtitle(const QString& subtitle)ブランドタイトルの下に表示される任意のプレーンテキストのサブタイトルを設定します。
void setTransitionTarget(QWidget* target)Branded 終了時にアイコンが飛び込む先のターゲットウィジェットを設定します。Full モーション時、ターゲットが同じウィンドウ内で表示されていれば滑らかにアニメーションし、それ以外の場合はフェードアウトします。
void setProgress(int done, int total)確定進捗を設定します(0–100% にクランプされます)。total <= 0 の場合は不確定モードに切り替わります。100% に達しても自動では閉じないため、起動完了時に dismiss() を呼び出してください。
void dismiss()閉じるトランジションを実行してスプラッシュ画面を非表示にし、dismissed() を 1 回送出します。すでに非表示または閉じる処理中の場合は無視されます。再利用するには再度 show() を呼び出します。
プロパティ
Presentation presentation- 読み取り
presentation()書き込みsetPresentation()通知シグナルpresentationChanged() QIcon icon- 読み取り
icon()書き込みsetIcon()通知シグナルiconChanged() QSize iconSize- 読み取り
iconSize()書き込みsetIconSize()通知シグナルiconSizeChanged() QString text- 読み取り
text()書き込みsetText()通知シグナルtextChanged() QString title- 読み取り
title()書き込みsetTitle()通知シグナルtitleChanged() QString subtitle- 読み取り
subtitle()書き込みsetSubtitle()通知シグナルsubtitleChanged() QWidget* transitionTarget- 読み取り
transitionTarget()書き込みsetTransitionTarget()通知シグナルtransitionTargetChanged() int progress- 読み取り
progress()通知シグナルprogressChanged() bool indeterminate- 読み取り
isIndeterminate()書き込みsetIndeterminate()通知シグナルindeterminateChanged()
シグナル
void replaced()重なり合う別の SplashScreen がこのインスタンスを置き換えて非表示にしたときに送出されます。dismissed() は送出されず、直接の hide() 呼び出しやウィンドウ最小化では replaced() は送出されません。
protected メンバー
メソッド
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指定されたアクティブ状態に対するウィンドウ chrome の背景色。
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)PropertyBinder::bind() を介して、@p source の @p sourceProp をこの QWidget ホストの @p targetProp にバインドします。
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 = {})この QWidget ホストに明示的依存関係を持つ C++ 式を設定します。
void addTransition(const StateTransition& transition)優先順位順に状態遷移を登録します。
void setBehavior(const char* propertyName, const PropertyAnimation& animation)writeProperty() またはバインディング経由で @p propertyName が書き込まれた際に使用されるデフォルトアニメーションを設定します。明示的な StateTransition ルールが優先され、C++ のセッターを直接呼び出した場合はアニメーションしません。
void clearBehavior(const char* propertyName)今後のマネージド書き込みに使用するデフォルトアニメーションを削除します。
bool writeProperty(const char* propertyName, const QVariant& value)バインディングを削除せずに Behavior 経由でホストプロパティに書き込みます。
Qt 基底クラスドキュメント:QWidget