QToolBar Class

QToolBar 클래스는 일련의 컨트롤이 포함된 이동식 패널을 제공합니다. 더 보기...

Header: #include <QToolBar>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
상속합니다: QWidget

속성

공용 기능

QToolBar(QWidget *parent = nullptr)
QToolBar(const QString &title, QWidget *parent = nullptr)
virtual ~QToolBar()
QAction *actionAt(const QPoint &p) const
QAction *actionAt(int x, int y) const
QAction *addSeparator()
QAction *addWidget(QWidget *widget)
Qt::ToolBarAreas allowedAreas() const
void clear()
QSize iconSize() const
QAction *insertSeparator(QAction *before)
QAction *insertWidget(QAction *before, QWidget *widget)
bool isAreaAllowed(Qt::ToolBarArea area) const
bool isFloatable() const
bool isFloating() const
bool isMovable() const
Qt::Orientation orientation() const
void setAllowedAreas(Qt::ToolBarAreas areas)
void setFloatable(bool floatable)
void setMovable(bool movable)
void setOrientation(Qt::Orientation orientation)
QAction *toggleViewAction() const
Qt::ToolButtonStyle toolButtonStyle() const
QWidget *widgetForAction(QAction *action) const

공용 슬롯

void setIconSize(const QSize &iconSize)
void setToolButtonStyle(Qt::ToolButtonStyle toolButtonStyle)

신호

void actionTriggered(QAction *action)
void allowedAreasChanged(Qt::ToolBarAreas allowedAreas)
void iconSizeChanged(const QSize &iconSize)
void movableChanged(bool movable)
void orientationChanged(Qt::Orientation orientation)
void toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)
void topLevelChanged(bool topLevel)
void visibilityChanged(bool visible)

재구현된 보호 기능

virtual void actionEvent(QActionEvent *event) override
virtual void changeEvent(QEvent *event) override
virtual bool event(QEvent *event) override
virtual void paintEvent(QPaintEvent *event) override

상세 설명

툴바는 일반적으로 QMainWindow::addToolBar(const QString &title)을 호출하여 생성되지만, 예를 들어 QVBoxLayout 에서 첫 번째 위젯으로 추가할 수도 있습니다.

툴바 버튼은 addAction() 또는 insertAction()를 사용하여 액션을 추가하여 추가합니다. addSeparator () 또는 insertSeparator()를 사용하여 버튼 그룹을 구분할 수 있습니다. 툴바 버튼이 적절하지 않은 경우에는 addWidget() 또는 insertWidget()를 사용하여 위젯을 대신 삽입할 수 있습니다. 적합한 위젯의 예는 QSpinBox, QDoubleSpinBox, QComboBox 입니다. 툴바 버튼을 누르면 actionTriggered() 신호를 내보냅니다.

툴바는 특정 영역(예: 창 상단)에 고정하거나 툴바 영역 간에 이동할 수 있습니다( setMovable(), isMovable(), allowedAreas() 및 isAreaAllowed() 참조).

툴바의 크기가 너무 작아서 포함된 모든 항목을 표시할 수 없을 정도로 크기가 조정된 경우 확장 버튼이 툴바의 마지막 항목으로 나타납니다. 확장 버튼을 누르면 현재 도구 모음에 맞지 않는 항목이 포함된 메뉴가 팝업됩니다.

QToolBar가 QMainWindow 의 자식이 아닌 경우 addWidget()을 사용하여 도구 모음에 추가된 위젯으로 확장 팝업을 채울 수 있는 기능이 사라집니다. 대신 QWidgetAction 을 상속하고 QWidgetAction::createWidget()을 구현하여 만든 위젯 동작을 사용하세요.

QToolButton, QMenu, QAction참조하세요 .

속성 문서

allowedAreas : Qt::ToolBarAreas

툴바를 배치할 수 있는 영역

기본값은 Qt::AllToolBarAreas 입니다.

이 속성은 툴바가 QMainWindow 에 있는 경우에만 의미가 있습니다.

액세스 기능에 있는 경우에만 적용됩니다:

Qt::ToolBarAreas allowedAreas() const
void setAllowedAreas(Qt::ToolBarAreas areas)

알림 신호:

void allowedAreasChanged(Qt::ToolBarAreas allowedAreas)

movable참조하세요 .

floatable : bool

이 속성은 도구 모음을 독립된 창으로 끌어서 놓을 수 있는지 여부를 나타냅니다.

기본값은 true입니다.

액세스 기능:

bool isFloatable() const
void setFloatable(bool floatable)

[read-only] floating : const bool

이 속성은 툴바가 독립 창인지 여부를 저장합니다.

