이 페이지에서

QToolBox Class

QToolBox 클래스는 탭이 있는 위젯 항목들로 구성된 열을 제공합니다. 더 보기...

헤더: #include <QToolBox>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
상속: QFrame

속성

공개 함수

QToolBox(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
virtual ~QToolBox()
int addItem(QWidget *widget, const QIcon &iconSet, const QString &text)
int addItem(QWidget *w, const QString &text)
int count() const
int currentIndex() const
QWidget *currentWidget() const
int indexOf(const QWidget *widget) const
int insertItem(int index, QWidget *widget, const QIcon &icon, const QString &text)
int insertItem(int index, QWidget *widget, const QString &text)
bool isItemEnabled(int index) const
QIcon itemIcon(int index) const
QString itemText(int index) const
QString itemToolTip(int index) const
void removeItem(int index)
void setItemEnabled(int index, bool enabled)
void setItemIcon(int index, const QIcon &icon)
void setItemText(int index, const QString &text)
void setItemToolTip(int index, const QString &toolTip)
QWidget *widget(int index) const

공개 슬롯

void setCurrentIndex(int index)
void setCurrentWidget(QWidget *widget)

신호

void currentChanged(int index)

보호된 함수

virtual void itemInserted(int index)
virtual void itemRemoved(int index)

재구현된 보호된 함수

virtual void changeEvent(QEvent *ev) override
virtual bool event(QEvent *e) override
virtual void showEvent(QShowEvent *e) override

상세 설명

툴박스(toolbox)는 탭 열을 위아래로 나란히 표시하는 위젯으로, 현재 탭 아래에는 해당 탭의 항목이 표시됩니다. 각 탭은 탭 열 내에서 인덱스 위치를 갖습니다. 탭의 항목은 QWidget 입니다.

각 항목에는 ` itemText()` 메서드, 선택 사항인 ` itemIcon()` 메서드, 선택 사항인 ` itemToolTip()` 메서드, 그리고 ` widget()` 메서드가 있습니다. 항목의 속성은 ` setItemText()` 메서드, ` setItemIcon()` 메서드, ` setItemToolTip()` 메서드를 사용하여 변경할 수 있습니다. 각 항목은 ` setItemEnabled()` 메서드를 사용하여 개별적으로 활성화하거나 비활성화할 수 있습니다.

항목은 addItem()를 사용하여 추가하거나, insertItem()를 사용하여 특정 위치에 삽입할 수 있습니다. 항목의 총 개수는 count()로 확인할 수 있습니다. 항목은 delete를 사용하여 삭제하거나, removeItem()를 사용하여 도구 상자에서 제거할 수 있습니다. removeItem()와 insertItem()를 함께 사용하면 항목을 다른 위치로 이동할 수 있습니다.

현재 항목 위젯의 인덱스는 currentIndex() 함수를 통해 반환되며, setCurrentIndex() 함수를 사용하여 설정할 수 있습니다. 특정 항목의 인덱스는 indexOf() 함수를 사용하여 찾을 수 있으며, 주어진 인덱스에 있는 항목은 item() 함수를 통해 반환됩니다.

currentChanged() 신호는 현재 항목이 변경될 때 발생합니다.

QTabWidget도 참조하십시오 .

속성 문서

[read-only] count : int

이 속성은 도구 상자에 포함된 항목의 수를 나타냅니다.

기본적으로 이 속성의 값은 0입니다.

액세스 함수:

int count() const

currentIndex : int

이 속성은 현재 항목의 인덱스를 저장합니다.

기본적으로, 빈 툴박스의 경우 이 속성의 값은 -1입니다.

액세스 함수:

int currentIndex() const
void setCurrentIndex(int index)

알림 신호:

void currentChanged(int index)

indexOf() 및 widget()도 참조하십시오 .

멤버 함수 설명서

[explicit] QToolBox::QToolBox(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

지정된 parent 와 플래그 f 를 사용하여 새로운 툴박스를 생성합니다.

[virtual noexcept] QToolBox::~QToolBox()

도구 상자를 파괴합니다.

int QToolBox::addItem(QWidget *widget, const QIcon &iconSet, const QString &text)

툴박스 하단에 새 탭으로 ‘ widget ’을 추가합니다. 새 탭의 텍스트는 text 로 설정되며, ‘ iconSet ’은 ‘ text ’의 왼쪽에 표시됩니다. 새 탭의 인덱스를 반환합니다.

int QToolBox::addItem(QWidget *w, const QString &text)

툴박스 하단에 새 탭을 생성하여 ‘ w ’ 위젯을 추가합니다. 새 탭의 텍스트는 ‘ text ’로 설정됩니다. 새 탭의 인덱스를 반환합니다.

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

[override virtual protected] void QToolBox::changeEvent(QEvent *ev)

QFrame::changeEvent(QEvent *ev)를 재구현합니다.

[signal] void QToolBox::currentChanged(int index)

이 신호는 현재 항목이 변경될 때 발생합니다. 새로운 현재 항목의 인덱스가 ` index`에 전달되며, 현재 항목이 없는 경우에는 -1이 전달됩니다.

참고: 속성 currentIndex 에 대한Notifier 신호입니다.

QWidget *QToolBox::currentWidget() const

현재 위젯에 대한 포인터를 반환하며, 해당 항목이 없는 경우 nullptr 를 반환합니다.

currentIndex() 및 setCurrentWidget()도 참조하십시오 .

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

QFrame::event(QEvent *e)를 재구현합니다.

int QToolBox::indexOf(const QWidget *widget) const

widget 의 인덱스를 반환하며, 해당 항목이 존재하지 않으면 -1을 반환합니다.

int QToolBox::insertItem(int index, QWidget *widget, const QIcon &icon, const QString &text)

widget 을 위치 index 에 삽입하거나, index 가 허용 범위를 벗어날 경우 툴박스 하단에 삽입합니다. 새 항목의 텍스트는 text 로 설정되며, icon 는 text 의 왼쪽에 표시됩니다. 새 항목의 인덱스를 반환합니다.

int QToolBox::insertItem(int index, QWidget *widget, const QString &text)

widget 를 위치 index 에 삽입하거나, index 가 범위를 벗어날 경우 툴박스 하단에 삽입합니다. 새 항목의 텍스트는 text 로 설정됩니다. 새 항목의 인덱스를 반환합니다.

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

bool QToolBox::isItemEnabled(int index) const

index 위치에 있는 항목이 활성화되어 있으면 ` true `을 반환하고, 그렇지 않으면 ` false`을 반환합니다.

QIcon QToolBox::itemIcon(int index) const

index 위치에 있는 항목의 아이콘을 반환하거나, index 가 허용 범위를 벗어난 경우 null 아이콘을 반환합니다.

setItemIcon()도 참조하십시오 .

[virtual protected] void QToolBox::itemInserted(int index)

이 가상 핸들러는 위치 index 에 새 항목이 추가되거나 삽입된 후에 호출됩니다.

itemRemoved()도 참조하십시오 .

[virtual protected] void QToolBox::itemRemoved(int index)

이 가상 핸들러는 위치 index 에서 항목이 제거된 후에 호출됩니다.

itemInserted()도 참조하십시오 .

QString QToolBox::itemText(int index) const

index 위치에 있는 항목의 텍스트를 반환하며, index 가 범위를 벗어난 경우에는 빈 문자열을 반환합니다.

setItemText()도 참조하십시오 .

QString QToolBox::itemToolTip(int index) const

index 위치에 있는 아이템의 툴팁을 반환하며, index 가 허용 범위를 벗어난 경우에는 빈 문자열을 반환합니다.

setItemToolTip()도 참조하십시오 .

void QToolBox::removeItem(int index)

index 위치에 있는 항목을 툴박스에서 제거합니다. 위젯은 삭제되지 않는다는 점에 유의하십시오.

[slot] void QToolBox::setCurrentWidget(QWidget *widget)

widget 를 현재 위젯으로 설정합니다. widget 는 이 도구 상자에 포함된 항목이어야 합니다.

addItem(), setCurrentIndex(), currentWidget()도 참조하십시오 .

void QToolBox::setItemEnabled(int index, bool enabled)

enabled 가 true인 경우, 위치 index 에 있는 항목이 활성화되고, 그렇지 않은 경우 위치 index 에 있는 항목이 비활성화됩니다.

isItemEnabled()도 참조하십시오 .

void QToolBox::setItemIcon(int index, const QIcon &icon)

index 위치에 있는 항목의 아이콘을 icon 로 설정합니다.

itemIcon()도 참조하십시오 .

void QToolBox::setItemText(int index, const QString &text)

index 위치에 있는 항목의 텍스트를 text 로 설정합니다.

지정된 텍스트에 앰퍼샌드 문자('&')가 포함되어 있으면, 해당 항목에 대한 단축키가 자동으로 생성됩니다. '&' 뒤에 오는 문자가 단축키로 사용됩니다. 기존에 정의된 단축키는 덮어쓰게 되며, 텍스트에 단축키가 정의되어 있지 않은 경우 단축키는 삭제됩니다. 자세한 내용은 QShortcut 문서를 참조하십시오(실제 앰퍼샌드 기호를 표시하려면 '&&'를 사용하십시오).

itemText()도 참조하십시오 .

void QToolBox::setItemToolTip(int index, const QString &toolTip)

index 위치에 있는 아이템의 툴팁을 toolTip 로 설정합니다.

itemToolTip()도 참조하십시오 .

[override virtual protected] void QToolBox::showEvent(QShowEvent *e)

QWidget::showEvent(QShowEvent *event)를 재구현합니다.

QWidget *QToolBox::widget(int index) const

index 위치에 있는 위젯을 반환하며, 해당 항목이 없는 경우 nullptr 을 반환합니다.

© 2026 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.