Fluent-Qt

プロジェクト更新

リリースと移行ガイド

UILib および Gallery のアップデートと移行要件をバージョン別にまとめています。

1.12.1

最新

コンポーネントライブラリ UILib

PropertyPanel は行が表示範囲に近づくとエディターを作成します。AreaChart はポインターの移動中に塗りつぶしを再利用します。

Gallery サンプルアプリ

What’s new ダイアログをスクロールしても区切り線から背景が透けなくなりました。写真のサンプルは必要に応じて画像を読み込みます。

プロジェクトノート

ウェブサイト、コンポーネントの API リファレンス、対話型のプロパティエディターを9言語で利用できます。

1.12.0

コンポーネントライブラリ UILib

ボタンのアイコンとラベルの上下配置、ツリービューの列ヘッダー表示、および最大化ウィンドウの正しいモニターへの復元に対応しました。

  • Button::IconAbove または Button::IconBelow を使用すると、アイコンをラベルの上または下に配置できます。
  • TreeView が表示されている列ヘッダー用の余白を確保するようになりました。キャプションと列ヘッダーが非表示のときは、headerlessTopInset で先頭行上部の間隔を調整できます。
  • Windows で最大化された Window を復元する際、移動先モニターの作業領域を使用するようになりました。

Gallery サンプルアプリ

リリースノートをオフラインで閲覧できるほか、ツリービューの列ヘッダーサンプルもお試しいただけます。

  • タイトルバーの What’s new から Gallery に同梱された更新履歴を開けます。ウィンドウ幅が狭い場合は、メガホンアイコンから開けます。
  • TreeView のサンプルで、モデルのヘッダーが先頭行の上にどのように表示されるかを確認できます。

プロジェクトノート

99 個のコンポーネントドキュメントページでライブ Qt サンプルを編集し、生成された C++ または PySide6 コードをコピーできます。

1.11.4

コンポーネントライブラリ UILib

診断レポート、Windows 11 Snap Layouts、および共通のテキストフィールド枠線設定を追加しました。

  • DiagnosticSession は、直近の UI イベントとウィジェットのスナップショットをインメモリの ZIP アーカイブに記録します。
  • サイズ変更可能な Window の最大化ボタンにカーソルを合わせると、Windows 11 Snap Layouts を使用できます。
  • テキスト入力欄で LineEdit の枠線設定を共有するようになりました。非フォーカス時の下線幅のデフォルトは 0 となり、枠線幅が 0 のときに極細線が残らなくなりました。
  • Toast のアクションウィジェットの所有権と、狭いウィンドウでのレイアウトを修正しました。

Gallery サンプルアプリ

直近の診断ログをまとめた ZIP を使って Gallery の不具合を報告できます。

  • Settings の横にある「Report a problem」を選択すると、該当するローカルのクラッシュレポートを含む診断用 ZIP がコピーされます。通知の「Open GitHub issue」を選択し、ファイルを貼り付けてください。
  • Web 版 Gallery では ZIP ファイルがダウンロードされるため、レポートに添付できます。

プロジェクトノート

Web サイトのリリース履歴で UILib と Gallery の更新が分かれ、スコープフィルターや固定のバージョン・移行ガイドリンクに対応しました。

1.11.3

コンポーネントライブラリ UILib

Transfer、LineEdit と ComboBox の単位サフィックスおよび末尾ウィジェット、TextEdit のキャレット位置取得を追加し、編集可能フィールドのレイアウトを修正しました。

  • LineEdit と ComboBox で、px などの単位サフィックス(編集テキストとは分離して保持)の表示や、末尾へのカスタムウィジェットの配置が可能になりました。
  • Transfer は安定したキーを用いて検索可能な 2 つのリスト間で項目を移動し、無効な項目をスキップします。
  • TextEdit がインライン補完ポップアップの位置決めのために、キャレット矩形と変更シグナルを公開するようになりました。
  • 編集可能な ComboBox で選択変更やモデル更新後にテキスト領域がずれる不具合と、各表示倍率における NumberBox のドラッグアイコンの中央揃えを修正しました。

Gallery サンプルアプリ

