상태 및 정보
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);import fluentqt
info = fluentqt.InfoBar()
info.setSeverity(fluentqt.InfoBar.InfoBarSeverity.Informational)
info.setTitle("Update available")
info.setMessage("Version 3.2 is ready.")
success = fluentqt.InfoBar()
success.setSeverity(fluentqt.InfoBar.InfoBarSeverity.Success)
success.setTitle("Saved")
success.setMessage("All changes were saved.")
warning = fluentqt.InfoBar()
warning.setSeverity(fluentqt.InfoBar.InfoBarSeverity.Warning)
warning.setTitle("Storage almost full")
warning.setMessage("Clear space before syncing.")
error = fluentqt.InfoBar()
error.setSeverity(fluentqt.InfoBar.InfoBarSeverity.Error)
error.setTitle("Upload failed")
error.setMessage("The document could not be saved.")API
선언 보기일치하는 API 멤버가 없습니다.
fluent::status_info::InfoBar
상속 대상 QWidget · FluentElement · QMLPlus
심각도 수준, 선택적 작업 위젯 및 닫기 버튼을 지원하는 Fluent 인라인 알림 표시줄입니다. 상태 스타일과 열림/닫힘 상태로 제목과 메시지를 표시합니다.
생성자
소멸자
열거형
enum InfoBarSeverityInformationalSuccessWarningError
메서드
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 = 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 기본 클래스 문서: QWidget