テキスト入力
TagInput タグ入力
非同期の補完候補とネイティブなテキスト入力を使って、複数の値をコンパクトなタグとして選択・削除できます。
サンプル
プロパティプレビューを読み込めませんでした。もう一度「プロパティプレビュー」を選択して再試行してください。

使い方
タグの選択と削除
setSuggestions() で補完候補を設定し、addItem() でタグを追加します。候補から選択したタグはマウスまたはキーボードで削除できます。
#include <FluentQt/TextFields.h>
using namespace fluent::textfields;
auto* input = new fluent::textfields::TagInput(this);
input->setAccessibleName("Technologies");
input->setPlaceholderText("Choose a technology");
input->setSuggestions({"Qt", "C++", "Python"});
input->addItem("Qt", "Qt");
input->setMaximumWidth(360);import fluentqt
input = fluentqt.TagInput()
input.setAccessibleName("Technologies")
input.setObjectName("basicTagInput")
input.setPlaceholderText("Choose a technology")
input.setSuggestions(["Qt", "C++", "Python"])
input.addItem("Qt", "Qt")
input.setMaximumWidth(360)API
宣言を表示一致する API メンバーはありません。
fluent::textfields::TagInput
継承元 AutoSuggestBox
AutoSuggestBox のテキストエディター周囲に配置された複数値タグ入力コントロールです。
コンストラクタ
デストラクタ
メソッド
void setSelectedItems(const QVariantList& items)選択済みタグを置き換えます。不正な形式の項目や重複キーは無視されます(最初の出現順序を保持)。
bool addItem(const QString& key, const QString& text)タグのスナップショットを追加します。key が空または選択済みの場合は false を返します。
プロパティ
QVariantList selectedItems- 読み取り
selectedItems()書き込みsetSelectedItems()通知シグナルselectionChanged() int selectedCount- 読み取り
selectedCount()通知シグナルselectionChanged()
シグナル
void tokensSubmitted(const QStringList& tokens)入力されたテキストや区切り文字付きの貼り付けトークンを外部で解決する必要があるときに送出されます。
protected メンバー
メソッド
fluent::textfields::AutoSuggestBox から継承
列挙型
enum class TextChangeReasonUserInputProgrammaticChangeSuggestionChosen
enum class QueryButtonPlacementRightLeftLeadingTrailing
enum class LoadState現在の非同期クエリの状態。Ready の場合でも行が含まれないことがあります。
IdleLoadingReadyFailed
メソッド
QStringList suggestions() constサジェストポップアップに表示される候補文字列のリストです。
QString header() const入力行の上に表示されるオプションのラベルテキスト。
QString queryIconGlyph() constクエリ/検索アフォーダンスで使用されるアイコングリフ。
bool isQueryIconVisible() constクエリアイコンが表示されるかどうか。
bool isClearButtonEnabled() const検索ボタンとは独立してインラインのクリアアクションを制御します。
void setClearButtonEnabled(bool enabled)検索ボタンとは独立してインラインのクリアアクションを制御します。
QueryButtonPlacement queryButtonPlacement() constクエリアクションボタンの配置。
int inputHeight() const入力ボックスの優先高さ。
int queryButtonSize() constクエリアクションボタンのサイズ。
int clearButtonSize() constクリアボタンのサイズ。
Typography::FontRole suggestionFontRole() const候補行で使用される Fluent Typography プリセット。
int suggestionItemHeight() const各サジェスト行の高さ。
bool isSuggestionListOpen() const候補ポップアップが開いているかどうか。
void setSuggestionModel(QAbstractItemModel* model)外部モデル(列 0 の DisplayRole、オプションで UserRole データ)をコピーまたは削除せずに候補として使用します。文字列リストモードに戻すには nullptr を渡すか setSuggestions() を呼び出します。
QString loadingMoreText() const別の結果ページの読み込み中に表示されるテキストです。
void setLoadingMoreText(const QString& text)別の結果ページの読み込み中に表示されるテキストです。
QString moreResultsText() const別の結果ページのアクションに添えられるテキストです。
void setMoreResultsText(const QString& text)別の結果ページのアクションに添えられるテキストです。
QString retryText() constリクエスト失敗後の再試行アクションのキャプション。
void setRetryText(const QString& text)リクエスト失敗後の再試行アクションのキャプション。
QString loadMoreText() const次の結果ページを要求するアクションのキャプション。
void setLoadMoreText(const QString& text)次の結果ページを要求するアクションのキャプション。
bool isSuggestionRequestCurrent(quint64 requestId) const外部モデルを更新する前に、requestId が依然として最新であるかを確認します(更新は GUI スレッドで実行する必要があります)。編集、ポップアップを閉じる操作、モデルの置き換え、または非同期モードの無効化により、以前のリクエストは無効になります。
bool completeSuggestionRequest(quint64 requestId, bool hasMore = false)外部の候補モデルを更新した後に requestId を完了します。古いリクエストの場合は false を返します。
bool setSuggestionsForRequest(quint64 requestId, const QStringList& suggestions, bool hasMore = false)requestId に対する QStringList の結果を設定または追加し、リクエストが古い場合は false を返します。外部モデルモードでは、代わりにモデルを更新して completeSuggestionRequest() を呼び出してください。
bool failSuggestionRequest(quint64 requestId, const QString& message, const QString& details = QString())requestId のエラー状態を表示します(ページネーションエラー時は既存の行を保持します)。
void setHeader(const QString& header)入力行の上に表示されるオプションのラベルテキスト。
void setQueryIconGlyph(const QString& glyph)クエリ/検索アフォーダンスで使用されるアイコングリフ。
void setQueryIconVisible(bool visible)クエリアイコンが表示されるかどうか。
void setQueryButtonPlacement(QueryButtonPlacement placement)クエリアクションボタンの配置。
void setInputHeight(int height)入力ボックスの優先高さ。
void setQueryButtonSize(int size)クエリアクションボタンのサイズ。
void setClearButtonSize(int size)クリアボタンのサイズ。
void setSuggestionFontRole(Typography::FontRole role)候補行で使用される Fluent Typography プリセット。
void setSuggestionItemHeight(int height)各サジェスト行の高さ。
void setSuggestions(const QStringList& suggestions)サジェストポップアップに表示される候補文字列のリストです。
void requestSuggestions()非同期サジェストが有効な場合、現在のクエリを即座にリクエストします。
プロパティ
QStringList suggestionsサジェストポップアップに表示される候補文字列のリストです。
読み取りsuggestions()書き込みsetSuggestions()通知シグナルsuggestionsChanged()QString header入力行の上に表示されるオプションのラベルテキスト。
読み取りheader()書き込みsetHeader()通知シグナルheaderChanged()QString queryIconGlyphクエリ/検索アフォーダンスで使用されるアイコングリフ。
読み取りqueryIconGlyph()書き込みsetQueryIconGlyph()通知シグナルqueryIconGlyphChanged()bool queryIconVisibleクエリアイコンが表示されるかどうか。
読み取りisQueryIconVisible()書き込みsetQueryIconVisible()通知シグナルqueryIconVisibleChanged()bool clearButtonEnabled検索ボタンとは独立してインラインのクリアアクションを制御します。
読み取りisClearButtonEnabled()書き込みsetClearButtonEnabled()通知シグナルclearButtonEnabledChanged()QueryButtonPlacement queryButtonPlacementクエリアクションボタンの配置。
読み取りqueryButtonPlacement()書き込みsetQueryButtonPlacement()通知シグナルqueryButtonPlacementChanged()int inputHeight入力ボックスの優先高さ。
読み取りinputHeight()書き込みsetInputHeight()通知シグナルinputHeightChanged()int queryButtonSizeクエリアクションボタンのサイズ。
読み取りqueryButtonSize()書き込みsetQueryButtonSize()通知シグナルqueryButtonSizeChanged()int clearButtonSizeクリアボタンのサイズ。
読み取りclearButtonSize()書き込みsetClearButtonSize()通知シグナルclearButtonSizeChanged()Typography::FontRole suggestionFontRole候補行で使用される Fluent Typography プリセット。
読み取りsuggestionFontRole()書き込みsetSuggestionFontRole()通知シグナルsuggestionFontRoleChanged()int suggestionItemHeight各サジェスト行の高さ。
読み取りsuggestionItemHeight()書き込みsetSuggestionItemHeight()通知シグナルsuggestionItemHeightChanged()bool isSuggestionListOpen候補ポップアップが開いているかどうか。
読み取りisSuggestionListOpen()通知シグナルsuggestionListOpenChanged()QAbstractItemModel* suggestionModel- 読み取り
suggestionModel()書き込みsetSuggestionModel()通知シグナルsuggestionModelChanged() int suggestionCount- 読み取り
suggestionCount()通知シグナルsuggestionCountChanged() bool asyncSuggestionsEnabled- 読み取り
isAsyncSuggestionsEnabled()書き込みsetAsyncSuggestionsEnabled()通知シグナルasyncSuggestionsEnabledChanged() int debounceInterval- 読み取り
debounceInterval()書き込みsetDebounceInterval()通知シグナルdebounceIntervalChanged() LoadState loadState- 読み取り
loadState()通知シグナルloadStateChanged() bool hasMoreSuggestions- 読み取り
hasMoreSuggestions()通知シグナルhasMoreSuggestionsChanged() QString loadingText- 読み取り
loadingText()書き込みsetLoadingText()通知シグナルloadingTextChanged() QString emptyText- 読み取り
emptyText()書き込みsetEmptyText()通知シグナルemptyTextChanged() QString emptyDescription- 読み取り
emptyDescription()書き込みsetEmptyDescription()通知シグナルemptyDescriptionChanged() QString loadingMoreText別の結果ページの読み込み中に表示されるテキストです。
読み取りloadingMoreText()書き込みsetLoadingMoreText()通知シグナルloadingMoreTextChanged()QString moreResultsText別の結果ページのアクションに添えられるテキストです。
読み取りmoreResultsText()書き込みsetMoreResultsText()通知シグナルmoreResultsTextChanged()QString retryTextリクエスト失敗後の再試行アクションのキャプション。
読み取りretryText()書き込みsetRetryText()通知シグナルretryTextChanged()QString loadMoreText次の結果ページを要求するアクションのキャプション。
読み取りloadMoreText()書き込みsetLoadMoreText()通知シグナルloadMoreTextChanged()
シグナル
void suggestionsChanged()サジェストポップアップに表示される候補文字列のリストです。
void headerChanged()入力行の上に表示されるオプションのラベルテキスト。
void queryIconGlyphChanged()クエリ/検索アフォーダンスで使用されるアイコングリフ。
void queryIconVisibleChanged()クエリアイコンが表示されるかどうか。
void queryButtonPlacementChanged()クエリアクションボタンの配置。
void inputHeightChanged()入力ボックスの優先高さ。
void queryButtonSizeChanged()クエリアクションボタンのサイズ。
void suggestionFontRoleChanged()候補行で使用される Fluent Typography プリセット。
void suggestionItemHeightChanged()各サジェスト行の高さ。
void suggestionListOpenChanged(bool open)候補ポップアップが開いているかどうか。
void loadingMoreTextChanged()別の結果ページの読み込み中に表示されるテキストです。
void moreResultsTextChanged()別の結果ページのアクションに添えられるテキストです。
void retryTextChanged()リクエスト失敗後の再試行アクションのキャプション。
void loadMoreTextChanged()次の結果ページを要求するアクションのキャプション。
void suggestionsRequested(const QString& query, quint64 requestId, bool append)候補データを要求するときに送出されます。次のページを読み込む場合や再試行する場合は append が true になります。
void suggestionRequestCanceled(quint64 requestId)処理中の requestId がキャンセルされたか、新しいリクエストに置き換えられたときに送出されます。
fluent::textfields::LineEdit から継承
メソッド
QMargins contentMargins() constテキスト周囲のコンテンツ余白(水平方向の値には Qt の内部テキストインセットが含まれます)。
void setContentMargins(const QMargins& margins)テキスト周囲のコンテンツ余白(水平方向の値には Qt の内部テキストインセットが含まれます)。
Typography::FontRole fontRole() constテキストに使用される Fluent Typography プリセット。
void setFontRole(Typography::FontRole role)テキストに使用される Fluent Typography プリセット。
bool isClearButtonEnabled() const末尾のクリアボタンを有効にするかどうか。
void setClearButtonEnabled(bool enabled)末尾のクリアボタンを有効にするかどうか。
int clearButtonSize() constクリアボタンのサイズ。既定値は 24 論理ピクセルです。
void setClearButtonSize(int size)クリアボタンのサイズ。既定値は 24 論理ピクセルです。
QPoint clearButtonOffset() constクリアボタンに適用されるピクセルオフセット。
void setClearButtonOffset(const QPoint& offset)クリアボタンに適用されるピクセルオフセット。
int focusedBorderWidth() constフォーカス時の下枠線の幅。
void setFocusedBorderWidth(int width)フォーカス時の下枠線の幅。
int unfocusedBorderWidth() const非フォーカス時の下枠線の幅。既定値は 0(下線なし)です。
void setUnfocusedBorderWidth(int width)非フォーカス時の下枠線の幅。既定値は 0(下線なし)です。
bool isFrameVisible() constLineEdit が入力枠とフォーカス下線を描画するかどうかです。
void setFrameVisible(bool visible)LineEdit が入力枠とフォーカス下線を描画するかどうかです。
void setTrailingText(const QString& text)末尾にプレーンテキストのサフィックスを表示し、既存の末尾ウィジェットを置き換えます。
bool setTrailingWidget(QWidget* widget, WidgetOwnership ownership)WidgetOwnership で破棄方法を指定してカスタムの末尾ウィジェットを設定します(自身や祖先ウィジェットは指定できません)。所有権モードを切り替える前に takeTrailingWidget() を呼び出してください。
QWidget* takeTrailingWidget()末尾のウィジェットを削除して返し、呼び出し側で管理または破棄できるようにします。
void releaseTrailingWidget()末尾のウィジェットを削除し、その WidgetOwnership モードに従ってクリーンアップを処理します。
プロパティ
QMargins contentMarginsテキスト周囲のコンテンツ余白(水平方向の値には Qt の内部テキストインセットが含まれます)。
読み取りcontentMargins()書き込みsetContentMargins()通知シグナルcontentMarginsChanged()Typography::FontRole fontRoleテキストに使用される Fluent Typography プリセット。
読み取りfontRole()書き込みsetFontRole()通知シグナルfontRoleChanged()bool clearButtonEnabled末尾のクリアボタンを有効にするかどうか。
読み取りisClearButtonEnabled()書き込みsetClearButtonEnabled()通知シグナルclearButtonEnabledChanged()int clearButtonSizeクリアボタンのサイズ。既定値は 24 論理ピクセルです。
読み取りclearButtonSize()書き込みsetClearButtonSize()通知シグナルclearButtonSizeChanged()QPoint clearButtonOffsetクリアボタンに適用されるピクセルオフセット。
読み取りclearButtonOffset()書き込みsetClearButtonOffset()通知シグナルclearButtonOffsetChanged()int focusedBorderWidthフォーカス時の下枠線の幅。
読み取りfocusedBorderWidth()書き込みsetFocusedBorderWidth()通知シグナルfocusedBorderWidthChanged()int unfocusedBorderWidth非フォーカス時の下枠線の幅。既定値は 0(下線なし)です。
読み取りunfocusedBorderWidth()書き込みsetUnfocusedBorderWidth()通知シグナルunfocusedBorderWidthChanged()bool frameVisibleLineEdit が入力枠とフォーカス下線を描画するかどうかです。
読み取りisFrameVisible()書き込みsetFrameVisible()通知シグナルframeVisibleChanged()QString trailingText- 読み取り
trailingText()書き込みsetTrailingText()通知シグナルtrailingTextChanged() QWidget* trailingWidget- 読み取り
trailingWidget()通知シグナルtrailingWidgetChanged() fluent::WidgetOwnership trailingWidgetOwnership- 読み取り
trailingWidgetOwnership()通知シグナルtrailingWidgetOwnershipChanged() QString clearButtonAccessibleName- 読み取り
clearButtonAccessibleName()書き込みsetClearButtonAccessibleName()通知シグナルclearButtonAccessibleNameChanged() Qt::FocusPolicy clearButtonFocusPolicy- 読み取り
clearButtonFocusPolicy()書き込みsetClearButtonFocusPolicy()通知シグナルclearButtonFocusPolicyChanged()
シグナル
void contentMarginsChanged()テキスト周囲のコンテンツ余白(水平方向の値には Qt の内部テキストインセットが含まれます)。
void fontRoleChanged()テキストに使用される Fluent Typography プリセット。
void clearButtonEnabledChanged()末尾のクリアボタンを有効にするかどうか。
void clearButtonSizeChanged()クリアボタンのサイズ。既定値は 24 論理ピクセルです。
void clearButtonOffsetChanged()クリアボタンに適用されるピクセルオフセット。
void focusedBorderWidthChanged()フォーカス時の下枠線の幅。
void unfocusedBorderWidthChanged()非フォーカス時の下枠線の幅。既定値は 0(下線なし)です。
void frameVisibleChanged()LineEdit が入力枠とフォーカス下線を描画するかどうかです。
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 基底クラスドキュメント:QLineEdit