インラインの @ メンバー補完サンプルを追加し、古い Qt バージョンでのリダイレクトクリッピングを修正しました。

  • TextEdit のメンバー補完サンプルで @ を入力し、矢印キーで名前を選ぶと、エディターを離れずにそのまま挿入できます。

1.11.2

コンポーネントライブラリ UILib

合成された offscreen および minimal ウィンドウ ID に対して、ネイティブの Win32 スタイルや背景の呼び出しをスキップします。

Gallery サンプルアプリ

C++ および PySide6 の CheckBox サンプルに無効状態を追加しました。

1.11.1

コンポーネントライブラリ UILib

RangeSlider と ImageViewer を追加し、テキスト配置、オーバーレイ、および小数倍率での描画を修正しました。

  • RangeSlider は最小間隔、キーボードステップ、値ツールチップ、アクセシブルなデュアルつまみを備え、下限値と上限値を選択できます。
  • ImageViewer にポインター中心のズーム、パン、フィットモード、ピンチおよびキーボード操作、サムネイルキャッシュを追加し、FlipView 内でも動作するようになりました。
  • 小数倍率および 100% 未満のスケールでの描画乱れを部分領域の再描画で修正し、GPU のみのフレームでウィンドウ全体のウィジェット再描画を回避するようにしました。
  • コンパクトコントロールのテキスト配置、メニューアイコンのインセット、SelectorBar のオーバーフロー時のフォーカス、およびポップアップ背景のキャプチャを修正しました。

Gallery サンプルアプリ

移行が必要

50%〜200% のインターフェースズーム設定を保存でき、コンポーネントやサンプルの検索結果をページング表示します。ソースビルドには対応する Qt プライベートヘッダーが必要です。

1.11.0

コンポーネントライブラリ UILib

移行が必要

パーティクルエフェクトをオプションの FluentQt::Particles に分離し、FontIcon にカスタムアイコンフォントを追加し、安定 ABI 対応の Python wheel を提供します。

  • FontIcon にカスタムアイコンフォント用の fontFamily() と setFontFamily() を追加しました。グリフの Unicode 文字を直接渡すか、フォントファミリーを空のままにして同梱の Fluent アイコンを使用できます。
  • パーティクルエフェクトがコアライブラリからオプションの FluentQt::Particles ターゲット(Python では fluentqt.particles)に移動しました。
  • デスクトップ版の Debug ビルドは、デフォルトで Release 版の Qt ランタイムにリンクします。Debug 版 Qt ライブラリにリンクするには、FLUENT_QT_DEBUG_RELEASE_RUNTIME=OFF を設定してください。
  • 表示中のオーバーレイがホストサーフェスの移動に追従し、スクロールバーのつまみとヒットテスト領域が一致するようになり、Python wheel が CPython 安定 ABI(abi3)に対応しました。

ParticleBackdrop が Particles モジュールへ移動

fluent::layout::ParticleBackdrop と fluentqt.layout.ParticleBackdrop は削除されました。FluentQt::FluentQt のみをリンクしてもパーティクルエフェクトは含まれなくなります。

ソースビルドでは FLUENT_QT_BUILD_PARTICLES を有効にするか、COMPONENTS Particles を指定して FluentQt::Particles をリンクし、インクルード、名前空間、インポートを更新してください。

変更前
FluentQt::FluentQt
#include <FluentQt/Layout.h>
fluent::layout::ParticleBackdrop
from fluentqt.layout import ParticleBackdrop
変更後
find_package(FluentQt CONFIG REQUIRED COMPONENTS Particles)
target_link_libraries(app PRIVATE FluentQt::Particles)
#include <FluentQt/Particles.h>
fluent::particles::ParticleBackdrop
from fluentqt.particles import ParticleBackdrop

導入コミット b674c94

Gallery サンプルアプリ

3D Gallery では変更されたテクスチャ行のみをアップロードし、動作が落ち着くと鮮明な描画を復元します。また、テクスチャキャッシュのメモリ量を制限し、フレームレート低下が続く場合は 2D へフォールバックします。

1.10.3

