QStyleOptionToolBar Class
QStyleOptionToolBar 클래스는 툴바를 그리는 데 필요한 매개변수를 정의하는 데 사용됩니다. 더 보기...
| 헤더: | #include <QStyleOptionToolBar> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QStyleOption |
공개 유형
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | ToolBarFeature { None, Movable } |
| flags | ToolBarFeatures |
| enum | ToolBarPosition { Beginning, Middle, End, OnlyOne } |
공개 함수
| QStyleOptionToolBar() | |
| QStyleOptionToolBar(const QStyleOptionToolBar &other) | |
| QStyleOptionToolBar & | operator=(const QStyleOptionToolBar &) |
공개 변수
| QStyleOptionToolBar::ToolBarFeatures | features |
| int | lineWidth |
| int | midLineWidth |
| QStyleOptionToolBar::ToolBarPosition | positionOfLine |
| QStyleOptionToolBar::ToolBarPosition | positionWithinLine |
| Qt::ToolBarArea | toolBarArea |
상세 설명
QStyleOptionToolBar는 QStyle 함수가 QToolBar 를 그리는 데 필요한 모든 정보를 포함합니다.
QStyleOptionToolBar 클래스는 위젯을 그리는 데 필요한 lineWidth 와 midLineWidth 를 보관합니다. 또한 툴바가 어느 area 에 위치해야 하는지, 이동 가능한지 여부, 툴바 라인의 위치(positionOfLine), 그리고 라인 내 툴바의 위치(positionWithinLine)에 대한 정보도 저장합니다.
또한, 이 클래스는 몇 가지 열거형을 제공합니다. ` ToolBarFeature ` 열거형은 툴바가 이동 가능한지 여부를 나타내는 데 사용되며, ` ToolBarPosition ` 열거형은 툴바 라인의 위치와 라인 내 툴바의 위치를 나타내는 데 사용됩니다.
성능상의 이유로 멤버 함수는 거의 없으며, 멤버 변수에 대한 액세스는 직접적으로 이루어집니다(즉, . 또는 -> 연산자를 사용). 이로 인해 구조체를 사용하기 쉬우며, 이들이 단순히 스타일 함수가 사용하는 매개변일 뿐임을 강조합니다.
QStyleOption도 참조하십시오 .
멤버 유형 문서
enum QStyleOptionToolBar::StyleOptionType
이 열거형은 스타일 옵션의 유형에 대한 정보를 담기 위해 사용되며, 각 ` QStyleOption ` 하위 클래스에 대해 정의됩니다.
| 상수 | 상수명 | 설명 |
|---|---|---|
QStyleOptionToolBar::Type | SO_ToolBar | 제공된 스타일 옵션의 유형(이 클래스의 경우 `SO_ToolBar `). |
이 유형은 QStyleOption, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 유형을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 사용자 정의 QStyleOption 하위 클래스와 사용자 정의 스타일을 만들려는 경우가 아니라면 이 부분에 대해 걱정할 필요가 없습니다.
StyleOptionVersion도 참조하십시오 .
enum QStyleOptionToolBar::StyleOptionVersion
이 열거형은 스타일 옵션의 버전에 대한 정보를 저장하는 데 사용되며, 각 ` QStyleOption ` 하위 클래스에 대해 정의됩니다.
| 상수 | 상수 | 상수값 |
|---|---|---|
QStyleOptionToolBar::Version | 1 | 1 |
이 버전은 QStyleOption 의 하위 클래스에서 호환성을 해치지 않고 확장을 구현하는 데 사용됩니다. qstyleoption_cast()를 사용하는 경우, 일반적으로 이를 확인할 필요가 없습니다.
StyleOptionType도 참조하십시오 .
enum QStyleOptionToolBar::ToolBarFeature
flags QStyleOptionToolBar::ToolBarFeatures
이 열거형은 툴바를 이동할 수 있는지 여부를 나타내는 데 사용됩니다.
| 상수 | 값 | 설명 |
|---|---|---|
QStyleOptionToolBar::None | 0x0 | 툴바를 이동할 수 없습니다. 기본값입니다. |
QStyleOptionToolBar::Movable | 0x1 | 툴바를 이동할 수 있으며, 툴바 경계 위에 커서를 올리면 핸들이 나타납니다. |
ToolBarFeatures 유형은 QFlags<ToolBarFeature>에 대한 typedef입니다. 이 유형은 ToolBarFeature 값들의 OR 조합을 저장합니다.
features 및 QToolBar::isMovable()도 참조하십시오 .
enum QStyleOptionToolBar::ToolBarPosition
이 열거형은 툴바 줄의 위치와 해당 줄 내에서 툴바의 위치를 설명하는 데 사용됩니다.
한 줄 내 위치의 순서는 수직 줄의 경우 위쪽부터, 수평 줄의 경우 왼쪽부터 시작합니다. 줄별 위치의 순서는 항상 상위 위젯의 경계 가장자리 기준입니다.
| 상수 | 값 | 설명 |
|---|---|---|
QStyleOptionToolBar::Beginning | 0 | 툴바가 라인의 맨 앞에 위치하거나, 툴바 라인이 여러 라인 중 첫 번째입니다. 이 위치를 갖는 툴바(및 라인)는 하나만 있을 수 있습니다. |
QStyleOptionToolBar::Middle | 1 | 툴바가 줄의 중간에 위치하거나, 툴바 줄이 여러 줄 중 중간에 있습니다. 이 위치를 갖는 툴바(및 줄)는 여러 개 있을 수 있습니다. |
QStyleOptionToolBar::End | 2 | 툴바가 줄의 끝에 위치하거나, 툴바 줄이 여러 줄 중 마지막 줄입니다. 이 위치를 갖는 툴바(및 줄)는 하나만 있을 수 있습니다. |
QStyleOptionToolBar::OnlyOne | 3 | 툴바나 줄이 하나뿐입니다. 이는 positionOfLine 및 positionWithinLine 변수의 기본값입니다. |
positionWithinLine 및 positionOfLine도 참조하십시오 .
멤버 함수 설명서
QStyleOptionToolBar::QStyleOptionToolBar()
QStyleOptionToolBar 객체를 생성하고, 멤버 변수들을 기본값으로 초기화합니다.
QStyleOptionToolBar::QStyleOptionToolBar(const QStyleOptionToolBar &other)
other 스타일 옵션의 복사본을 생성합니다.
[noexcept default] QStyleOptionToolBar &QStyleOptionToolBar::operator=(const QStyleOptionToolBar &)
other 을 이 QStyleOptionToolBar 인스턴스에 복사 할당합니다.
멤버 변수 문서
QStyleOptionToolBar::ToolBarFeatures QStyleOptionToolBar::features
이 변수는 툴바를 이동할 수 있는지 여부를 나타냅니다.
기본값은 ` None`입니다.
int QStyleOptionToolBar::lineWidth
이 변수는 툴바를 그릴 때의 선 너비를 저장합니다.
기본값은 0입니다.
int QStyleOptionToolBar::midLineWidth
이 변수는 툴바를 그릴 때 사용되는 중간 선 너비를 저장합니다.
기본값은 0입니다.
QStyleOptionToolBar::ToolBarPosition QStyleOptionToolBar::positionOfLine
이 변수는 툴바 줄의 위치를 저장합니다.
기본값은 QStyleOptionToolBar::OnlyOne 입니다.
QStyleOptionToolBar::ToolBarPosition QStyleOptionToolBar::positionWithinLine
이 변수는 줄 내에서 툴바의 위치를 저장합니다.
기본값은 QStyleOptionToolBar::OnlyOne 입니다.
Qt::ToolBarArea QStyleOptionToolBar::toolBarArea
이 변수는 툴바를 그릴 위치를 저장합니다.
기본값은 Qt::TopToolBarArea 입니다.
Qt::ToolBarArea도 참조하십시오 .
© 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.
