QToolBox Class
QToolBox 클래스는 탭 위젯 항목의 열을 제공합니다. 더 보기...
Header: | #include <QToolBox> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
qmake: | QT += widgets |
상속합니다: | QFrame |
속성
- count : const int
- currentIndex : int
공용 기능
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 |
상세 설명
도구 상자는 탭 열을 서로 위에 표시하는 위젯으로, 현재 항목이 현재 탭 아래에 표시됩니다. 모든 탭에는 탭 열 내에 인덱스 위치가 있습니다. 탭의 항목은 QWidget.
각 항목에는 itemText(), itemIcon(), itemToolTip() 및 widget()이 있습니다. setItemText (), setItemIcon() 및 setItemToolTip()를 사용하여 항목의 속성을 변경할 수 있습니다. 각 항목은 setItemEnabled()를 사용하여 개별적으로 활성화 또는 비활성화할 수 있습니다.
addItem()를 사용하여 항목을 추가하거나 insertItem()를 사용하여 특정 위치에 삽입할 수 있습니다. 총 항목 수는 count()로 지정합니다. 항목은 삭제를 사용하여 삭제하거나 removeItem()를 사용하여 도구 상자에서 제거할 수 있습니다. removeItem ()와 insertItem()를 결합하면 항목을 다른 위치로 이동할 수 있습니다.
현재 항목 위젯의 색인은 currentIndex()로 반환되며 setCurrentIndex()로 설정할 수 있습니다. 특정 항목의 인덱스는 indexOf()를 사용하여 찾을 수 있으며, 지정된 인덱스의 항목은 item()으로 반환됩니다.
현재 항목이 변경되면 currentChanged() 신호가 전송됩니다.
QTabWidget 를참조하세요 .
속성 문서
[read-only]
count : const int
이 속성은 도구 상자에 포함된 항목의 수를 저장합니다.
기본적으로 이 속성의 값은 0입니다.
함수 액세스:
int | count() const |
currentIndex : int
이 속성은 현재 항목의 인덱스를 저장합니다.
기본적으로 빈 도구 상자의 경우 이 속성의 값은 -1입니다.
함수에 액세스합니다:
int | currentIndex() const |
void | setCurrentIndex(int index) |
알림 신호:
void | currentChanged(int index) |
멤버 함수 문서
[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.
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)
index 위치에 widget 을 삽입하거나 index 이 범위를 벗어난 경우 도구 상자 하단에 삽입합니다. 새 항목의 텍스트는 text 로 설정되고 icon 은 text 의 왼쪽에 표시됩니다. 새 항목의 색인을 반환합니다.
int QToolBox::insertItem(int index, QWidget *widget, const QString &text)
과부하가 걸린 기능입니다.
index 위치에 widget 을 삽입하거나 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 이 참이면 위치 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 * 이벤트).
QWidget *QToolBox::widget(int index) const
위치 index, 또는 해당 항목이 없는 경우 nullptr
에 위젯을 반환합니다.
© 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.