ステータスと情報
Shimmer シマー
コンテンツの読み込み中にスケルトンプレースホルダーを表示します。
サンプル
プロパティプレビューを読み込めませんでした。もう一度「プロパティプレビュー」を選択して再試行してください。

使い方
組み込みテンプレート
setShimmerTemplate() で画像カード、アバター行、テキストブロックなどの組み込みテンプレートを選択できます。
#include <FluentQt/StatusInfo.h>
using namespace fluent::status_info;
auto* image = new Shimmer(this);
image->setShimmerTemplate(Shimmer::ShimmerTemplate::ImageCard);
image->setFixedSize(136, 84);
auto* row = new Shimmer(this);
row->setShimmerTemplate(Shimmer::ShimmerTemplate::AvatarTextRow);
row->setFixedSize(168, 56);
auto* text = new Shimmer(this);
text->setShimmerTemplate(Shimmer::ShimmerTemplate::TextBlock);
text->setFixedSize(176, 72);import fluentqt
image = fluentqt.Shimmer()
image.setShimmerTemplate(fluentqt.Shimmer.ShimmerTemplate.ImageCard)
image.setFixedSize(136, 84)
avatar_row = fluentqt.Shimmer()
avatar_row.setShimmerTemplate(fluentqt.Shimmer.ShimmerTemplate.AvatarTextRow)
avatar_row.setFixedSize(168, 56)
text = fluentqt.Shimmer()
text.setShimmerTemplate(fluentqt.Shimmer.ShimmerTemplate.TextBlock)
text.setFixedSize(176, 72)API
宣言を表示一致する API メンバーはありません。
fluent::status_info::Shimmer
継承元 QWidget · FluentElement · QMLPlus
シマーアニメーション付きの Fluent スケルトン読み込みプレースホルダー。
コンストラクタ
デストラクタ
列挙型
enum class ShimmerTemplateCustomImageCardAvatarTextRowTextBlock
メソッド
bool isActive() constローディングスケルトンがアクティブかどうか。
void setActive(bool active)ローディングスケルトンがアクティブかどうか。
bool isAnimationEnabled() constシマーモーションを有効にするかどうか。
void setAnimationEnabled(bool enabled)シマーモーションを有効にするかどうか。
qreal shimmerProgress() const現在の正規化された shimmer アニメーション進捗。
void setShimmerProgress(qreal progress)現在の正規化された shimmer アニメーション進捗。
int cycleDuration() constシマーの 1 サイクル全体の長さ(ミリ秒)。
void setCycleDuration(int durationMs)シマーの 1 サイクル全体の長さ(ミリ秒)。
ShimmerTemplate shimmerTemplate() constカスタム要素が指定されない場合に使用される組み込み要素テンプレート。
void setShimmerTemplate(ShimmerTemplate templateKind)カスタム要素が指定されない場合に使用される組み込み要素テンプレート。
プロパティ
bool activeローディングスケルトンがアクティブかどうか。
読み取りisActive()書き込みsetActive()通知シグナルactiveChanged()bool animationEnabledシマーモーションを有効にするかどうか。
読み取りisAnimationEnabled()書き込みsetAnimationEnabled()通知シグナルanimationEnabledChanged()qreal shimmerProgress現在の正規化された shimmer アニメーション進捗。
読み取りshimmerProgress()書き込みsetShimmerProgress()通知シグナルshimmerProgressChanged()int cycleDurationシマーの 1 サイクル全体の長さ(ミリ秒)。
読み取りcycleDuration()書き込みsetCycleDuration()通知シグナルcycleDurationChanged()ShimmerTemplate shimmerTemplateカスタム要素が指定されない場合に使用される組み込み要素テンプレート。
読み取りshimmerTemplate()書き込みsetShimmerTemplate()通知シグナルshimmerTemplateChanged()
シグナル
void activeChanged(bool active)ローディングスケルトンがアクティブかどうか。
void animationEnabledChanged(bool enabled)シマーモーションを有効にするかどうか。
void shimmerProgressChanged(qreal progress)現在の正規化された shimmer アニメーション進捗。
void cycleDurationChanged(int durationMs)シマーの 1 サイクル全体の長さ(ミリ秒)。
void shimmerTemplateChanged(ShimmerTemplate templateKind)カスタム要素が指定されない場合に使用される組み込み要素テンプレート。
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
fluent::status_info::ShimmerPainter
Fluent スケルトン読み込みプレースホルダー用の描画ヘルパー。
列挙型
enum class Shapeスケルトン要素で使用される形状です。
RectangleRoundedRectCircleLine
メソッド
static Palette paletteFromTheme(const fluent::FluentElement::Colors& colors, bool enabled = true)Fluent テーマカラーから shimmer パレットを解決します。
static void paint(QPainter* painter, const QVector<Element>& elements, const Palette& palette, qreal progress, bool animated = true)正規化されたアニメーション進行度を使用して shimmer 要素を描画します。
static QVector<Element> imageCardElements(const QRectF& bounds, qreal radius = 4.0)単一の画像・カードプレースホルダー用のスケルトンテンプレート。
static QVector<Element> avatarTextRowElements(const QRectF& bounds)アバターとテキスト行の組み合わせ用スケルトンテンプレート。
static QVector<Element> textBlockElements(const QRectF& bounds, int lineCount = 3)複数行テキストブロック用のスケルトンテンプレート。
型とエイリアス
struct Paletteシマー描画で使用されるテーマ解決済みの色です。
struct Elementローカルターゲット座標における 1 つのスケルトン形状。
fluent::status_info::ShimmerPainter::Palette
シマー描画で使用されるテーマ解決済みの色です。
フィールド
fluent::status_info::ShimmerPainter::Element
ローカルターゲット座標における 1 つのスケルトン形状。