コンポーネントライブラリ UILib

数値・プロパティ編集、チャートのエクスポート、および新しい選択コントロールを追加しました。

  • NumberBox の値は入力だけでなくドラッグでも変更でき、ドラッグのキャンセルも可能です。PropertyPanel ではフィールドのグループ化、名前による検索、デフォルト値へのリセットが行えます。
  • チャートを PNG として保存したり、表示範囲または全データのソース行を CSV としてエクスポートしたりできます。
  • AutoSuggestBox が非同期の候補を受け取り、古い候補を破棄するようになりました。また、安定した ID を持つタグ用の TagInput と、ツリーモデルから選択する TreeSelect を新設しました。
  • DataGrid で列の固定が可能になり、DataGridToolBar に検索、フィルター、列コントロールを追加しました。

プロジェクトノート

Web サイトの各コンポーネントページでは、ライブサンプル、C++ と PySide6 のコード、公開 API を英語と中国語で表示します。

1.10.2

コンポーネントライブラリ UILib

CommandPalette、FormController、CodeBlock を追加しました。Popup、Dialog、DrawerView で背景のぼかしと減光オプションが共通化され、モーダルサーフェスは背後のクリックやショートカットをブロックします。

1.10.1

コンポーネントライブラリ UILib

CommandBar と CommandBarFlyout で、ネストされた FluentMenu サブメニューを持つアクションに対応しました。TextEdit::appendPlainText() により、選択範囲や元に戻す履歴を失わずにログ行を追記できます。未選択のチェックボックスとラジオボタンの輪郭もより鮮明になりました。

1.10.0

コンポーネントライブラリ UILib

DateTimeRangePicker、Widgets ウィンドウ内で QML ページをホストする QmlBridge、および拡張機能の依存関係・有効化・クリーンアップを管理するオプションの Plugins モジュールを追加しました。

Gallery サンプルアプリ

Python Live Scene が同じウィンドウ内でプレビューを再読み込みするようになりました。

1.9.3

コンポーネントライブラリ UILib

起動時およびマテリアル変更時のウィンドウ背景を修正しました。ダークモードで新しいウィンドウが白くちらつかなくなり、Mica や Acrylic から切り替える際も新しい背景が描画されるまで元のマテリアルを保持します。

1.9.1

コンポーネントライブラリ UILib

1.9.0 で含まれていなかったオプションの Spatial モジュールを Python wheel に追加しました。

Gallery サンプルアプリ

パッケージ版 3D Gallery は Windows ARM64 で Direct3D 11 を使用し、ハードウェアアクセラレーションが利用できない場合は 2D にフォールバックします。

  • 1.9.0 の wheel には Spatial が含まれていませんでした。3D Gallery を利用するには、FluentQt と FluentQt-Gallery の両方を 1.9.1 にアップグレードしてください。

1.9.0

コンポーネントライブラリ UILib

オプションの Spatial モジュールを追加しました。SpatialView は通常のウィジェットを透視投影の 3D サーフェス上に配置でき、既存の入力処理やシグナルもそのまま動作します。

Gallery サンプルアプリ

デスクトップ版およびブラウザ版の Gallery に 3D モードを追加しました。

1.8.5

コンポーネントライブラリ UILib

Qt Charts に依存せず Qt Widgets で描画する Charts モジュール(折れ線、面、棒、円、ドーナツ、散布図、スパークライン)と、FileDropZone・FileListView を追加しました。Toast は新しいカードスタイルになり、閉じるボタンもオプションで表示できます。

1.8.4

コンポーネントライブラリ UILib

SplashScreen の表示アニメーション中の再描画回数を削減しました。

Gallery サンプルアプリ

アプリアイコン、インストーラーの画像、および Web サイトのスクリーンショットを更新しました。

1.8.3

コンポーネントライブラリ UILib

CPU 描画のパーティクル背景である ParticleBackdrop と、再利用可能な SplashScreen を追加しました。キーボード選択とテキスト編集の不具合も修正しました。

Gallery サンプルアプリ

サンプルのソースコードが読みやすく、コピーしやすくなりました。

1.8.2

