QTabBar Class
QTabBar 클래스는 탭이 있는 대화 상자 등에서 사용할 수 있는 탭 바를 제공합니다. 더 보기...
| 헤더: | #include <QTabBar> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QWidget |
공개 유형
| enum | ButtonPosition { LeftSide, RightSide } |
| enum | SelectionBehavior { SelectLeftTab, SelectRightTab, SelectPreviousTab } |
| enum | Shape { RoundedNorth, RoundedSouth, RoundedWest, RoundedEast, TriangularNorth, …, TriangularEast } |
속성
|
|
공개 함수
| QTabBar(QWidget *parent = nullptr) | |
| virtual | ~QTabBar() |
| QString | accessibleTabName(int index) const |
| int | addTab(const QString &text) |
| int | addTab(const QIcon &icon, const QString &text) |
| bool | autoHide() const |
| bool | changeCurrentOnDrag() const |
| int | count() const |
| int | currentIndex() const |
| bool | documentMode() const |
| bool | drawBase() const |
| Qt::TextElideMode | elideMode() const |
| bool | expanding() const |
| QSize | iconSize() const |
| int | insertTab(int index, const QString &text) |
| int | insertTab(int index, const QIcon &icon, const QString &text) |
| bool | isMovable() const |
| bool | isTabEnabled(int index) const |
| bool | isTabVisible(int index) const |
| void | moveTab(int from, int to) |
| void | removeTab(int index) |
| QTabBar::SelectionBehavior | selectionBehaviorOnRemove() const |
| void | setAccessibleTabName(int index, const QString &name) |
| void | setAutoHide(bool hide) |
| void | setChangeCurrentOnDrag(bool change) |
| void | setDocumentMode(bool set) |
| void | setDrawBase(bool drawTheBase) |
| void | setElideMode(Qt::TextElideMode mode) |
| void | setExpanding(bool enabled) |
| void | setIconSize(const QSize &size) |
| void | setMovable(bool movable) |
| void | setSelectionBehaviorOnRemove(QTabBar::SelectionBehavior behavior) |
| void | setShape(QTabBar::Shape shape) |
| void | setTabButton(int index, QTabBar::ButtonPosition position, QWidget *widget) |
| void | setTabData(int index, const QVariant &data) |
| void | setTabEnabled(int index, bool enabled) |
| void | setTabIcon(int index, const QIcon &icon) |
| void | setTabText(int index, const QString &text) |
| void | setTabTextColor(int index, const QColor &color) |
| void | setTabToolTip(int index, const QString &tip) |
| void | setTabVisible(int index, bool visible) |
| void | setTabWhatsThis(int index, const QString &text) |
| void | setTabsClosable(bool closable) |
| void | setUsesScrollButtons(bool useButtons) |
| QTabBar::Shape | shape() const |
| int | tabAt(const QPoint &position) const |
| QWidget * | tabButton(int index, QTabBar::ButtonPosition position) const |
| QVariant | tabData(int index) const |
| QIcon | tabIcon(int index) const |
| QRect | tabRect(int index) const |
| QString | tabText(int index) const |
| QColor | tabTextColor(int index) const |
| QString | tabToolTip(int index) const |
| QString | tabWhatsThis(int index) const |
| bool | tabsClosable() const |
| bool | usesScrollButtons() const |
재구현된 공용 함수
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
공개 슬롯
| void | setCurrentIndex(int index) |
신호
| void | currentChanged(int index) |
| void | tabBarClicked(int index) |
| void | tabBarDoubleClicked(int index) |
| void | tabCloseRequested(int index) |
| void | tabMoved(int from, int to) |
보호된 함수
| virtual void | initStyleOption(QStyleOptionTab *option, int tabIndex) const |
| virtual QSize | minimumTabSizeHint(int index) const |
| virtual void | tabInserted(int index) |
| virtual void | tabLayoutChange() |
| virtual void | tabRemoved(int index) |
| virtual QSize | tabSizeHint(int index) const |
재구현된 보호 함수
| virtual void | changeEvent(QEvent *event) override |
| virtual bool | event(QEvent *event) override |
| virtual void | hideEvent(QHideEvent *) override |
| virtual void | keyPressEvent(QKeyEvent *event) override |
| virtual void | mouseDoubleClickEvent(QMouseEvent *event) override |
| virtual void | mouseMoveEvent(QMouseEvent *event) override |
| virtual void | mousePressEvent(QMouseEvent *event) override |
| virtual void | mouseReleaseEvent(QMouseEvent *event) override |
| virtual void | paintEvent(QPaintEvent *) override |
| virtual void | resizeEvent(QResizeEvent *) override |
| virtual void | showEvent(QShowEvent *) override |
| virtual void | timerEvent(QTimerEvent *event) override |
| virtual void | wheelEvent(QWheelEvent *event) override |
상세 설명
QTabBar는 사용법이 간단합니다. 미리 정의된 shapes 중 하나를 사용하여 탭을 그리며, 탭이 선택되면 신호를 발생시킵니다. 서브클래스를 만들어 외관과 동작을 맞춤 설정할 수 있습니다. Qt는 또한 기성 QTabWidget 을 제공합니다.
각 탭에는 tabText(), 선택 사항인 tabIcon(), 선택 사항인 tabToolTip(), 선택 사항인 tabWhatsThis() 및 선택 사항인 tabData()가 있습니다. 탭의 속성은 setTabText(), setTabIcon(), setTabToolTip(), setTabWhatsThis 및 setTabData()를 사용하여 변경할 수 있습니다. 각 탭은 setTabEnabled()를 사용하여 개별적으로 활성화하거나 비활성화할 수 있습니다.
각 탭은 고유한 색상으로 텍스트를 표시할 수 있습니다. 탭의 현재 텍스트 색상은 tabTextColor() 함수를 사용하여 확인할 수 있습니다. 특정 탭의 텍스트 색상은 setTabTextColor()를 사용하여 설정할 수 있습니다.
탭은 ` addTab()`를 사용하여 추가하거나, ` insertTab()`를 사용하여 특정 위치에 삽입할 수 있습니다. 탭의 총 개수는 ` count()`로 확인할 수 있습니다. 탭은 ` removeTab()`를 사용하여 탭 바에서 제거할 수 있습니다. ` removeTab()`와 ` insertTab()`를 함께 사용하면 탭을 다른 위치로 이동할 수 있습니다.
shape 속성은 탭의 모양을 정의합니다. 모양 선택은 취향에 따라 다르지만, 탭이 있는 대화 상자(환경 설정 등)에서는 예외 없이 RoundedNorth 를 사용합니다. 대화 상자 이외의 창에 있는 탭 컨트롤은 거의 항상 RoundedSouth 또는 TriangularSouth 중 하나를 사용합니다. 모든 페이지가 본질적으로 유사한 많은 스프레드시트 및 기타 탭 컨트롤은 TriangularSouth 를 사용하는 반면, RoundedSouth 는 페이지가 서로 다른 경우(예: 다중 페이지 도구 팔레트)에 주로 사용됩니다. QTabBar의 기본값은 RoundedNorth 입니다.
QTabBar API에서 가장 중요한 부분은 currentChanged() 신호입니다. 이 신호는 현재 탭이 변경될 때마다(시작 시 현재 탭이 'none'에서 변경될 때도 포함) 발생합니다. 또한 setCurrentIndex() 슬롯이 있어, 이를 통해 프로그래밍 방식으로 탭을 선택할 수 있습니다. currentIndex() 함수는 현재 탭의 인덱스를 반환하며, count 는 탭의 개수를 저장합니다.
QTabBar는 QAbstractButton 방식에 따라 자동 니모닉 키를 생성합니다. 예를 들어, 탭의 레이블이 "&Graphics"인 경우, Alt+G는 해당 탭으로 전환하는 단축키가 됩니다.
각 탭의 모양과 느낌을 맞춤 설정하거나 추가 데이터를 저장하기 위해서는 다음 가상 함수를 재구현해야 할 수 있습니다:
- tabSizeHint()는 탭의 크기를 계산합니다.
- tabInserted()는 새 탭이 추가되었음을 알립니다.
- tabRemoved()는 탭이 제거되었음을 알립니다.
- tabLayoutChange() 탭의 레이아웃이 재조정되었음을 알립니다.
- paintEvent()는 모든 탭을 그립니다.
파생 클래스의 경우, 단일 탭의 시각적 기하학적 구조를 반환하는 tabRect() 함수가 필요할 수도 있습니다.
![]() | Fusion 위젯 스타일로 표시된 탭 바. |
![]() | Fusion 위젯 스타일로 표시된 잘린 탭 바. |
QTabWidget도 참조하십시오 .
멤버 유형 문서
enum QTabBar::ButtonPosition
이 열거형 유형은 탭에서 위젯의 위치를 나열합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QTabBar::LeftSide | 0 | 탭의 왼쪽. |
QTabBar::RightSide | 1 | 탭의 오른쪽. |
enum QTabBar::SelectionBehavior
이 열거형 유형은 탭이 제거될 때, 제거되는 탭이 현재 탭이기도 한 경우 QTabBar 의 동작을 나열합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QTabBar::SelectLeftTab | 0 | 제거되는 탭의 왼쪽에 있는 탭을 선택합니다. |
QTabBar::SelectRightTab | 1 | 제거되는 탭의 오른쪽에 있는 탭을 선택합니다. |
QTabBar::SelectPreviousTab | 2 | 이전에 선택했던 탭을 선택합니다. |
enum QTabBar::Shape
이 열거형 유형은 QTabBar 에서 지원하는 기본 제공 도형들을 나열합니다. 일부 스타일에서는 특정 도형이 제대로 표시되지 않을 수 있으므로, 이 목록은 참고용으로만 활용하시기 바랍니다. 단, 위치는 정확히 반영되어야 합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QTabBar::RoundedNorth | 0 | 페이지 상단의 일반적인 둥근 모양 |
QTabBar::RoundedSouth | 1 | 페이지 하단의 일반적인 둥근 모양 |
QTabBar::RoundedWest | 2 | 페이지 왼쪽의 일반적인 둥근 모양 |
QTabBar::RoundedEast | 3 | 페이지 오른쪽의 일반적인 둥근 모양 |
QTabBar::TriangularNorth | 4 | 페이지 상단의 삼각형 탭. |
QTabBar::TriangularSouth | 5 | 예를 들어 엑셀 스프레드시트에서 사용되는 것과 유사한 삼각형 탭 |
QTabBar::TriangularWest | 6 | 페이지 왼쪽의 삼각형 탭. |
QTabBar::TriangularEast | 7 | 페이지 오른쪽의 삼각형 탭. |
속성 설명
autoHide : bool
이 속성이 true인 경우, 탭 바에 탭이 2개 미만이면 탭 바가 자동으로 숨겨집니다.
기본적으로 이 속성의 값은 false입니다.
액세스 함수:
| bool | autoHide() const |
| void | setAutoHide(bool hide) |
QWidget::visible도 참조하십시오 .
changeCurrentOnDrag : bool
이 속성이 true인 경우, 탭바 위로 드래그하면 현재 탭이 자동으로 변경됩니다.
참고: 이 기능을 사용하려면 acceptDrops 속성도 true로 설정해야합니다 .
기본적으로 이 속성은 false로 설정되어 있습니다.
액세스 함수:
| bool | changeCurrentOnDrag() const |
| void | setChangeCurrentOnDrag(bool change) |
[read-only] count : int
이 속성은 탭 바에 있는 탭의 개수를 저장합니다.
액세스 함수:
| int | count() const |
currentIndex : int
이 속성은 탭 바에서 표시 중인 탭의 인덱스를 저장합니다.
현재 탭이 없는 경우 현재 인덱스는 -1입니다.
액세스 함수:
| int | currentIndex() const |
| void | setCurrentIndex(int index) |
알림 신호:
| void | currentChanged(int index) |
documentMode : bool
이 속성은 탭 바가 메인 창에 적합한 모드로 렌더링되는지 여부를 나타냅니다.
이 속성은 탭 위젯에서 일반적으로 표시되는 방식과는 다르게 탭을 그릴 수 있도록 스타일에 대한 힌트로 사용됩니다. macOS에서는 Safari나 Sierra의 Terminal.app에 있는 탭과 비슷한 모양으로 표시됩니다.
액세스 함수:
| bool | documentMode() const |
| void | setDocumentMode(bool set) |
QTabWidget::documentMode도 참조하십시오 .
drawBase : bool
탭 바의 밑부분을 그릴지 여부를 정의합니다.
true인 경우 QTabBar 는 styles의 overlap에 따라 밑줄을 그립니다. 그렇지 않은 경우 탭만 그려집니다.
액세스 함수:
| bool | drawBase() const |
| void | setDrawBase(bool drawTheBase) |
QStyle::pixelMetric(), QStyle::PM_TabBarBaseOverlap 및 QStyleOptionTabBarBase도 참조하십시오 .
elideMode : Qt::TextElideMode
탭 바에서 텍스트를 생략하는 방법
이 속성은 지정된 탭 바 크기에 비해 항목을 표시할 공간이 부족할 때 항목이 어떻게 축약되는지를 제어합니다.
기본적으로 이 값은 스타일에 따라 달라집니다.
관련 함수:
| Qt::TextElideMode | elideMode() const |
| void | setElideMode(Qt::TextElideMode mode) |
QTabWidget::elideMode, usesScrollButtons 및 QStyle::SH_TabBar_ElideMode도 참조하십시오 .
expanding : bool
‘확장’이 true로 설정된 경우 QTabBar 는 빈 공간을 활용하기 위해 탭을 확장합니다.
기본값은 true입니다.
액세스 함수:
| bool | expanding() const |
| void | setExpanding(bool enabled) |
QTabWidget::documentMode도 참조하십시오 .
iconSize : QSize
이 속성은 탭 바에 표시되는 아이콘의 크기를 지정합니다.
기본값은 스타일에 따라 다릅니다. ` iconSize `는 최대 크기이며, 이보다 작은 아이콘은 확대되지 않습니다.
액세스 함수:
| QSize | iconSize() const |
| void | setIconSize(const QSize &size) |
QTabWidget::iconSize도 참조하십시오 .
movable : bool
이 속성은 사용자가 탭바 영역 내에서 탭을 이동할 수 있는지 여부를 지정합니다.
기본적으로 이 속성의 값은 ' false'입니다.
액세스 함수:
| bool | isMovable() const |
| void | setMovable(bool movable) |
selectionBehaviorOnRemove : SelectionBehavior
removeTab 가 호출될 때, 제거된 탭이 현재 탭인 경우 어떤 탭을 현재 탭으로 설정해야 하는가?
기본적으로 이 값은 ` SelectRightTab`입니다.
액세스 함수:
| QTabBar::SelectionBehavior | selectionBehaviorOnRemove() const |
| void | setSelectionBehaviorOnRemove(QTabBar::SelectionBehavior behavior) |
removeTab()도 참조하십시오 .
shape : Shape
이 속성은 탭 바에 있는 탭의 모양을 지정합니다.
이 속성의 가능한 값은 Shape 열거형에 의해 정의됩니다.
액세스 함수:
| QTabBar::Shape | shape() const |
| void | setShape(QTabBar::Shape shape) |
tabsClosable : bool
이 속성은 탭 바에 각 탭마다 닫기 버튼을 표시할지 여부를 결정합니다.
`tabsClosable`가 `true`로 설정되면, 스타일에 따라 탭의 왼쪽 또는 오른쪽에 닫기 버튼이 표시됩니다. 이 버튼을 직접 클릭하거나 탭 내 어디에서든 마우스 중 button을 클릭하면 ` tabCloseRequested ` 신호가 발생합니다.
기본값은 false입니다.
액세스 함수:
| bool | tabsClosable() const |
| void | setTabsClosable(bool closable) |
setTabButton() 및 tabRemoved()도 참조하십시오 .
usesScrollButtons : bool
이 속성은 탭 바에 탭이 많을 때 탭을 스크롤하기 위해 버튼을 사용할지 여부를 결정합니다.
탭 바의 크기에 비해 탭이 너무 많을 경우, 탭 바는 크기를 확장하거나 탭을 스크롤할 수 있는 버튼을 추가할 수 있습니다.
기본적으로 이 값은 스타일에 따라 달라집니다.
관련 함수:
| bool | usesScrollButtons() const |
| void | setUsesScrollButtons(bool useButtons) |
elideMode, QTabWidget::usesScrollButtons 및 QStyle::SH_TabBar_PreferNoArrows도 참조하십시오 .
멤버 함수 문서
[explicit] QTabBar::QTabBar(QWidget *parent = nullptr)
지정된 parent 를 사용하여 새로운 탭 바를 생성합니다.
[virtual noexcept] QTabBar::~QTabBar()
탭 바를 제거합니다.
QString QTabBar::accessibleTabName(int index) const
index 위치에 있는 탭의 accessibleName을 반환하며, index 가 범위를 벗어난 경우에는 빈 문자열을 반환합니다.
setAccessibleTabName()도 참조하십시오 .
int QTabBar::addTab(const QString &text)
text 라는 텍스트가 포함된 새 탭을 추가합니다. 새 탭의 인덱스를 반환합니다.
int QTabBar::addTab(const QIcon &icon, const QString &text)
icon 아이콘과 text 텍스트가 포함된 새 탭을 추가합니다. 새 탭의 인덱스를 반환합니다.
이 함수는 오버로드된 함수입니다.
[override virtual protected] void QTabBar::changeEvent(QEvent *event)
QWidget::changeEvent(QEvent *event)를 재구현합니다.
[signal] void QTabBar::currentChanged(int index)
이 신호는 탭 바의 현재 탭이 변경될 때 발생합니다. 새로운 현재 탭은 지정된 index 값을 가지며, 새로운 탭이 없는 경우(예: QTabBar 에 탭이 없는 경우)에는 -1을 가집니다.
참고: currentIndex 속성에 대한알림 신호입니다.
[override virtual protected] bool QTabBar::event(QEvent *event)
QWidget::event(QEvent *event)를 재구현합니다.
[override virtual protected] void QTabBar::hideEvent(QHideEvent *)
QWidget::hideEvent(QHideEvent *event)를 재구현합니다.
[virtual protected] void QTabBar::initStyleOption(QStyleOptionTab *option, int tabIndex) const
tabIndex 페이지의 탭에 있는 값들로 ` option `을 초기화합니다. 이 방법은 하위 클래스가 ` QStyleOptionTab`이 필요하지만 모든 정보를 직접 입력하고 싶지 않을 때 유용합니다.
QStyleOption::initFrom() 및 QTabWidget::initStyleOption()도 참조하십시오 .
int QTabBar::insertTab(int index, const QString &text)
index 위치에 “ text ”라는 텍스트가 포함된 새 탭을 삽입합니다. index 가 범위를 벗어날 경우, 새 탭은 끝에 추가됩니다. 새 탭의 인덱스를 반환합니다.
int QTabBar::insertTab(int index, const QIcon &icon, const QString &text)
index 위치에 아이콘 icon 과 텍스트 text 을 가진 새 탭을 삽입합니다. index 이 허용 범위를 벗어날 경우, 새 탭은 목록의 끝에 추가됩니다. 새 탭의 인덱스를 반환합니다.
이 함수가 호출되기 전에 QTabBar 가 비어 있었다면, 삽입된 탭이 현재 탭이 됩니다.
현재 인덱스 이하인 위치에 새 탭을 삽입하면 현재 인덱스가 증가하지만, 현재 탭은 그대로 유지됩니다.
이 함수는 오버로드된 함수입니다.
bool QTabBar::isTabEnabled(int index) const
index 위치에 있는 탭이 활성화된 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.
bool QTabBar::isTabVisible(int index) const
index 위치에 있는 탭이 표시되어 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.
[override virtual protected] void QTabBar::keyPressEvent(QKeyEvent *event)
QWidget::keyPressEvent(QKeyEvent *event)를 재구현합니다.
[override virtual] QSize QTabBar::minimumSizeHint() const
QWidget::minimumSizeHint 속성에 대한 액세스 함수를 다시 구현합니다.
[virtual protected] QSize QTabBar::minimumTabSizeHint(int index) const
index 위치에 있는 탭에 대한 최소 탭 크기 힌트를 반환합니다.
[override virtual protected] void QTabBar::mouseDoubleClickEvent(QMouseEvent *event)
QWidget::mouseDoubleClickEvent(QMouseEvent *event)를 재구현합니다.
[override virtual protected] void QTabBar::mouseMoveEvent(QMouseEvent *event)
QWidget::mouseMoveEvent(QMouseEvent *event)를 재구현합니다.
[override virtual protected] void QTabBar::mousePressEvent(QMouseEvent *event)
QWidget::mousePressEvent(QMouseEvent *event)를 재구현합니다.
[override virtual protected] void QTabBar::mouseReleaseEvent(QMouseEvent *event)
QWidget::mouseReleaseEvent(QMouseEvent *event)를 재구현합니다.
void QTabBar::moveTab(int from, int to)
인덱스 위치 from 에 있는 항목을 인덱스 위치 to 로 이동합니다.
tabMoved() 및 tabLayoutChange()도 참조하십시오 .
[override virtual protected] void QTabBar::paintEvent(QPaintEvent *)
QWidget::paintEvent(QPaintEvent *event)를 재구현합니다.
void QTabBar::removeTab(int index)
index 위치에 있는 탭을 제거합니다.
SelectionBehavior도 참조하십시오 .
[override virtual protected] void QTabBar::resizeEvent(QResizeEvent *)
QWidget::resizeEvent(QResizeEvent *event)를 재구현합니다.
void QTabBar::setAccessibleTabName(int index, const QString &name)
index 위치에 있는 탭의 accessibleName을 name 로 설정합니다.
accessibleTabName()도 참조하십시오 .
void QTabBar::setTabButton(int index, QTabBar::ButtonPosition position, QWidget *widget)
index 탭에서 widget 를 설정합니다. 위젯은 position 에 따라 왼쪽 또는 오른쪽에 배치됩니다.
position 에 이전에 설정된 위젯은 모두 숨겨집니다. widget 를 nullptr 로 설정하면 position 에 있는 현재 위젯이 숨겨집니다.
탭 바가 위젯의 소유권을 갖게 되므로, 다른 위젯(또는 nullptr)을 설정한 후 별도로 위젯의 부모를 재설정하지 않는 한, 탭 바가 소멸될 때 여기에 설정된 모든 위젯이 탭 바에 의해 삭제됩니다.
tabButton() 및 tabsClosable()도 참조하십시오 .
void QTabBar::setTabData(int index, const QVariant &data)
index 위치에 있는 탭의 데이터를 data 로 설정합니다.
tabData()도 참조하십시오 .
void QTabBar::setTabEnabled(int index, bool enabled)
enabled 가 true인 경우, 위치 index 에 있는 탭이 활성화되며, 그렇지 않은 경우 위치 index 에 있는 항목이 비활성화됩니다.
isTabEnabled()도 참조하십시오 .
void QTabBar::setTabIcon(int index, const QIcon &icon)
index 위치에 있는 탭의 아이콘을 icon 로 설정합니다.
tabIcon()도 참조하십시오 .
void QTabBar::setTabText(int index, const QString &text)
index 위치에 있는 탭의 텍스트를 text 로 설정합니다.
tabText()도 참조하십시오 .
void QTabBar::setTabTextColor(int index, const QColor &color)
지정된 ‘ index ’ 속성을 가진 탭의 텍스트 색상을 지정된 ‘ color ’로 설정합니다.
유효하지 않은 색상이 지정된 경우, 탭은 대신 QTabBar 의 전경색 역할을 사용합니다.
tabTextColor()도 참조하십시오 .
void QTabBar::setTabToolTip(int index, const QString &tip)
index 위치에 있는 탭의 툴팁을 tip 로 설정합니다.
tabToolTip()도 참조하십시오 .
void QTabBar::setTabVisible(int index, bool visible)
visible 가 true인 경우, index 위치에 있는 탭을 표시하고, 그렇지 않은 경우 숨깁니다.
isTabVisible()함수도 참조하십시오 .
void QTabBar::setTabWhatsThis(int index, const QString &text)
index 위치에 있는 탭의 ‘이 항목에 대해’ 도움말 텍스트를 text 로 설정합니다.
tabWhatsThis()도 참조하십시오 .
[override virtual protected] void QTabBar::showEvent(QShowEvent *)
QWidget::showEvent(QShowEvent *event)를 재구현합니다.
[override virtual] QSize QTabBar::sizeHint() const
QWidget::sizeHint 속성에 대한 액세스 함수를 다시 구현합니다.
int QTabBar::tabAt(const QPoint &position) const
position 을 가리는 탭의 인덱스를 반환하거나, position 을 가리는 탭이 없는 경우 -1을 반환합니다. ;
[signal] void QTabBar::tabBarClicked(int index)
이 신호는 사용자가 index 의 탭을 클릭할 때 발생합니다.
index 는 클릭된 탭의 인덱스이며, 커서 아래에 탭이 없는 경우에는 -1입니다.
[signal] void QTabBar::tabBarDoubleClicked(int index)
이 신호는 사용자가 index 의 탭을 더블 클릭할 때 발생합니다.
index 클릭된 탭을 나타내며, 커서 아래에 탭이 없는 경우에는 -1을 반환합니다.
QWidget *QTabBar::tabButton(int index, QTabBar::ButtonPosition position) const
index 에서 탭이 설정된 위젯 세트를 반환하며, 탭이 설정되지 않은 경우에는 position 또는 nullptr 를 반환합니다.
setTabButton()도 참조하십시오 .
[signal] void QTabBar::tabCloseRequested(int index)
이 신호는 탭의 닫기 버튼을 클릭했을 때 발생합니다. ` index `는 제거해야 할 인덱스입니다.
setTabsClosable()도 참조하십시오 .
QVariant QTabBar::tabData(int index) const
index 위치에 있는 탭의 데이터를 반환하거나, index 가 범위를 벗어난 경우 null 변형을 반환합니다.
setTabData()도 참조하십시오 .
QIcon QTabBar::tabIcon(int index) const
index 위치에 있는 탭의 아이콘을 반환하며, index 가 허용 범위를 벗어난 경우에는 null 아이콘을 반환합니다.
setTabIcon()도 참조하십시오 .
[virtual protected] void QTabBar::tabInserted(int index)
이 가상 핸들러는 새 탭이 추가되거나 index 위치에 삽입된 후에 호출됩니다.
tabRemoved()도 참조하십시오 .
[virtual protected] void QTabBar::tabLayoutChange()
이 가상 핸들러는 탭 레이아웃이 변경될 때마다 호출됩니다.
tabRect()도 참조하십시오 .
[signal] void QTabBar::tabMoved(int from, int to)
이 신호는 탭이 인덱스 위치 from 에 있던 탭을 인덱스 위치 to 로 이동시켰을 때 발생합니다.
참고: QTabWidget 는 탭 바에서 이 신호가 발생하면 페이지를 자동으로 이동시킵니다.
moveTab()도 참조하십시오 .
QRect QTabBar::tabRect(int index) const
index 위치에 있는 탭의 시각적 사각형을 반환하며, index 가 숨겨져 있거나 범위 밖인 경우에는 null 사각형을 반환합니다.
[virtual protected] void QTabBar::tabRemoved(int index)
이 가상 핸들러는 위치 index 에서 탭이 제거된 후에 호출됩니다.
tabInserted()도 참조하십시오 .
[virtual protected] QSize QTabBar::tabSizeHint(int index) const
index 위치에 있는 탭의 크기 힌트를 반환합니다.
QString QTabBar::tabText(int index) const
index 위치에 있는 탭의 텍스트를 반환하며, index 가 범위를 벗어난 경우에는 빈 문자열을 반환합니다.
setTabText()도 참조하십시오 .
QColor QTabBar::tabTextColor(int index) const
지정된 index 의 탭 텍스트 색상을 반환하거나, index 가 허용 범위를 벗어날 경우 유효하지 않은 색상을 반환합니다.
setTabTextColor()도 참조하십시오 .
QString QTabBar::tabToolTip(int index) const
index 위치에 있는 탭의 툴팁을 반환하거나, index 가 허용 범위를 벗어난 경우 빈 문자열을 반환합니다.
setTabToolTip()도 참조하십시오 .
QString QTabBar::tabWhatsThis(int index) const
index 위치에 있는 탭의 ‘What's This’ 도움말 텍스트를 반환하며, index 가 허용 범위를 벗어난 경우에는 빈 문자열을 반환합니다.
setTabWhatsThis()도 참조하십시오 .
[override virtual protected] void QTabBar::timerEvent(QTimerEvent *event)
QObject::timerEvent(QTimerEvent *event)를 재구현합니다.
[override virtual protected] void QTabBar::wheelEvent(QWheelEvent *event)
QWidget::wheelEvent(QWheelEvent *event)를 재구현합니다.
© 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.

