이 페이지에서

QStyleOptionTab Class

QStyleOptionTab 클래스는 탭 바를 그리는 데 필요한 매개변수를 정의하는 데 사용됩니다. 더 보기...

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

공개 유형

enum CornerWidget { NoCornerWidgets, LeftCornerWidget, RightCornerWidget }
flags CornerWidgets
enum SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected }
enum StyleOptionType { Type }
enum StyleOptionVersion { Version }
enum TabFeature { None, HasFrame, MinimumSizeHint }
flags TabFeatures
enum TabPosition { Beginning, Middle, End, OnlyOneTab, Moving }

공개 함수

QStyleOptionTab()
QStyleOptionTab(const QStyleOptionTab &other)
QStyleOptionTab &operator=(const QStyleOptionTab &)

공개 변수

QStyleOptionTab::CornerWidgets cornerWidgets
bool documentMode
QIcon icon
QSize iconSize
QSize leftButtonSize
QStyleOptionTab::TabPosition position
QSize rightButtonSize
int row
QStyleOptionTab::SelectedPosition selectedPosition
QTabBar::Shape shape
int tabIndex
QString text

상세 설명

QStyleOptionTab 클래스는 QTabBar 및 QTabWidget 용 패널을 비롯한 여러 내장 Qt Widgets를 그리는 데 사용됩니다.

QStyleOptionTab 클래스의 인스턴스는 type, SO_Tab 및 version 3을 가집니다. 이 유형은 QStyleOption, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 유형을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 사용자 정의 QStyleOption 하위 클래스와 사용자 정의 스타일을 만들려는 경우가 아니라면 이 부분에 대해 신경 쓸 필요가 없습니다. 버전은 QStyleOption 하위 클래스에서 호환성을 깨지 않고 확장을 구현하는 데 사용됩니다. qstyleoption_cast()를 사용하는 경우 일반적으로 이를 확인할 필요가 없습니다.

성능상의 이유로 멤버 함수는 거의 없으며, 멤버 변수에 대한 접근은 직접적으로 이루어집니다(즉, . 또는 -> 연산자를 사용). 이로 인해 구조체를 사용하기 쉬우며, 이들이 단순히 스타일 함수가 사용하는 매개변일 뿐임을 강조합니다.

QStyleOption도 참조하십시오 .

멤버 유형 문서

enum QStyleOptionTab::CornerWidget
flags QStyleOptionTab::CornerWidgets

이 플래그는 탭 내의 모서리 위젯을 나타냅니다.

상수값설명
QStyleOptionTab::NoCornerWidgets0x00모서리 위젯이 없습니다.
QStyleOptionTab::LeftCornerWidget0x01왼쪽 모서리 위젯
QStyleOptionTab::RightCornerWidget0x02오른쪽 모서리 위젯

CornerWidgets 유형은 QFlags<CornerWidget>에 대한 typedef입니다. 이 유형은 CornerWidget 값들의 OR 조합을 저장합니다.

cornerWidgets도 참조하십시오 .

enum QStyleOptionTab::SelectedPosition

이 열거형은 선택된 탭의 위치를 나타냅니다. 일부 스타일은 탭이 선택된 탭과 인접해 있는지 여부에 따라 탭을 다르게 표시해야 합니다.

상수값설명
QStyleOptionTab::NotAdjacent0탭이 선택된 탭과 인접해 있지 않거나(또는 해당 탭 자체가 선택된 탭인 경우).
QStyleOptionTab::NextIsSelected1다음 탭(일반적으로 오른쪽 탭)이 선택되어 있습니다.
QStyleOptionTab::PreviousIsSelected2이전 탭(일반적으로 왼쪽에 있는 탭)이 선택되어 있습니다.

selectedPosition도 참조하십시오 .

enum QStyleOptionTab::StyleOptionType

이 열거형은 스타일 옵션의 유형에 대한 정보를 담기 위해 사용되며, 각 ` QStyleOption ` 하위 클래스에 대해 정의됩니다.

상수상수값설명
QStyleOptionTab::TypeSO_Tab제공된 스타일 옵션의 유형(이 클래스의 경우SO_Tab ).

이 유형은 QStyleOption, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 유형을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 사용자 정의 QStyleOption 하위 클래스와 사용자 정의 스타일을 만들려는 경우가 아니라면 이 부분에 대해 걱정할 필요가 없습니다.

StyleOptionVersion도 참조하십시오 .

enum QStyleOptionTab::StyleOptionVersion

이 열거형은 스타일 옵션의 버전에 대한 정보를 담기 위해 사용되며, 각 ` QStyleOption ` 하위 클래스에 대해 정의됩니다.

상수상수상수값
QStyleOptionTab::Version13

이 버전은 QStyleOption 하위 클래스에서 호환성을 해치지 않고 확장을 구현하는 데 사용됩니다. qstyleoption_cast()를 사용하는 경우, 일반적으로 이 값을 확인할 필요가 없습니다.

StyleOptionType도 참조하십시오 .

enum QStyleOptionTab::TabFeature
flags QStyleOptionTab::TabFeatures