コンポーネントライブラリ UILib

UserTheme::applyOverrides() でアプリ全体の色、角丸、フォントを変更でき、setThemeOverrides() で単一コンポーネントに対しても同様の変更が行えます。ComboBox のドロップダウンでもカスタムフォントが使用されるようになり、対応 Qt バージョンにおけるコールバック、ナビゲーション、スライダーの不具合も修正しました。

1.8.1

コンポーネントライブラリ UILib

ToggleSwitch::visualScale を追加しました。コレクションビューの入力シグナル、行削除後の FlowView レイアウト、およびウィジェットを削除する NumberBox コールバックの不具合を修正しました。

1.8.0

コンポーネントライブラリ UILib

HighContrast テーマとアプリ全体の MotionPolicy モード(Full、Reduced、Disabled)を追加しました。フォーカス中の TextEdit では、自動高さ変更がアニメーションします。

Gallery サンプルアプリ

C++、PySide6、およびブラウザ版の Gallery にハイコントラストとモーション設定を追加しました。

1.7.5

コンポーネントライブラリ UILib

ボタン、トグルスイッチ、日時ピッカーで fontRole ルールが共通化され、明示的な setFont() の呼び出しが引き続き優先されます。build-fluentqt-gui Skill はプロジェクト分析から独立レビューまでを網羅します。

Gallery サンプルアプリ

C++、PySide6、WebAssembly 間でサンプルの挙動を統一しました。

1.7.4

コンポーネントライブラリ UILib

メニューのアニメーション中もアクセスキーが機能し続けます。

Gallery サンプルアプリ

ネイティブプレビューでキャプチャ前にポインター操作とキーボード操作をリプレイし、ウィジェットのジオメトリ情報と Inspector の検出結果を出力できるようになりました。

1.7.3

コンポーネントライブラリ UILib

CalendarView の選択枠が角丸になり、ピッカーのフライアウトが入力欄に揃い、TeachingTip の影が均等に広がるようになりました。

Gallery サンプルアプリ

Live Scene は PySide6 プレビューウィンドウを開いたまま保持し、保存時に自動で更新します。

1.7.2

コンポーネントライブラリ UILib

MultiSelectComboBox と、ローカルの Qt 環境を確認して C++ または PySide6 のスタータープロジェクトを生成する fluentqt doctor、create、trial コマンドを追加しました。また、各プラットフォームにおけるピッカーやリストの不具合も修正しました。

1.7.0

コンポーネントライブラリ UILib

移行が必要

Material および Cupertino デザイン言語を削除し、Fluent のみに統一しました。Field と DataGrid を追加し、すべてのオーバーレイの開閉およびモーダル動作を文書化しました。

デザイン言語とスタイルテーマ API を削除

DesignLanguage、StyleTheme、StyleThemeCatalog はエイリアスを残さず削除されました。Fluent のライトテーマとダークテーマのみを使用しているアプリには影響ありません。

外観は Theme で選択し、トークンは UserTheme でカスタマイズします。Python では current_theme()、apply_user_theme()、set_accent_color()、reset_theme_tokens() を使用してください。Gallery は従来の styleTheme 設定を無視します。

変更前
FluentElement::DesignLanguage
StyleTheme / StyleThemeCatalog
current_design_language()
apply_style_theme()
変更後
FluentElement::Theme
fluent::UserTheme
current_theme()
apply_user_theme()

1.6.4

コンポーネントライブラリ UILib

TextEdit がカスタムのコンテンツ余白を正しく反映するようになりました。build-fluentqt-gui Skill はアプリの規模に応じてチェック項目を調整します。

Gallery サンプルアプリ

ブラウザ版のコードサンプルで、C++ と PySide6 を切り替えられるようになりました。

1.6.3

コンポーネントライブラリ UILib

コーディングエージェント向けの build-fluentqt-gui Skill と、C++ および PySide6 API を Gallery サンプルに対応付けるコンポーネントカタログを同梱しました。ListView にデフォルトデリゲートが追加され、インストール済みパッケージにビルドマシンの SDK パスが埋め込まれなくなりました。

1.6.2

