基本入力
SplitButton スプリットボタン
主要なアクションとメニューを開く矢印の2つの部分からなるボタンです。
サンプル
プロパティプレビューを読み込めませんでした。もう一度「プロパティプレビュー」を選択して再試行してください。

使い方
主要アクションとメニュー
左側では clicked が発生し、右側の矢印では setMenu() で設定した FluentMenu が開きます(項目の選択はメニューの triggered シグナルで処理します)。アイコンのオプションは Button に準拠します。
#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;
auto* button = new SplitButton("Choose color", this);
auto* menu = new FluentMenu("Colors", button);
menu->addAction("Red");
menu->addAction("Green");
menu->addAction("Blue");
button->setMenu(menu);
connect(button, &SplitButton::clicked, button, [button] {
Toast::showOrUpdateToast(button, "gallery.action-feedback",
"Primary action selected", Toast::Informational, 2200,
Toast::Top, QMargins(16, 50, 16, 16));
});
connect(menu, &QMenu::triggered, button, [button](QAction* action) {
Toast::showOrUpdateToast(button, "gallery.action-feedback",
action->text() + " selected", Toast::Informational, 2200,
Toast::Top, QMargins(16, 50, 16, 16));
});import fluentqt
from PySide6.QtCore import QMargins
button = fluentqt.SplitButton('Choose color')
menu = fluentqt.FluentMenu('Colors', button)
menu.addAction('Red')
menu.addAction('Green')
menu.addAction('Blue')
button.setMenu(menu)
def feedback(message):
fluentqt.Toast.showOrUpdateToast(
button,
"gallery.action-feedback",
message,
fluentqt.Toast.Informational,
2200,
fluentqt.Toast.Top,
QMargins(16, 50, 16, 16)
)
button.clicked.connect(lambda: feedback('Primary action selected'))
menu.triggered.connect(lambda action: feedback(action.text() + ' selected'))API
宣言を表示一致する API メンバーはありません。
fluent::basicinput::SplitButton
継承元 Button
プライマリアクション領域とセカンダリのドロップダウンメニュートリガーに分かれた分割ボタン。
コンストラクタ
デストラクタ
列挙型
enum SplitPartNonePrimarySecondary
メソッド
bool isOpen() constアタッチされたメニューが現在表示されているかどうか。
int secondaryWidth() constスプリットボタンのセカンダリアクション領域の幅。
void setSecondaryWidth(int width)スプリットボタンのセカンダリアクション領域の幅。
プロパティ
bool isOpenアタッチされたメニューが現在表示されているかどうか。
読み取りisOpen()通知シグナルopenChanged()int secondaryWidthスプリットボタンのセカンダリアクション領域の幅。
読み取りsecondaryWidth()書き込みsetSecondaryWidth()通知シグナルsecondaryWidthChanged()
シグナル
void openChanged()アタッチされたメニューが現在表示されているかどうか。
void secondaryWidthChanged()スプリットボタンのセカンダリアクション領域の幅。
protected メンバー
フィールド
メソッド
fluent::basicinput::Button から継承
列挙型
enum ButtonStyleFluent デザイントークンに基づいて解決されるボタンの視覚スタイル。
StandardAccentSubtle
enum ButtonSizeパディングと推奨高さを制御するボタン密度プリセット。
SmallStandardSizeLarge
enum ButtonLayoutラベルの上下にアイコンを中央配置する形式を含む、テキストとアイコンの構成モードです。
TextOnlyIconBeforeIconOnlyIconAfterIconAboveIconBelow
enum class TextColorRoleテキストとアイコンの色の強調レベルです。
PrimarySecondaryAccent
enum InteractionState描画状態の上書き値。Rest の場合は実際のホバー状態または押下状態が使用されます。
RestHoverPressedDisabled
メソッド
ButtonStyle fluentStyle() const外観スタイル(Standard、Accent、または Subtle)です。
void setFluentStyle(ButtonStyle style)外観スタイル(Standard、Accent、または Subtle)です。
ButtonSize fluentSize() constフォントではなく高さとパディングを制御するサイズプリセット。
void setFluentSize(ButtonSize size)フォントではなく高さとパディングを制御するサイズプリセット。
Typography::FontRole fontRole() constテーマフォントに従う場合に使用される Fluent Typography プリセット。
void setFontRole(Typography::FontRole role)テーマフォントに従う場合に使用される Fluent Typography プリセット。
TextColorRole textColorRole() const塗りつぶしなし・未選択状態のボタンにおける前景色強調です。塗りつぶし状態および無効状態ではそれぞれのコントラスト色が維持されます。
void setTextColorRole(TextColorRole role)塗りつぶしなし・未選択状態のボタンにおける前景色強調です。塗りつぶし状態および無効状態ではそれぞれのコントラスト色が維持されます。
void setFont(const QFont& font)明示的なフォントを設定します。以降のテーマ更新でも上書きされません。
ButtonLayout fluentLayout() constテキストとアイコンの配置用コンテンツレイアウト。
void setFluentLayout(ButtonLayout layout)明示的なレイアウトを選択します(アイコンが割り当てられる前の TextOnly を含みます)。
void setIcon(const QIcon& icon)Qt アイコンを設定します。レイアウトが明示的に選択されていない場合、最初のアイコンには IconBefore が使用されます。
QIcon icon() constアイコングリフと同じデフォルトレイアウト昇格ルールを持つ Qt アイコン。
bool hasFocusVisual() constフォーカスの視覚的フレームを描画するかどうかを制御します。
void setFocusVisual(bool focus)フォーカスの視覚的フレームを描画するかどうかを制御します。
InteractionState interactionState() constガイド付きデモや視覚チェック用にインタラクション状態を上書きします。
void setInteractionState(InteractionState state)ガイド付きデモや視覚チェック用にインタラクション状態を上書きします。
bool criticalOnHover() constホバー時または押下時に重大エラー色を使用します。
void setCriticalOnHover(bool enabled)ホバー時または押下時に重大エラー色を使用します。
QMargins cornerRadii() const各角の半径。left/top/right/bottom はそれぞれ左上・右上・右下・左下に対応します。
void setCornerRadii(const QMargins& radii)各角の半径。left/top/right/bottom はそれぞれ左上・右上・右下・左下に対応します。
void resetCornerRadii()各角の半径。left/top/right/bottom はそれぞれ左上・右上・右下・左下に対応します。
QPoint iconOffset() consticonfont の描画に適用されるピクセルオフセット。正の値で右および下に移動します。
void setIconOffset(const QPoint& offset)iconfont の描画に適用されるピクセルオフセット。正の値で右および下に移動します。
qreal iconRotation() const描画されるアイコンに適用する時計回りの回転角度(度)。
void setIconRotation(qreal rotation)描画されるアイコンに適用する時計回りの回転角度(度)。
qreal iconScale() const描画されるアイコンフォントグリフに適用される均一スケールです(1.0 = スケーリングなし)。アプリケーションは押下フィードバック用にこのプロパティをアニメーションできますが、Button 自体はスケールアニメーションを開始しません。
void setIconScale(qreal scale)描画されるアイコンフォントグリフに適用される均一スケールです(1.0 = スケーリングなし)。アプリケーションは押下フィードバック用にこのプロパティをアニメーションできますが、Button 自体はスケールアニメーションを開始しません。
qreal contentOpacity() constボタン全体に適用されるペインターレベルの不透明度(1.0 = 完全不透明)。QGraphicsOpacityEffect のオフスクリーン合成オーバーヘッドを回避する軽量なフェードを実現します。
void setContentOpacity(qreal opacity)ボタン全体に適用されるペインターレベルの不透明度(1.0 = 完全不透明)。QGraphicsOpacityEffect のオフスクリーン合成オーバーヘッドを回避する軽量なフェードを実現します。
QSize sizeHint() const overrideFluent のパディング、テキスト、および iconfont コンテンツを含む推奨サイズを計算します。
void setIconGlyph(const QString& glyph, int pixelSize = Typography::IconSize::Standard, const QString& family = Typography::FontFamily::FluentIcons)paintEvent() で直接描画する iconfont グリフを設定します。setFluentLayout() が呼び出されていない場合、最初の空でないグリフでレイアウトが IconBefore に切り替わります。
プロパティ
ButtonStyle fluentStyle外観スタイル(Standard、Accent、または Subtle)です。
読み取りfluentStyle()書き込みsetFluentStyle()通知シグナルfluentStyleChanged()ButtonSize fluentSizeフォントではなく高さとパディングを制御するサイズプリセット。
読み取りfluentSize()書き込みsetFluentSize()通知シグナルfluentSizeChanged()Typography::FontRole fontRoleテーマフォントに従う場合に使用される Fluent Typography プリセット。
読み取りfontRole()書き込みsetFontRole()通知シグナルfontRoleChanged()TextColorRole textColorRole塗りつぶしなし・未選択状態のボタンにおける前景色強調です。塗りつぶし状態および無効状態ではそれぞれのコントラスト色が維持されます。
読み取りtextColorRole()書き込みsetTextColorRole()通知シグナルtextColorRoleChanged()ButtonLayout fluentLayoutテキストとアイコンの配置用コンテンツレイアウト。
読み取りfluentLayout()書き込みsetFluentLayout()通知シグナルfluentLayoutChanged()QIcon iconアイコングリフと同じデフォルトレイアウト昇格ルールを持つ Qt アイコン。
読み取りicon()書き込みsetIcon()通知シグナルiconChanged()bool focusVisualフォーカスの視覚的フレームを描画するかどうかを制御します。
読み取りhasFocusVisual()書き込みsetFocusVisual()通知シグナルfocusVisualChanged()InteractionState interactionStateガイド付きデモや視覚チェック用にインタラクション状態を上書きします。
読み取りinteractionState()書き込みsetInteractionState()通知シグナルinteractionStateChanged()bool criticalOnHoverホバー時または押下時に重大エラー色を使用します。
読み取りcriticalOnHover()書き込みsetCriticalOnHover()通知シグナルcriticalOnHoverChanged()QMargins cornerRadii各角の半径。left/top/right/bottom はそれぞれ左上・右上・右下・左下に対応します。
読み取りcornerRadii()書き込みsetCornerRadii()リセットresetCornerRadii()通知シグナルcornerRadiiChanged()QPoint iconOffseticonfont の描画に適用されるピクセルオフセット。正の値で右および下に移動します。
読み取りiconOffset()書き込みsetIconOffset()qreal iconRotation描画されるアイコンに適用する時計回りの回転角度(度)。
読み取りiconRotation()書き込みsetIconRotation()qreal iconScale描画されるアイコンフォントグリフに適用される均一スケールです(1.0 = スケーリングなし)。アプリケーションは押下フィードバック用にこのプロパティをアニメーションできますが、Button 自体はスケールアニメーションを開始しません。
読み取りiconScale()書き込みsetIconScale()qreal contentOpacityボタン全体に適用されるペインターレベルの不透明度(1.0 = 完全不透明)。QGraphicsOpacityEffect のオフスクリーン合成オーバーヘッドを回避する軽量なフェードを実現します。
読み取りcontentOpacity()書き込みsetContentOpacity()
シグナル
void fluentStyleChanged()外観スタイル(Standard、Accent、または Subtle)です。
void fluentSizeChanged()フォントではなく高さとパディングを制御するサイズプリセット。
void fontRoleChanged()テーマフォントに従う場合に使用される Fluent Typography プリセット。
void textColorRoleChanged()塗りつぶしなし・未選択状態のボタンにおける前景色強調です。塗りつぶし状態および無効状態ではそれぞれのコントラスト色が維持されます。
void fluentLayoutChanged()テキストとアイコンの配置用コンテンツレイアウト。
void iconChanged()アイコングリフと同じデフォルトレイアウト昇格ルールを持つ Qt アイコン。
void focusVisualChanged()フォーカスの視覚的フレームを描画するかどうかを制御します。
void interactionStateChanged()ガイド付きデモや視覚チェック用にインタラクション状態を上書きします。
void criticalOnHoverChanged()ホバー時または押下時に重大エラー色を使用します。
void cornerRadiiChanged()各角の半径。left/top/right/bottom はそれぞれ左上・右上・右下・左下に対応します。
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 基底クラスドキュメント:QPushButton