Fluent-Qt

상태 및 정보

InfoBar 정보 표시줄

심각도와 선택적 작업이 포함된 인라인 상태 메시지 바입니다.

예제

InfoBar 정보 표시줄: 심각도

사용법

심각도

setSeverity()로 메시지 심각도에 따라 앞쪽 아이콘과 배경 스타일을 전환하고, setTitle()과 setMessage()로 제목과 본문을 설정합니다.

#include <FluentQt/StatusInfo.h>
using namespace fluent::status_info;

auto* info = new InfoBar(this);
info->setSeverity(InfoBar::Informational);
info->setTitle("Update available");
info->setMessage("Version 3.2 is ready.");

auto* error = new InfoBar(this);
error->setSeverity(InfoBar::Error);
error->setTitle("Upload failed");
error->setMessage("The document could not be saved.");

keepInfoBarOpenWithToast(info);
keepInfoBarOpenWithToast(error);

fluent::status_info::InfoBar

상속 대상 QWidget · FluentElement · QMLPlus

심각도 수준, 선택적 작업 위젯 및 닫기 버튼을 지원하는 Fluent 인라인 알림 표시줄입니다. 상태 스타일과 열림/닫힘 상태로 제목과 메시지를 표시합니다.

생성자

소멸자

열거형

enum InfoBarSeverity
  • Informational
  • Success
  • Warning
  • Error

메서드

bool isOpen() const

정보 표시줄이 열려 있는지 여부.

void setIsOpen(bool open)

정보 표시줄이 열려 있는지 여부.

QString title() const

정보 표시줄에 표시되는 제목 텍스트.

void setTitle(const QString& title)

정보 표시줄에 표시되는 제목 텍스트.

QString message() const

정보 표시줄에 표시되는 메시지 본문 텍스트.

void setMessage(const QString& message)

정보 표시줄에 표시되는 메시지 본문 텍스트.

InfoBarSeverity severity() const

알림 색상과 아이콘에 사용되는 심각도 수준입니다.

void setSeverity(InfoBarSeverity severity)

알림 색상과 아이콘에 사용되는 심각도 수준입니다.

bool isClosable() const

닫기 요소가 표시되고 활성화되어 있는지 여부.

void setIsClosable(bool closable)

닫기 요소가 표시되고 활성화되어 있는지 여부.

bool isIconVisible() const

심각도 아이콘 표시 여부.

void setIsIconVisible(bool visible)

심각도 아이콘 표시 여부.

bool singleLine() const

알림에 간결한 한 줄 레이아웃을 사용할지 여부.

void setSingleLine(bool singleLine)

알림에 간결한 한 줄 레이아웃을 사용할지 여부.

int preferredWidth() const

알림 레이아웃에서 사용하는 선호 너비.

void setPreferredWidth(int width)

알림 레이아웃에서 사용하는 선호 너비.

int singleLineHeight() const

한 줄 알림 레이아웃에서 사용하는 높이

void setSingleLineHeight(int height)

한 줄 알림 레이아웃에서 사용하는 높이

int multiLineMinHeight() const

여러 줄 알림 레이아웃에 사용되는 최소 높이.

void setMultiLineMinHeight(int height)

여러 줄 알림 레이아웃에 사용되는 최소 높이.

int multiLineActionMinHeight() const

여러 줄 레이아웃에 작업 영역이 포함될 때의 최소 높이.

void setMultiLineActionMinHeight(int height)

여러 줄 레이아웃에 작업 영역이 포함될 때의 최소 높이.

QWidget* actionWidget() const

알림에서 호스팅하는 선택적 작업 위젯.

void setActionWidget(QWidget* widget)

알림에서 호스팅하는 선택적 작업 위젯.

QMargins contentMargins() const

컨트롤 콘텐츠 영역 주위에 적용되는 여백.

void setContentMargins(const QMargins& margins)

컨트롤 콘텐츠 영역 주위에 적용되는 여백.

int closeButtonSize() const

닫기 버튼의 크기입니다.

void setCloseButtonSize(int size)

닫기 버튼의 크기입니다.

QString closeButtonAccessibleName() const

아이콘 전용 닫기 버튼의 사용자 지정 접근성 이름.

void setCloseButtonAccessibleName(const QString& name)

아이콘 전용 닫기 버튼의 사용자 지정 접근성 이름.

int iconTextSpacing() const

아이콘과 텍스트 콘텐츠 사이의 간격입니다.

void setIconTextSpacing(int spacing)

아이콘과 텍스트 콘텐츠 사이의 간격입니다.

int titleMessageSpacing() const

제목과 메시지 텍스트 사이의 간격입니다.

void setTitleMessageSpacing(int spacing)

제목과 메시지 텍스트 사이의 간격입니다.

int cornerRadius() const

컴포넌트 배경에 사용되는 모서리 반경.

void setCornerRadius(int radius)

컴포넌트 배경에 사용되는 모서리 반경.

int severityIconSize() const

심각도 아이콘용으로 예약된 배경 크기.

void setSeverityIconSize(int size)

심각도 아이콘용으로 예약된 배경 크기.

int severityIconGlyphSize() const

