コレクション
TreeView ツリービュー
展開可能なノードで階層データを表示するコントロールです。
サンプル
プロパティプレビューを読み込めませんでした。もう一度「プロパティプレビュー」を選択して再試行してください。

使い方
フォルダー階層
setModel() で階層データをバインドします。組み込みの行は展開・折りたたみ、キーボードナビゲーション、選択状態を備えており、カスタムデリゲートを設定してよりリッチな行にすることもできます。列ヘッダーはデフォルトで非表示です。モデルの水平ヘッダーデータを表示するには setHeaderHidden(false) を呼び出し、列のサイズ変更やヘッダーの動作は header() で設定します。setHeaderText() は列の上部に別のキャプションを追加します。外部ヘッダーを使用する場合は、列ヘッダーを非表示にしてキャプションを空にし、外側のレイアウトのスペースをゼロに設定したうえで、setHeaderlessTopInset(0) を呼び出して最初の行の上にあるデフォルトの 2 論理ピクセルを削除します。
#include <FluentQt/Collections.h>
using namespace fluent::collections;
auto* tree = new TreeView(this);
tree->setItemDelegate(new TreeRowDelegate(
themeHost, rowHeight, tree, tree));
tree->setModel(model);
tree->setAccessibleName("Folders");
tree->expandAll();import fluentqt
tree = fluentqt.TreeView()
tree.setAccessibleName('Folders')
tree.setItemDelegate(row_delegate)
tree.setModel(model)
tree.expandAll()API
宣言を表示一致する API メンバーはありません。
fluent::collections::TreeView
継承元 QTreeView · FluentElement · QMLPlus
階層的な選択インジケーターのモーションとチェック状態の同期を備えたツリービューです。QTreeView をベースに、展開/折りたたみのリビールアニメーション、移動する選択ピル、ヘッダー/プレースホルダーテキスト、ドラッグによる並べ替えに対応しています。
コンストラクタ
デストラクタ
列挙型
enum class IndicatorVerticalDirectionNoneUpDown
enum class IndicatorHierarchyTransitionNoneSameLevelInwardOutward
メソッド
SelectionMode selectionMode() constコレクションビューで使用される選択モードです。
void setSelectionMode(SelectionMode mode)コレクションビューで使用される選択モードです。
Typography::FontRole fontRole() constテキスト描画に使用される Fluent タイポグラフィロール。
void setFontRole(Typography::FontRole role)テキスト描画に使用される Fluent タイポグラフィロール。
bool borderVisible() constコントロールの枠線を描画するかどうか。
void setBorderVisible(bool visible)コントロールの枠線を描画するかどうか。
bool backgroundVisible() constコントロールの背景を描画するかどうか。
void setBackgroundVisible(bool visible)コントロールの背景を描画するかどうか。
QString headerText() const列ヘッダーと行の上に表示するオプションのキャプション。列ヘッダーは既定で非表示のため、モデルのヘッダーデータを表示するには setHeaderHidden(false) を使用します。
void setHeaderText(const QString& text)列ヘッダーと行の上に表示するオプションのキャプション。列ヘッダーは既定で非表示のため、モデルのヘッダーデータを表示するには setHeaderHidden(false) を使用します。
int headerlessTopInset() constキャプションと列ヘッダーの両方が非表示のときの先頭行上部の余白。既定値は 2 論理ピクセルです。外部ヘッダーの端に接する場合は 0 に設定します。
void setHeaderlessTopInset(int inset)キャプションと列ヘッダーの両方が非表示のときの先頭行上部の余白。既定値は 2 論理ピクセルです。外部ヘッダーの端に接する場合は 0 に設定します。
QString placeholderText() constモデルに項目がないときに表示されるテキストです。
void setPlaceholderText(const QString& text)モデルに項目がないときに表示されるテキストです。
bool viewportHovered() constビューポートが現在ホバーされているかどうか。
bool canReorderItems() constドラッグによる並べ替えが有効かどうかです。
void setCanReorderItems(bool enabled)ドラッグによる並べ替えが有効かどうかです。
bool isScrollChainingEnabled() constスクロール境界でのホイール入力を外側のスクローラーへ引き継ぐかどうかです。
void setScrollChainingEnabled(bool enabled)スクロール境界でのホイール入力を外側のスクローラーへ引き継ぐかどうかです。
bool isOverscrollEnabled() constスクロール境界で弾性オーバースクロールのバウンスを有効にするかどうかです。デフォルトで有効であり、端でそのまま停止させたい場合は無効にします。
void setOverscrollEnabled(bool enabled)スクロール境界で弾性オーバースクロールのバウンスを有効にするかどうかです。デフォルトで有効であり、端でそのまま停止させたい場合は無効にします。
qreal indicatorMotionProgress() constツリー選択インジケーターのアニメーション進捗。
IndicatorVerticalDirection indicatorMotionDirection() constツリーインジケーターのアニメーションで使用される垂直方向です。
IndicatorHierarchyTransition indicatorHierarchyTransition() constツリーインジケーターのモーションで使用される階層トランジションモード。
bool isIndicatorMotionAnimationEnabled() constツリーインジケーターのモーションアニメーションを有効にするかどうか。
void setIndicatorMotionAnimationEnabled(bool enabled)ツリーインジケーターのモーションアニメーションを有効にするかどうか。
QRectF selectedIndicatorRect() constビューポート座標系における現在の選択インジケーターのジオメトリを返します。
QRectF selectedIndicatorRect(qreal progress) const正規化された遷移進行度に対する選択インジケーターのジオメトリを返します。
SelectionIndicatorStyle selectionIndicatorStyle() const選択インジケーターオーバーレイで使用されるスタイルを返します。
void setSelectionIndicatorStyle(const SelectionIndicatorStyle& style)選択インジケーターオーバーレイで使用されるスタイルを設定します。
bool selectionIndicatorVisible() constFluent アクセントの選択インジケーターオーバーレイが表示されるかどうか。
qreal selectionIndicatorHeight() constFluent の選択インジケーターピルの高さを返します。
void setSelectionIndicatorHeight(qreal height)Fluent 選択インジケーターピルの高さを設定します。
bool isHorizontalFluentScrollBarEnabled() constFluent の水平スクロールオーバーレイを表示できるかどうかを返します。
void setHorizontalFluentScrollBarEnabled(bool enabled)Fluent の水平スクロールオーバーレイの有効・無効を切り替えます。
qreal chevronRotation(const QModelIndex& index) constデリゲート描画用のシェブロン回転の進行度を返します(0 = 折りたたみ、1 = 展開)。
プロパティ
SelectionMode selectionModeコレクションビューで使用される選択モードです。
読み取りselectionMode()書き込みsetSelectionMode()通知シグナルselectionModeChanged()Typography::FontRole fontRoleテキスト描画に使用される Fluent タイポグラフィロール。
読み取りfontRole()書き込みsetFontRole()通知シグナルfontRoleChanged()bool viewportHoveredビューポートが現在ホバーされているかどうか。
読み取りviewportHovered()通知シグナルviewportHoveredChanged()qreal indicatorMotionProgressツリー選択インジケーターのアニメーション進捗。
読み取りindicatorMotionProgress()通知シグナルindicatorMotionProgressChanged()IndicatorVerticalDirection indicatorMotionDirectionツリーインジケーターのアニメーションで使用される垂直方向です。
読み取りindicatorMotionDirection()通知シグナルindicatorMotionDirectionChanged()IndicatorHierarchyTransition indicatorHierarchyTransitionツリーインジケーターのモーションで使用される階層トランジションモード。
読み取りindicatorHierarchyTransition()通知シグナルindicatorHierarchyTransitionChanged()bool indicatorMotionAnimationEnabledツリーインジケーターのモーションアニメーションを有効にするかどうか。
読み取りisIndicatorMotionAnimationEnabled()書き込みsetIndicatorMotionAnimationEnabled()通知シグナルindicatorMotionAnimationEnabledChanged()bool horizontalFluentScrollBarEnabledFluent 水平スクロールオーバーレイの表示を許可するかどうか。
読み取りisHorizontalFluentScrollBarEnabled()書き込みsetHorizontalFluentScrollBarEnabled()bool borderVisibleコントロールの枠線を描画するかどうか。
読み取りborderVisible()書き込みsetBorderVisible()通知シグナルborderVisibleChanged()bool backgroundVisibleコントロールの背景を描画するかどうか。
読み取りbackgroundVisible()書き込みsetBackgroundVisible()通知シグナルbackgroundVisibleChanged()QString headerText列ヘッダーと行の上に表示するオプションのキャプション。列ヘッダーは既定で非表示のため、モデルのヘッダーデータを表示するには setHeaderHidden(false) を使用します。
読み取りheaderText()書き込みsetHeaderText()通知シグナルheaderTextChanged()int headerlessTopInsetキャプションと列ヘッダーの両方が非表示のときの先頭行上部の余白。既定値は 2 論理ピクセルです。外部ヘッダーの端に接する場合は 0 に設定します。
読み取りheaderlessTopInset()書き込みsetHeaderlessTopInset()通知シグナルheaderlessTopInsetChanged()QString placeholderTextモデルに項目がないときに表示されるテキストです。
読み取りplaceholderText()書き込みsetPlaceholderText()通知シグナルplaceholderTextChanged()bool canReorderItemsドラッグによる並べ替えが有効かどうかです。
読み取りcanReorderItems()書き込みsetCanReorderItems()通知シグナルcanReorderItemsChanged()bool scrollChainingEnabledスクロール境界でのホイール入力を外側のスクローラーへ引き継ぐかどうかです。
読み取りisScrollChainingEnabled()書き込みsetScrollChainingEnabled()通知シグナルscrollChainingEnabledChanged()bool overscrollEnabledスクロール境界で弾性オーバースクロールのバウンスを有効にするかどうかです。デフォルトで有効であり、端でそのまま停止させたい場合は無効にします。
読み取りisOverscrollEnabled()書き込みsetOverscrollEnabled()通知シグナルoverscrollEnabledChanged()
シグナル
void selectionModeChanged()コレクションビューで使用される選択モードです。
void fontRoleChanged()テキスト描画に使用される Fluent タイポグラフィロール。
void viewportHoveredChanged()ビューポートが現在ホバーされているかどうか。
void borderVisibleChanged()コントロールの枠線を描画するかどうか。
void backgroundVisibleChanged()コントロールの背景を描画するかどうか。
void headerTextChanged()列ヘッダーと行の上に表示するオプションのキャプション。列ヘッダーは既定で非表示のため、モデルのヘッダーデータを表示するには setHeaderHidden(false) を使用します。
void headerlessTopInsetChanged()キャプションと列ヘッダーの両方が非表示のときの先頭行上部の余白。既定値は 2 論理ピクセルです。外部ヘッダーの端に接する場合は 0 に設定します。
void placeholderTextChanged()モデルに項目がないときに表示されるテキストです。
void itemPressed(const QModelIndex& index)QAbstractItemView::pressed() をミラーリングする便利なシグナル。
void itemClicked(const QModelIndex& index)QAbstractItemView::clicked() をミラーリングする便利なシグナル。
void canReorderItemsChanged()ドラッグによる並べ替えが有効かどうかです。
void scrollChainingEnabledChanged()スクロール境界でのホイール入力を外側のスクローラーへ引き継ぐかどうかです。
void overscrollEnabledChanged()スクロール境界で弾性オーバースクロールのバウンスを有効にするかどうかです。デフォルトで有効であり、端でそのまま停止させたい場合は無効にします。
void indicatorMotionProgressChanged()ツリー選択インジケーターのアニメーション進捗。
void indicatorMotionDirectionChanged()ツリーインジケーターのアニメーションで使用される垂直方向です。
void indicatorHierarchyTransitionChanged()ツリーインジケーターのモーションで使用される階層トランジションモード。
void indicatorMotionAnimationEnabledChanged()ツリーインジケーターのモーションアニメーションを有効にするかどうか。
型とエイリアス
struct SelectionIndicatorStyle移動する選択インジケーターオーバーレイで使用されるスタイルパラメーターです。
PySide6 拡張
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 基底クラスドキュメント:QTreeView
fluent::collections::TreeView::SelectionIndicatorStyle
移動する選択インジケーターオーバーレイで使用されるスタイルパラメーターです。