コンポーネントライブラリ UILib

FLUENT_QT_BUILD_WEBASSEMBLY_SUPPORT によるオプトインの WebAssembly サポートを追加しました。

Gallery サンプルアプリ

Web サイトに C++ Gallery を埋め込み、ブラウザ上で利用できるようにしました。

1.6.1

コンポーネントライブラリ UILib

FluentQt の PyPI ページに詳細なパッケージドキュメントとプロジェクトリンクを追加しました。

Gallery サンプルアプリ

FluentQt-Gallery の PyPI ページに詳細なパッケージドキュメントとプロジェクトリンクを追加しました。

1.5.3

コンポーネントライブラリ UILib

ボタンを押した際に下側の境界線が隠れなくなりました。macOS で Qt がトラックパッドイベントを取りこぼした場合、カスタムタイトルバーはネイティブのウィンドウドラッグにフォールバックします。

1.5.2

コンポーネントライブラリ UILib

CommandBar、CommandBarFlyout、および元に戻す・コピー・貼り付けなどの操作を扱う EditingCommandRouter を追加しました。Toast はアクションボタン、ホバー時の一時停止、インプレース更新に対応しました。

1.5.0

コンポーネントライブラリ UILib

移行が必要

<FluentQt/BasicInput.h> などのカテゴリ別ヘッダー、型付けされたフォントロールと選択モード、ホストされたウィジェットの明示的な所有権を追加しました。ピッカーやスイッチのローカライズ済みテキストはアプリケーション側から提供する仕様になりました。

型付きフォントロール、共通の選択モード、明示的な所有権

フォントロールを文字列で渡しているコード、ビュー固有の選択列挙型を使用しているコード、実装ヘッダーをインクルードしているコード、またはホストされたウィジェットの暗黙的所有権に依存しているコードは更新が必要です。

公開ヘッダーのみをインクルードし、API が要求する箇所では WidgetOwnership を渡してください。ピッカーのテキスト、ToggleSwitch のラベル、アクセシビリティ名はアプリケーション側からローカライズして提供します。

変更前
"Body"
FlowSelectionMode / GridSelectionMode
ListSelectionMode / TreeSelectionMode
変更後
Typography::FontRole::Body
fluent::collections::SelectionMode
fluent::WidgetOwnership

1.4.2

コンポーネントライブラリ UILib

AnchorLayout の右・下アンカー、QMLPlus の状態遷移、および QApplication 生成前の同梱リソースへのアクセスを修正しました。TextEdit はフォーカスを正しく転送し、テキストが再設定されても元に戻す履歴を保持します。

1.4.1

コンポーネントライブラリ UILib

最大 300% までの小数倍率でもコントロールが鮮明に描画されます。Dialog と CoachMark は独立したネイティブウィンドウではなく所有元ウィンドウ内のオーバーレイとして開くようになり、macOS で入力が固まる不具合を修正しました。

1.4.0

コンポーネントライブラリ UILib

フォントと Fluent System Icons を同梱し、システムへの Segoe フォントのインストールが不要になりました。

Gallery サンプルアプリ

タイポグラフィ、カラー、アイコン、スペーシングのページを追加し、システムの表示スケールに追従するようにしました。

1.3.2

日付未記録

コンポーネントライブラリ UILib

インストールされたパッケージは、明示的にリストされた公開ヘッダーのみを公開します。

Gallery サンプルアプリ

コンポーネントページにヘッダー、C++ 型、CMake ターゲットが表示されるようになり、ページの切り替えも高速化されました。

1.3.1

日付未記録

コンポーネントライブラリ UILib

ライブラリは Qt Widgets のみに依存します。リリースにはライブラリ本体のみのソースアーカイブも含まれます。

Gallery サンプルアプリ

Gallery には spdlog を残し、パッケージから不要な Qt モジュールを削除しました。

1.3.0

日付未記録

コンポーネントライブラリ UILib

x64 および ARM64 上の Linux(X11 と Wayland)に対応し、Debian パッケージを提供します。Window::setBackdropEffect() により、すべてのプラットフォームで統一された Mica/Acrylic API を利用できます。