심각도 아이콘에 사용되는 글리프 크기.

void setSeverityIconGlyphSize(int size)

심각도 아이콘에 사용되는 글리프 크기.

int severityIconBackgroundInset() const

심각도 아이콘 배경 그리기에 적용되는 인셋

void setSeverityIconBackgroundInset(int inset)

심각도 아이콘 배경 그리기에 적용되는 인셋

Typography::FontRole titleFontRole() const

제목 텍스트에 사용되는 Fluent Typography 프리셋.

void setTitleFontRole(Typography::FontRole role)

제목 텍스트에 사용되는 Fluent Typography 프리셋.

Typography::FontRole messageFontRole() const

메시지 텍스트에 사용되는 Fluent Typography 프리셋.

void setMessageFontRole(Typography::FontRole role)

메시지 텍스트에 사용되는 Fluent Typography 프리셋.

QString informationalIconGlyph() const

정보 심각도에 사용되는 아이콘 글리프

void setInformationalIconGlyph(const QString& glyph)

정보 심각도에 사용되는 아이콘 글리프

QString successIconGlyph() const

성공 심각도에 사용되는 아이콘 글리프

void setSuccessIconGlyph(const QString& glyph)

성공 심각도에 사용되는 아이콘 글리프

QString warningIconGlyph() const

경고 심각도에 사용되는 아이콘 글리프

void setWarningIconGlyph(const QString& glyph)

경고 심각도에 사용되는 아이콘 글리프

QString errorIconGlyph() const

오류 심각도에 사용되는 아이콘 글리프

void setErrorIconGlyph(const QString& glyph)

오류 심각도에 사용되는 아이콘 글리프

속성

bool isOpen

정보 표시줄이 열려 있는지 여부.

읽기 isOpen()쓰기 setIsOpen()알림 신호 isOpenChanged()
QString title

정보 표시줄에 표시되는 제목 텍스트.

읽기 title()쓰기 setTitle()알림 신호 titleChanged()
QString message

정보 표시줄에 표시되는 메시지 본문 텍스트.

읽기 message()쓰기 setMessage()알림 신호 messageChanged()
InfoBarSeverity severity

알림 색상과 아이콘에 사용되는 심각도 수준입니다.

읽기 severity()쓰기 setSeverity()알림 신호 severityChanged()
bool isClosable

닫기 요소가 표시되고 활성화되어 있는지 여부.

읽기 isClosable()쓰기 setIsClosable()알림 신호 isClosableChanged()
bool isIconVisible

심각도 아이콘 표시 여부.

읽기 isIconVisible()쓰기 setIsIconVisible()알림 신호 isIconVisibleChanged()
bool singleLine

알림에 간결한 한 줄 레이아웃을 사용할지 여부.

읽기 singleLine()쓰기 setSingleLine()알림 신호 singleLineChanged()
int preferredWidth

알림 레이아웃에서 사용하는 선호 너비.

읽기 preferredWidth()쓰기 setPreferredWidth()알림 신호 preferredWidthChanged()
int singleLineHeight

한 줄 알림 레이아웃에서 사용하는 높이

읽기 singleLineHeight()쓰기 setSingleLineHeight()알림 신호 singleLineHeightChanged()
int multiLineMinHeight

여러 줄 알림 레이아웃에 사용되는 최소 높이.

읽기 multiLineMinHeight()쓰기 setMultiLineMinHeight()알림 신호 multiLineMinHeightChanged()
int multiLineActionMinHeight

여러 줄 레이아웃에 작업 영역이 포함될 때의 최소 높이.

읽기 multiLineActionMinHeight()쓰기 setMultiLineActionMinHeight()알림 신호 multiLineActionMinHeightChanged()
QWidget* actionWidget

알림에서 호스팅하는 선택적 작업 위젯.

읽기 actionWidget()쓰기 setActionWidget()알림 신호 actionWidgetChanged()
QMargins contentMargins

컨트롤 콘텐츠 영역 주위에 적용되는 여백.

읽기 contentMargins()쓰기 setContentMargins()알림 신호 contentMarginsChanged()
int closeButtonSize

닫기 버튼의 크기입니다.

읽기 closeButtonSize()쓰기 setCloseButtonSize()알림 신호 closeButtonSizeChanged()
QString closeButtonAccessibleName

아이콘 전용 닫기 버튼의 사용자 지정 접근성 이름.

읽기 closeButtonAccessibleName()쓰기 setCloseButtonAccessibleName()알림 신호 closeButtonAccessibleNameChanged()
int iconTextSpacing

아이콘과 텍스트 콘텐츠 사이의 간격입니다.

읽기 iconTextSpacing()쓰기 setIconTextSpacing()알림 신호 iconTextSpacingChanged()
int titleMessageSpacing

제목과 메시지 텍스트 사이의 간격입니다.

읽기 titleMessageSpacing()쓰기 setTitleMessageSpacing()알림 신호 titleMessageSpacingChanged()
int cornerRadius

컴포넌트 배경에 사용되는 모서리 반경.

읽기 cornerRadius()쓰기 setCornerRadius()알림 신호 cornerRadiusChanged()
int severityIconSize

