基本入力
TreeSelect ツリーセレクト
ツリーモデルを検索し、1つ以上の項目を選択します。
サンプル
プロパティプレビューを読み込めませんでした。もう一度「プロパティプレビュー」を選択して再試行してください。

使い方
階層から選択
setModel() で階層データをバインドします。項目のキーは Qt::UserRole から取得され、setSelectedKeys() で事前選択できます。選択不可のグループノードは選択されずに展開されます。
#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;
auto* select = new fluent::basicinput::TreeSelect(this);
select->setAccessibleName("Team");
select->setPlaceholderText("Choose a team");
auto* model = new QStandardItemModel(select);
auto* product = new QStandardItem("Product");
product->setSelectable(false);
auto* client = new QStandardItem("Client");
client->setData("client", Qt::UserRole);
auto* platform = new QStandardItem("Platform");
platform->setData("platform", Qt::UserRole);
product->appendRow(client);
product->appendRow(platform);
model->appendRow(product);
select->setModel(model);
select->setSelectedKeys({"client"});
select->setMaximumWidth(360);import fluentqt
from PySide6.QtCore import Qt
from PySide6.QtGui import QStandardItem, QStandardItemModel
select = fluentqt.TreeSelect()
select.setAccessibleName("Team")
select.setObjectName("basicTreeSelect")
select.setPlaceholderText("Choose a team")
model = QStandardItemModel(select)
product = QStandardItem("Product")
product.setSelectable(False)
client = QStandardItem("Client")
client.setData("client", Qt.UserRole)
platform = QStandardItem("Platform")
platform.setData("platform", Qt.UserRole)
product.appendRow(client)
product.appendRow(platform)
model.appendRow(product)
select.setModel(model)
select.setSelectedKeys(["client"])
select.setMaximumWidth(360)API
宣言を表示一致する API メンバーはありません。
fluent::basicinput::TreeSelect
継承元 QWidget · FluentElement · QMLPlus
ツリーモデルをデータソースとする、検索可能な単一・複数選択ドロップダウンです。列 0 の DisplayRole からラベルを、keyRole(デフォルトは UserRole)から一意の文字列キーを読み取り、各項目は独立して選択されます。
コンストラクタ
デストラクタ
列挙型
enum class SelectionModeSingleMultiple
メソッド
void setModel(QAbstractItemModel* model)ソースツリーモデルを設定します(呼び出し元で管理され、このコントロールによって破棄されません)。
QVariantList selectedItems() constkey、text、および完全な path 文字列を含む選択値のスナップショットです。
void setSelectedKeys(const QStringList& keys)既知の選択可能なキーを選択します。Single モードでは最初の有効なキーのみが保持されます。
void setSearchText(const QString& text)クエリを即座に適用します。大規模なツリーでの対話的な入力は、フィルタリング前にデバウンス処理されます。
QString emptyText() const検索に一致する行がない場合に表示されるメッセージです。空文字を指定すると非表示になります。
void setEmptyText(const QString& text)検索に一致する行がない場合に表示されるメッセージです。空文字を指定すると非表示になります。
プロパティ
QAbstractItemModel* model- 読み取り
model()書き込みsetModel()通知シグナルmodelChanged() int keyRole- 読み取り
keyRole()書き込みsetKeyRole()通知シグナルkeyRoleChanged() SelectionMode selectionMode- 読み取り
selectionMode()書き込みsetSelectionMode()通知シグナルselectionModeChanged() QStringList selectedKeys- 読み取り
selectedKeys()書き込みsetSelectedKeys()通知シグナルselectionChanged() QVariantList selectedItemskey、text、および完全な path 文字列を含む選択値のスナップショットです。
読み取りselectedItems()通知シグナルselectionChanged()int selectedCount- 読み取り
selectedCount()通知シグナルselectionChanged() QString searchText- 読み取り
searchText()書き込みsetSearchText()通知シグナルsearchTextChanged() QString placeholderText- 読み取り
placeholderText()書き込みsetPlaceholderText()通知シグナルplaceholderTextChanged() QString emptyText検索に一致する行がない場合に表示されるメッセージです。空文字を指定すると非表示になります。
読み取りemptyText()書き込みsetEmptyText()通知シグナルemptyTextChanged()bool readOnly- 読み取り
isReadOnly()書き込みsetReadOnly()通知シグナルreadOnlyChanged() bool isOpen- 読み取り
isOpen()書き込みsetIsOpen()通知シグナルisOpenChanged()
シグナル
void selectionChanged()key、text、および完全な path 文字列を含む選択値のスナップショットです。
void emptyTextChanged()検索に一致する行がない場合に表示されるメッセージです。空文字を指定すると非表示になります。
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