기본적으로 이 속성은 true 입니다.

함수에 액세스합니다:

bool isFloating() const

QWidget::isWindow()도 참조하세요 .

iconSize : QSize

도구 모음에 있는 아이콘의 크기입니다.

기본 크기는 애플리케이션의 스타일에 따라 결정되며 QStyle::PM_ToolBarIconSize 픽셀 메트릭에서 파생됩니다. 이는 아이콘이 가질 수 있는 최대 크기입니다. 이보다 작은 크기의 아이콘은 확대되지 않습니다.

기능에 액세스합니다:

QSize iconSize() const
void setIconSize(const QSize &iconSize)

알림 신호:

void iconSizeChanged(const QSize &iconSize)

movable : bool

이 속성은 사용자가 도구 모음 영역 내에서 도구 모음을 이동할 수 있는지 또는 도구 모음 영역 간에 도구 모음을 이동할 수 있는지를 저장합니다.

기본적으로 이 속성은 true 입니다.

이 속성은 툴바가 QMainWindow 에 있는 경우에만 의미가 있습니다.

액세스 기능에 있는 경우에만 의미가 있습니다:

bool isMovable() const
void setMovable(bool movable)

알림 신호:

void movableChanged(bool movable)

allowedAreas참조하세요 .

orientation : Qt::Orientation

도구 모음의 방향

기본값은 Qt::Horizontal 입니다.

툴바가 QMainWindow 에서 관리되는 경우에는 이 기능을 사용해서는 안 됩니다. 기본 창에 이미 추가된 툴바를 다른 Qt::ToolBarArea 으로 이동하려면 QMainWindow::addToolBar() 또는 QMainWindow::insertToolBar()을 사용할 수 있습니다.

기능에 액세스합니다:

Qt::Orientation orientation() const
void setOrientation(Qt::Orientation orientation)

알림 신호:

void orientationChanged(Qt::Orientation orientation)

toolButtonStyle : Qt::ToolButtonStyle

이 속성은 도구 모음 버튼의 스타일을 보유합니다.

이 속성은 QActions로 추가되는 모든 도구 버튼의 스타일을 정의합니다. addWidget() 메서드를 사용하여 QToolButton 을 추가하면 이 버튼 스타일이 적용되지 않습니다.

도구 버튼의 스타일을 시스템 설정을 따르게 하려면 이 속성을 Qt::ToolButtonFollowStyle 로 설정합니다. Unix에서는 데스크톱 환경의 사용자 설정이 사용됩니다. 다른 플랫폼에서는 Qt::ToolButtonFollowStyle 은 아이콘만 의미합니다.

기본값은 Qt::ToolButtonIconOnly 입니다.

기능에 접근합니다:

Qt::ToolButtonStyle toolButtonStyle() const
void setToolButtonStyle(Qt::ToolButtonStyle toolButtonStyle)

통지기 신호:

void toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)

멤버 기능 문서

[explicit] QToolBar::QToolBar(QWidget *parent = nullptr)

주어진 parent 으로 QToolBar를 구축합니다.

[explicit] QToolBar::QToolBar(const QString &title, QWidget *parent = nullptr)

주어진 parent 로 QToolBar를 구축합니다.

주어진 창 title 은 툴바를 식별하며 QMainWindow 에서 제공하는 컨텍스트 메뉴에 표시됩니다.

setWindowTitle()도 참조하십시오 .

[virtual noexcept] QToolBar::~QToolBar()

툴바를 삭제합니다.

QAction *QToolBar::actionAt(const QPoint &p) const

p 지점의 액션을 반환합니다. 액션을 찾지 못하면 이 함수는 0을 반환합니다.

QWidget::childAt()도 참조하세요 .

QAction *QToolBar::actionAt(int x, int y) const

이 함수는 오버로드된 함수입니다.

x, y 지점의 액션을 반환합니다. 이 함수는 액션을 찾을 수 없으면 0을 반환합니다.

[override virtual protected] void QToolBar::actionEvent(QActionEvent *event)

다시 구현합니다: QWidget::actionEvent(QActionEvent * 이벤트).

[signal] void QToolBar::actionTriggered(QAction *action)

이 신호는 이 툴바의 작업이 트리거될 때 발생합니다. 이는 작업의 도구 버튼을 누르거나 도구 모음 외부에서 다른 방식으로 작업이 트리거될 때 발생합니다. 이 매개변수는 트리거된 action 을 보유합니다.

QAction *QToolBar::addSeparator()

도구 모음 끝에 구분 기호를 추가합니다.

insertSeparator()도 참조하세요 .

QAction *QToolBar::addWidget(QWidget *widget)