심각도 아이콘용으로 예약된 배경 크기.

읽기 severityIconSize()쓰기 setSeverityIconSize()알림 신호 severityIconSizeChanged()
int severityIconGlyphSize

심각도 아이콘에 사용되는 글리프 크기.

읽기 severityIconGlyphSize()쓰기 setSeverityIconGlyphSize()알림 신호 severityIconGlyphSizeChanged()
int severityIconBackgroundInset

심각도 아이콘 배경 그리기에 적용되는 인셋

읽기 severityIconBackgroundInset()쓰기 setSeverityIconBackgroundInset()알림 신호 severityIconBackgroundInsetChanged()
Typography::FontRole titleFontRole

제목 텍스트에 사용되는 Fluent Typography 프리셋.

읽기 titleFontRole()쓰기 setTitleFontRole()알림 신호 titleFontRoleChanged()
Typography::FontRole messageFontRole

메시지 텍스트에 사용되는 Fluent Typography 프리셋.

읽기 messageFontRole()쓰기 setMessageFontRole()알림 신호 messageFontRoleChanged()
QString informationalIconGlyph

정보 심각도에 사용되는 아이콘 글리프

읽기 informationalIconGlyph()쓰기 setInformationalIconGlyph()알림 신호 informationalIconGlyphChanged()
QString successIconGlyph

성공 심각도에 사용되는 아이콘 글리프

읽기 successIconGlyph()쓰기 setSuccessIconGlyph()알림 신호 successIconGlyphChanged()
QString warningIconGlyph

경고 심각도에 사용되는 아이콘 글리프

읽기 warningIconGlyph()쓰기 setWarningIconGlyph()알림 신호 warningIconGlyphChanged()
QString errorIconGlyph

오류 심각도에 사용되는 아이콘 글리프

읽기 errorIconGlyph()쓰기 setErrorIconGlyph()알림 신호 errorIconGlyphChanged()

시그널

void isOpenChanged(bool open)

정보 표시줄이 열려 있는지 여부.

void titleChanged(const QString& title)

정보 표시줄에 표시되는 제목 텍스트.

void messageChanged(const QString& message)

정보 표시줄에 표시되는 메시지 본문 텍스트.

void severityChanged(InfoBarSeverity severity)

알림 색상과 아이콘에 사용되는 심각도 수준입니다.

void isClosableChanged(bool closable)

닫기 요소가 표시되고 활성화되어 있는지 여부.

void isIconVisibleChanged(bool visible)

심각도 아이콘 표시 여부.

void singleLineChanged(bool singleLine)

알림에 간결한 한 줄 레이아웃을 사용할지 여부.

void preferredWidthChanged(int width)

알림 레이아웃에서 사용하는 선호 너비.

void singleLineHeightChanged(int height)

한 줄 알림 레이아웃에서 사용하는 높이

void multiLineMinHeightChanged(int height)

여러 줄 알림 레이아웃에 사용되는 최소 높이.

void multiLineActionMinHeightChanged(int height)

여러 줄 레이아웃에 작업 영역이 포함될 때의 최소 높이.

void actionWidgetChanged(QWidget* widget)

알림에서 호스팅하는 선택적 작업 위젯.

void contentMarginsChanged(const QMargins& margins)

컨트롤 콘텐츠 영역 주위에 적용되는 여백.

void closeButtonSizeChanged(int size)

닫기 버튼의 크기입니다.

void closeButtonAccessibleNameChanged(const QString& name)

아이콘 전용 닫기 버튼의 사용자 지정 접근성 이름.

void iconTextSpacingChanged(int spacing)

아이콘과 텍스트 콘텐츠 사이의 간격입니다.

void titleMessageSpacingChanged(int spacing)

제목과 메시지 텍스트 사이의 간격입니다.

void cornerRadiusChanged(int radius)

컴포넌트 배경에 사용되는 모서리 반경.

void severityIconSizeChanged(int size)

심각도 아이콘용으로 예약된 배경 크기.

void severityIconGlyphSizeChanged(int size)

심각도 아이콘에 사용되는 글리프 크기.

void severityIconBackgroundInsetChanged(int inset)

심각도 아이콘 배경 그리기에 적용되는 인셋

void titleFontRoleChanged(Typography::FontRole role)

제목 텍스트에 사용되는 Fluent Typography 프리셋.

void messageFontRoleChanged(Typography::FontRole role)

메시지 텍스트에 사용되는 Fluent Typography 프리셋.

void informationalIconGlyphChanged(const QString& glyph)

정보 심각도에 사용되는 아이콘 글리프

void successIconGlyphChanged(const QString& glyph)

성공 심각도에 사용되는 아이콘 글리프

void warningIconGlyphChanged(const QString& glyph)

경고 심각도에 사용되는 아이콘 글리프

void errorIconGlyphChanged(const QString& glyph)

오류 심각도에 사용되는 아이콘 글리프

PySide6 확장

takeActionWidget()

현재 동작 위젯을 분리하고 소유권을 Python에 넘겨 반환합니다.

보호된 멤버

메서드

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 기본 클래스 문서: QWidget