基本入力
ComboBox コンボボックス
選択肢のセットから1つの項目を選ぶドロップダウンリストです。
サンプル
プロパティプレビューを読み込めませんでした。もう一度「プロパティプレビュー」を選択して再試行してください。

使い方
ComboBox の選択
addItems() で選択肢を追加し、currentIndexChanged を監視して currentText() で選択中のラベルを取得します。何も選択されておらず入力が空の場合はプレースホルダーテキストが表示されます(編集可能モードでは lineEdit() に設定してください)。
#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;
auto* comboBox = new ComboBox(this);
comboBox->addItems({"Blue", "Green", "Red", "Yellow"});
comboBox->setCurrentIndex(0);
connect(comboBox, qOverload<int>(&ComboBox::currentIndexChanged),
this, [=](int index) {
status->setText(comboBox->currentText());
});import fluentqt
combo_box = fluentqt.ComboBox()
combo_box.addItems(['Blue', 'Green', 'Red', 'Yellow'])
combo_box.setCurrentIndex(0)
combo_box.currentIndexChanged.connect(
lambda _index: status.setText(f"Selected: {combo_box.currentText()}")
)API
宣言を表示一致する API メンバーはありません。
fluent::basicinput::ComboBox
継承元 QComboBox · FluentElement · QMLPlus
カスタムポップアップリスト、オプションの編集可能な入力欄、末尾スロットを備えた Fluent コンボボックス。
コンストラクタ
デストラクタ
メソッド
Typography::FontRole fontRole() constテキストに使用される Fluent Typography プリセット。
void setFontRole(Typography::FontRole role)Fluent Typography プリセットを適用し、変更がない場合でも明示的なフォント上書きをクリアします。
void setFont(const QFont& font)テーマ更新の影響を受けずに、フィールド、エディター、ドロップダウンのフォントを設定します。
int contentPaddingH() constコンテンツの水平パディング(ピクセル単位)。
void setContentPaddingH(int px)コンテンツの水平パディング(ピクセル単位)。
int contentPaddingV() constコンテンツ領域の垂直パディング(ピクセル単位)です。
void setContentPaddingV(int px)コンテンツ領域の垂直パディング(ピクセル単位)です。
QString chevronGlyph() constシェブロンアフォーダンスに使用される iconfont グリフ。
void setChevronGlyph(const QString& glyph)シェブロンアフォーダンスに使用される iconfont グリフ。
int chevronSize() constシェブロングリフのピクセルサイズ。
void setChevronSize(int size)シェブロングリフのピクセルサイズ。
QPoint chevronOffset() constシェブロンの描画に適用されるピクセルオフセット。
void setChevronOffset(const QPoint& offset)シェブロンの描画に適用されるピクセルオフセット。
int popupOffset() constアンカーからのポップアップのオフセット(ピクセル単位)。
void setPopupOffset(int offset)アンカーからのポップアップのオフセット(ピクセル単位)。
qreal pressProgress() constシェブロンクリック時のフィードバック用押下アニメーション進捗。
void setPressProgress(qreal p)シェブロンクリック時のフィードバック用押下アニメーション進捗。
void setEditable(bool editable)Fluent の LineEdit を使用した編集可能モードの有効・無効を切り替えます。
void setLineEdit(QLineEdit* edit)QComboBox のエディタを置き換え、Fluent レイアウト状態を同期します。
void setTrailingText(const QString& text)編集可能モードと読み取り専用モードの両方で、項目値を変更せずにプレーンテキストのサフィックスを表示します。
bool setTrailingWidget(QWidget* widget, WidgetOwnership ownership)テキストまたはエディターの横に末尾ウィジェットを配置し、既存の接尾辞テキストを置き換えます。クリーンアップ方法を指定するには WidgetOwnership を渡し、変更前には takeTrailingWidget() を呼び出してください。
QWidget* takeTrailingWidget()末尾のウィジェットを削除して返し、呼び出し側で管理または破棄できるようにします。
void releaseTrailingWidget()末尾のウィジェットを削除し、その WidgetOwnership モードに従ってクリーンアップを処理します。
void setModel(QAbstractItemModel* model) FLUENT_QT6_ONLY_OVERRIDEアイテムモデルを設定します(呼び出し元で管理され、このコントロールによって破棄されません)。
プロパティ
Typography::FontRole fontRoleテキストに使用される Fluent Typography プリセット。
読み取りfontRole()書き込みsetFontRole()通知シグナルfontRoleChanged()int contentPaddingHコンテンツの水平パディング(ピクセル単位)。
読み取りcontentPaddingH()書き込みsetContentPaddingH()通知シグナルlayoutChanged()int contentPaddingVコンテンツ領域の垂直パディング(ピクセル単位)です。
読み取りcontentPaddingV()書き込みsetContentPaddingV()通知シグナルlayoutChanged()QString chevronGlyphシェブロンアフォーダンスに使用される iconfont グリフ。
読み取りchevronGlyph()書き込みsetChevronGlyph()通知シグナルchevronChanged()int chevronSizeシェブロングリフのピクセルサイズ。
読み取りchevronSize()書き込みsetChevronSize()通知シグナルchevronChanged()QPoint chevronOffsetシェブロンの描画に適用されるピクセルオフセット。
読み取りchevronOffset()書き込みsetChevronOffset()通知シグナルchevronChanged()int popupOffsetアンカーからのポップアップのオフセット(ピクセル単位)。
読み取りpopupOffset()書き込みsetPopupOffset()通知シグナルlayoutChanged()qreal pressProgressシェブロンクリック時のフィードバック用押下アニメーション進捗。
読み取りpressProgress()書き込みsetPressProgress()QString trailingText- 読み取り
trailingText()書き込みsetTrailingText()通知シグナルtrailingTextChanged() QWidget* trailingWidget- 読み取り
trailingWidget()通知シグナルtrailingWidgetChanged() fluent::WidgetOwnership trailingWidgetOwnership- 読み取り
trailingWidgetOwnership()通知シグナルtrailingWidgetOwnershipChanged()
シグナル
void fontRoleChanged()テキストに使用される Fluent Typography プリセット。
void layoutChanged()コンテンツの水平パディング(ピクセル単位)。
void chevronChanged()シェブロンアフォーダンスに使用される iconfont グリフ。
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 基底クラスドキュメント:QComboBox
fluent::basicinput::ComboBoxItemDelegate
Fluent のメトリクスとテーマカラーで ComboBox のポップアップ行を描画するアイテムデリゲート。