탭 버튼이 가질 수 있는 다양한 기능을 설명합니다.

상수값설명
QStyleOptionTab::None0x00일반 탭 버튼입니다.
QStyleOptionTab::HasFrame0x01탭 버튼은 탭 프레임에 배치됩니다.
QStyleOptionTab::MinimumSizeHint (since Qt 6.9)0x02탭 버튼의 최소 크기 힌트가 측정되고 있으며, 이는 일반 크기 힌트와는 대조적입니다.

TabFeatures 유형은 QFlags<TabFeature>에 대한 typedef입니다. 이 유형은 TabFeature 값들의 OR 조합을 저장합니다.

QStyleOptionToolBar::features도 참조하십시오 .

enum QStyleOptionTab::TabPosition

이 열거형은 탭의 위치를 나타냅니다.

상수값설명
QStyleOptionTab::Beginning0이 탭은 탭 바의 첫 번째 탭입니다.
QStyleOptionTab::Middle1탭은 탭 바에서 첫 번째 탭도, 마지막 탭도 아닙니다.
QStyleOptionTab::End2이 탭은 탭 막대의 마지막 탭입니다.
QStyleOptionTab::OnlyOneTab3이 탭은 탭 바의 첫 번째이자 마지막 탭입니다.
QStyleOptionTab::Moving (since Qt 6.6)4탭이 마우스 드래그 또는 애니메이션에 의해 이동하고 있습니다.

position도 참조하십시오 .

멤버 함수 문서

QStyleOptionTab::QStyleOptionTab()

QStyleOptionTab 객체를 생성하고, 멤버 변수들을 기본값으로 초기화합니다.

QStyleOptionTab::QStyleOptionTab(const QStyleOptionTab &other)

other 스타일 옵션의 복사본을 생성합니다.

[noexcept default] QStyleOptionTab &QStyleOptionTab::operator=(const QStyleOptionTab &)

other 를 이 QStyleOptionTab 인스턴스에 복사 할당합니다.

멤버 변수 설명

QStyleOptionTab::CornerWidgets QStyleOptionTab::cornerWidgets

이 변수는 탭 바의 모서리 위젯을 나타내는 ` CornerWidget ` 값들의 OR 조합을 포함합니다.

기본값은 ` NoCornerWidgets`입니다.

CornerWidget도 참조하십시오 .

bool QStyleOptionTab::documentMode

이 변수는 탭바가 문서 모드에 있는지 여부를 나타냅니다.

기본값은 false입니다;

QIcon QStyleOptionTab::icon

이 변수는 탭의 아이콘을 저장합니다.

기본값은 빈 아이콘, 즉 픽스맵이나 파일 이름이 모두 없는 아이콘입니다.

QSize QStyleOptionTab::iconSize

이 변수는 아이콘의 크기를 저장합니다

기본값은 ` QSize`(-1, -1)이며, 이는 유효하지 않은 크기입니다. 탭 바의 기본 아이콘 크기를 확인하려면 ` QStyle::pixelMetric()`를 사용하십시오.

QTabBar::iconSize()도 참조하십시오 .

QSize QStyleOptionTab::leftButtonSize

이 변수는 탭의 왼쪽 위젯 크기를 저장합니다.

기본값은 QSize(-1, -1)이며, 이는 유효하지 않은 크기입니다.

QStyleOptionTab::TabPosition QStyleOptionTab::position

이 변수는 탭 바에서 탭의 위치를 저장합니다.

기본값은 ` Beginning`이며, 이는 탭이 탭 바의 첫 번째 탭임을 의미합니다.

QSize QStyleOptionTab::rightButtonSize

이 변수는 탭의 오른쪽 위젯 크기를 저장합니다.

기본값은 QSize(-1, -1)이며, 이는 유효하지 않은 크기입니다.

int QStyleOptionTab::row

이 변수는 탭이 현재 어느 행에 위치해 있는지를 나타냅니다

기본값은 0이며, 이는 맨 앞 행을 나타냅니다. 현재 이 속성의 값은 0으로만 설정될 수 있습니다.

QStyleOptionTab::SelectedPosition QStyleOptionTab::selectedPosition

이 변수는 선택된 탭이 이 탭을 기준으로 한 위치를 저장합니다.

기본값은 ` NotAdjacent`이며, 이는 해당 탭이 선택된 탭과 인접해 있지 않으며 선택된 탭도 아님을 의미합니다.

QTabBar::Shape QStyleOptionTab::shape

이 변수는 탭을 그릴 때 사용되는 탭의 모양을 저장합니다. 기본값은 QTabBar::RoundedNorth 입니다.

QTabBar::Shape도 참조하십시오 .

int QStyleOptionTab::tabIndex

이 변수는 현재 표시 중인 탭의 인덱스를 저장합니다.

기본값은 -1이며, 이는 탭바에 표시되지 않은 탭을 의미합니다.

QString QStyleOptionTab::text

이 변수는 탭의 텍스트를 저장합니다

기본값은 빈 문자열입니다.

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