Fluent-Qt

기본 입력

DropDownButton 드롭다운 버튼

호출 시 관련 명령 메뉴를 펼치는 버튼입니다.

예제

DropDownButton 드롭다운 버튼: DropDownButton 메뉴

사용법

DropDownButton 메뉴

setMenu()로 FluentMenu를 연결합니다. 클릭하면 메뉴가 열리며 추가 핸들러를 위해 clicked도 계속 사용할 수 있습니다. 아이콘 옵션은 Button을 따릅니다.

#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;

auto* button = new DropDownButton("Options", this);
auto* menu = new FluentMenu("Options", button);
menu->addAction("Edit profile");
menu->addAction("Account settings");
menu->addAction("Sign out");
button->setMenu(menu);

fluent::basicinput::DropDownButton

상속 대상 Button

연결된 메뉴나 플라이아웃을 여는 오른쪽 셰브론이 포함된 Fluent 버튼.

생성자

소멸자

메서드

void setMenu(QMenu* menu)

드롭다운 메뉴를 설정합니다 (이 버튼에 의해 삭제되지 않습니다).

QMenu* menu() const

버튼을 클릭할 때 열리는 메뉴.

bool isOpen() const

외관 및 접근성을 위한 메뉴 열림 상태. 설정해도 메뉴가 표시되거나 숨겨지지 않습니다.

void setIsOpen(bool open)

외관 및 접근성을 위한 메뉴 열림 상태. 설정해도 메뉴가 표시되거나 숨겨지지 않습니다.

QString chevronGlyph() const

셰브론 UI 요소에 사용되는 Iconfont 글리프

void setChevronGlyph(const QString& glyph)

셰브론 UI 요소에 사용되는 Iconfont 글리프

QString iconFontFamily() const

글리프 렌더링에 사용되는 Iconfont 패밀리

void setIconFontFamily(const QString& family)

글리프 렌더링에 사용되는 Iconfont 패밀리

int chevronSize() const

셰브론 글리프 픽셀 크기.

void setChevronSize(int size)

셰브론 글리프 픽셀 크기.

QPoint chevronOffset() const

셰브론 그리기에 적용되는 픽셀 오프셋.

void setChevronOffset(const QPoint& offset)

셰브론 그리기에 적용되는 픽셀 오프셋.

qreal pressProgress() const

셰브론 클릭 피드백을 위한 누름 애니메이션 진행률.

void setPressProgress(qreal value)

셰브론 클릭 피드백을 위한 누름 애니메이션 진행률.

속성

QMenu* menu

버튼을 클릭할 때 열리는 메뉴.

읽기 menu()쓰기 setMenu()알림 신호 menuChanged()
bool isOpen

외관 및 접근성을 위한 메뉴 열림 상태. 설정해도 메뉴가 표시되거나 숨겨지지 않습니다.

읽기 isOpen()쓰기 setIsOpen()알림 신호 openChanged()
QString chevronGlyph

셰브론 UI 요소에 사용되는 Iconfont 글리프

읽기 chevronGlyph()쓰기 setChevronGlyph()알림 신호 chevronChanged()
QString iconFontFamily

글리프 렌더링에 사용되는 Iconfont 패밀리

읽기 iconFontFamily()쓰기 setIconFontFamily()알림 신호 chevronChanged()
int chevronSize

셰브론 글리프 픽셀 크기.

읽기 chevronSize()쓰기 setChevronSize()알림 신호 chevronChanged()
QPoint chevronOffset

셰브론 그리기에 적용되는 픽셀 오프셋.

읽기 chevronOffset()쓰기 setChevronOffset()알림 신호 chevronChanged()
qreal pressProgress

셰브론 클릭 피드백을 위한 누름 애니메이션 진행률.

읽기 pressProgress()쓰기 setPressProgress()

시그널

void menuChanged()

버튼을 클릭할 때 열리는 메뉴.

void openChanged()

외관 및 접근성을 위한 메뉴 열림 상태. 설정해도 메뉴가 표시되거나 숨겨지지 않습니다.

void chevronChanged()

셰브론 UI 요소에 사용되는 Iconfont 글리프

보호된 멤버

메서드

fluent::basicinput::Button에서 상속됨

열거형

enum ButtonStyle

Fluent 디자인 토큰에 따라 결정되는 버튼 시각적 스타일.

  • Standard
  • Accent
  • Subtle
enum ButtonSize

안쪽 여백 및 기본 높이를 위한 버튼 밀도 프리셋.

  • Small
  • StandardSize
  • Large
enum ButtonLayout

텍스트/아이콘 조합 모드로, 레이블 위 또는 아래에 아이콘을 가운데 배치하는 옵션을 포함합니다.

  • TextOnly
  • IconBefore
  • IconOnly
  • IconAfter
  • IconAbove
  • IconBelow
enum class TextColorRole

텍스트와 아이콘의 색상 강조 수준.

  • Primary
  • Secondary
  • Accent
enum InteractionState

그리기 상태 재정의. Rest는 실제 마우스 오버 또는 누름 상태를 사용합니다.

  • Rest
  • Hover
  • Pressed
  • Disabled

메서드

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() const

iconfont 그리기에 적용되는 픽셀 오프셋. 양수 값은 오른쪽/아래로 이동합니다.

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 override

Fluent 여백, 텍스트 및 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 iconOffset

iconfont 그리기에 적용되는 픽셀 오프셋. 양수 값은 오른쪽/아래로 이동합니다.

읽기 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 = 0
  • Dark = 1
  • HighContrast = 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에 바인딩합니다.

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