기본 입력
CompoundButton 복합 버튼
제목과 보조 설명 줄을 함께 표시하는 버튼입니다.
예제
속성 미리 보기를 불러오지 못했습니다. 속성 미리 보기를 다시 선택해 재시도하세요.

사용법
기본 및 보조 콘텐츠
생성자에 제목과 보조 텍스트를 전달하고, 주요 작업에는 setFluentStyle(Button::Accent)를 사용합니다. 아이콘 레이아웃, 회전, 크기 및 오프셋은 Button과 동일하며, IconOnly는 레이블을 숨깁니다.
#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;
auto* standard = new CompoundButton(
"Install update",
"Download and restart the app",
this);
standard->setFixedWidth(220);
auto* accent = new CompoundButton(
"Start trial",
"No payment method required",
this);
accent->setFluentStyle(Button::Accent);
accent->setFixedWidth(220);import fluentqt
standard = fluentqt.CompoundButton(
'Install update',
'Download and restart the app'
)
standard.setFixedWidth(220)
accent = fluentqt.CompoundButton(
'Start trial',
'No payment method required'
)
accent.setFluentStyle(fluentqt.Button.ButtonStyle.Accent)
accent.setFixedWidth(220)API
선언 보기일치하는 API 멤버가 없습니다.
fluent::basicinput::CompoundButton
상속 대상 Button
기본 레이블과 표시 전용 보조 설명을 갖춘 푸시 버튼.
생성자
메서드
속성
QString secondaryText- 읽기
secondaryText()쓰기setSecondaryText()알림 신호secondaryTextChanged()
시그널
보호된 멤버
메서드
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마우스 오버 또는 누른 상태에서 치명적 오류 색상 (Critical)을 사용합니다.
void setCriticalOnHover(bool enabled)마우스 오버 또는 누른 상태에서 치명적 오류 색상 (Critical)을 사용합니다.
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그려진 iconfont 글리프에 적용되는 균일 배율입니다 (1.0 = 크기 조절 없음). 애플리케이션에서 누름 피드백을 위해 이 속성에 애니메이션을 적용할 수 있으며, Button 자체는 배율 애니메이션을 시작하지 않습니다.
void setIconScale(qreal scale)그려진 iconfont 글리프에 적용되는 균일 배율입니다 (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마우스 오버 또는 누른 상태에서 치명적 오류 색상 (Critical)을 사용합니다.
읽기criticalOnHover()쓰기setCriticalOnHover()알림 신호criticalOnHoverChanged()QMargins cornerRadii모서리별 반경. left/top/right/bottom은 각각 왼쪽 위/오른쪽 위/오른쪽 아래/왼쪽 아래에 매핑됩니다.
읽기cornerRadii()쓰기setCornerRadii()초기화resetCornerRadii()알림 신호cornerRadiiChanged()QPoint iconOffseticonfont 그리기에 적용되는 픽셀 오프셋. 양수 값은 오른쪽/아래로 이동합니다.
읽기iconOffset()쓰기setIconOffset()qreal iconRotation그려진 아이콘에 적용되는 시계 방향 회전 각도 (도).
읽기iconRotation()쓰기setIconRotation()qreal iconScale그려진 iconfont 글리프에 적용되는 균일 배율입니다 (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()마우스 오버 또는 누른 상태에서 치명적 오류 색상 (Critical)을 사용합니다.
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재질, 고도 (elevation) 및 적응형 레이아웃 토큰.
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++ setter 호출에는 애니메이션이 적용되지 않습니다.
void clearBehavior(const char* propertyName)이후 관리되는 쓰기 작업의 기본 애니메이션을 제거합니다.
bool writeProperty(const char* propertyName, const QVariant& value)바인딩을 제거하지 않고 Behavior를 통해 호스트 속성을 씁니다.
Qt 기본 클래스 문서: QPushButton