지정된 widget 을 툴바의 마지막 항목으로 툴바에 추가합니다.

툴바는 widget 의 소유권을 갖습니다.

이 방법으로 QToolButton 을 추가하면 툴바의 Qt::ToolButtonStyle 은 존중되지 않습니다.

참고: 위젯의 표시 여부를 변경하려면 QAction::setVisible()를 사용해야 합니다. QWidget::setVisible (), QWidget::show() 및 QWidget::hide()를 사용하면 작동하지 않습니다.

insertWidget()도 참조하세요 .

[signal] void QToolBar::allowedAreasChanged(Qt::ToolBarAreas allowedAreas)

이 신호는 툴바에 허용되는 영역 컬렉션이 변경될 때 발생합니다. 툴바를 배치할 수 있는 새 영역은 allowedAreas 에 의해 지정됩니다.

참고: 속성에 대한 알림 신호 allowedAreas.

allowedAreas참조하세요 .

[override virtual protected] void QToolBar::changeEvent(QEvent *event)

다시 구현합니다: QWidget::changeEvent(QEvent * 이벤트).

void QToolBar::clear()

도구 모음에서 모든 작업을 제거합니다.

removeAction()도 참조하세요 .

[override virtual protected] bool QToolBar::event(QEvent *event)

다시 구현합니다: QWidget::event(QEvent * 이벤트).

[signal] void QToolBar::iconSizeChanged(const QSize &iconSize)

이 신호는 아이콘 크기가 변경될 때 발생합니다. iconSize 매개변수에는 툴바의 새 아이콘 크기가 저장됩니다.

참고: 속성 iconSize 에 대한 알림 신호입니다.

iconSizeQMainWindow::iconSize참조하세요 .

QAction *QToolBar::insertSeparator(QAction *before)

before 작업과 연결된 도구 모음 항목 앞에 도구 모음에 구분 기호를 삽입합니다.

addSeparator()도 참조하세요 .

QAction *QToolBar::insertWidget(QAction *before, QWidget *widget)

before 작업과 연결된 도구 모음 항목 앞에 지정된 widget 을 삽입합니다.

참고: 위젯의 가시성을 변경하려면 QAction::setVisible()를 사용해야 합니다. QWidget::setVisible (), QWidget::show() 및 QWidget::hide()를 사용하면 작동하지 않습니다.

addWidget()도 참조하세요 .

bool QToolBar::isAreaAllowed(Qt::ToolBarArea area) const

이 툴바가 지정된 area 에 도킹할 수 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

[signal] void QToolBar::movableChanged(bool movable)

이 신호는 툴바가 움직이거나 고정될 때 발생합니다. 툴바를 이동할 수 있으면 movable 은 참이고, 그렇지 않으면 거짓입니다.

참고: 속성에 대한 알림 신호 movable.

movable도 참조하세요 .

[signal] void QToolBar::orientationChanged(Qt::Orientation orientation)

이 신호는 툴바의 방향이 변경될 때 발생합니다. orientation 매개변수는 툴바의 새 방향을 유지합니다.

참고: 속성 orientation 에 대한 알림 신호입니다.

orientation참조하세요 .

[override virtual protected] void QToolBar::paintEvent(QPaintEvent *event)

다시 구현합니다: QWidget::paintEvent(QPaintEvent * 이벤트).

QAction *QToolBar::toggleViewAction() const

이 툴바를 표시하거나 숨기는 데 사용할 수 있는 체크 가능한 액션을 반환합니다.

액션의 텍스트는 툴바의 창 제목으로 설정됩니다.

QAction::textQWidget::windowTitle참조하세요 .

[signal] void QToolBar::toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)

이 신호는 도구 버튼 스타일이 변경될 때 발생합니다. toolButtonStyle 매개변수에는 도구 모음의 새 도구 버튼 스타일이 저장됩니다.

참고: 속성 toolButtonStyle 에 대한 알림 신호입니다.

toolButtonStyleQMainWindow::toolButtonStyle참조하세요 .

[signal] void QToolBar::topLevelChanged(bool topLevel)

이 신호는 floating 속성이 변경될 때 발생합니다. topLevel 매개 변수는 툴바가 현재 부동 상태이면 참이고, 그렇지 않으면 거짓입니다.

isWindow()도 참조하세요 .

[signal] void QToolBar::visibilityChanged(bool visible)

이 신호는 툴바가 visible (또는 보이지 않음)이 될 때 발생합니다. 위젯이 숨겨지거나 표시될 때 발생합니다.

QWidget *QToolBar::widgetForAction(QAction *action) const

지정된 action 과 연결된 위젯을 반환합니다.

addWidget()도 참조하세요 .

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.