QStyleOptionToolButton Class
QStyleOptionToolButton 클래스는 도구 버튼을 그리는 데 필요한 매개변수를 정의하는 데 사용됩니다. 더 보기...
| 헤더: | #include <QStyleOptionToolButton> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QStyleOptionComplex |
공개 유형
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | ToolButtonFeature { None, Arrow, Menu, PopupDelay, HasMenu, MenuButtonPopup } |
| flags | ToolButtonFeatures |
공개 함수
| QStyleOptionToolButton() | |
| QStyleOptionToolButton(const QStyleOptionToolButton &other) | |
| QStyleOptionToolButton & | operator=(const QStyleOptionToolButton &) |
공개 변수
| Qt::ArrowType | arrowType |
| QStyleOptionToolButton::ToolButtonFeatures | features |
| QFont | font |
| QIcon | icon |
| QSize | iconSize |
| QPoint | pos |
| QString | text |
| Qt::ToolButtonStyle | toolButtonStyle |
상세 설명
QStyleOptionToolButton은 QStyle 함수가 QToolButton 를 그리는 데 필요한 모든 정보를 포함합니다.
성능상의 이유로 멤버 함수는 거의 없으며, 멤버 변수에 대한 액세스는 직접적으로 이루어집니다(즉, . 또는 -> 연산자를 사용). 이로 인해 구조체를 사용하기가 간편하며, 이러한 구조체가 단순히 스타일 함수에서 사용하는 매개변일 뿐임을 강조합니다.
QStyleOption, QStyleOptionComplex 및 QStyleOptionButton도 참조하십시오 .
멤버 유형 문서
enum QStyleOptionToolButton::StyleOptionType
이 열거형은 스타일 옵션의 유형에 대한 정보를 담는 데 사용되며, 각 ` QStyleOption ` 하위 클래스에 대해 정의됩니다.
| 상수 | 상수명 | 설명 |
|---|---|---|
QStyleOptionToolButton::Type | SO_ToolButton | 제공된 스타일 옵션의 유형(이 클래스의 경우 `SO_ToolButton `). |
이 유형은 QStyleOption, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 유형을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 사용자 정의 QStyleOption 하위 클래스와 사용자 정의 스타일을 만들려는 경우가 아니라면 이 부분에 대해 걱정할 필요가 없습니다.
StyleOptionVersion도 참조하십시오 .
enum QStyleOptionToolButton::StyleOptionVersion
이 열거형은 스타일 옵션의 버전에 대한 정보를 담기 위해 사용되며, 각 ` QStyleOption ` 하위 클래스에 대해 정의됩니다.
| 상수 | 상수 | 상수값 |
|---|---|---|
QStyleOptionToolButton::Version | 1 | 1 |
이 버전은 QStyleOption 의 서브클래스가 호환성을 해치지 않고 확장을 구현하는 데 사용됩니다. qstyleoption_cast()를 사용하는 경우, 일반적으로 이 값을 확인할 필요가 없습니다.
StyleOptionType도 참조하십시오 .
enum QStyleOptionToolButton::ToolButtonFeature
flags QStyleOptionToolButton::ToolButtonFeatures
도구 버튼이 가질 수 있는 다양한 기능을 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QStyleOptionToolButton::None | 0x00 | 일반 도구 버튼입니다. |
QStyleOptionToolButton::Arrow | 0x01 | 도구 버튼은 화살표 모양입니다. |
QStyleOptionToolButton::Menu | 0x04 | 이 도구 버튼에는 메뉴가 있습니다. |
QStyleOptionToolButton::PopupDelay | 0x08 | 메뉴가 표시되기까지 지연 시간이 있습니다. |
QStyleOptionToolButton::HasMenu | 0x10 | 이 버튼에는 팝업 메뉴가 있습니다. |
QStyleOptionToolButton::MenuButtonPopup | Menu | 버튼에는 메뉴가 있음을 나타내는 화살표가 표시되어야 합니다. |
ToolButtonFeatures 유형은 QFlags<ToolButtonFeature>에 대한 typedef입니다. 이 유형은 ToolButtonFeature 값들의 OR 조합을 저장합니다.
features, QToolButton::toolButtonStyle() 및 QToolButton::popupMode()도 참조하십시오 .
멤버 함수 설명서
QStyleOptionToolButton::QStyleOptionToolButton()
QStyleOptionToolButton 객체를 생성하며, 멤버 변수들을 기본값으로 초기화합니다.
QStyleOptionToolButton::QStyleOptionToolButton(const QStyleOptionToolButton &other)
other 스타일 옵션의 복사본을 생성합니다.
[noexcept default] QStyleOptionToolButton &QStyleOptionToolButton::operator=(const QStyleOptionToolButton &)
other 를 이 QStyleOptionToolButton 인스턴스에 복사-할당합니다.
멤버 변수 설명서
Qt::ArrowType QStyleOptionToolButton::arrowType
이 변수는 도구 버튼의 화살표 방향을 저장합니다.
이 값은 ` features `에 ` Arrow`가 포함된 경우에만 사용됩니다. 기본값은 ` Qt::DownArrow`입니다.
QStyleOptionToolButton::ToolButtonFeatures QStyleOptionToolButton::features
이 변수는 도구 버튼의 기능들을 OR 연산으로 결합한 값을 저장합니다.
기본값은 None 입니다.
ToolButtonFeature도 참조하십시오 .
QFont QStyleOptionToolButton::font
이 변수는 텍스트에 사용되는 글꼴을 저장합니다.
이 값은 ` toolButtonStyle `이 ` Qt::ToolButtonTextUnderIcon`, ` Qt::ToolButtonTextBesideIcon` 또는 ` Qt::ToolButtonTextOnly`인 경우에만 사용됩니다. 기본적으로 애플리케이션의 기본 글꼴이 사용됩니다.
QIcon QStyleOptionToolButton::icon
이 변수는 도구 버튼의 아이콘을 저장합니다.
기본값은 빈 아이콘, 즉 픽스맵이나 파일 이름이 모두 없는 아이콘입니다.
iconSize도 참조하십시오 .
QSize QStyleOptionToolButton::iconSize
이 변수는 도구 버튼의 아이콘 크기를 저장합니다.
기본값은 QSize(-1, -1)이며, 이는 유효하지 않은 크기입니다.
QPoint QStyleOptionToolButton::pos
이 변수는 도구 버튼의 위치를 저장합니다.
기본값은 원점, 즉 (0, 0)입니다.
QString QStyleOptionToolButton::text
이 변수는 도구 버튼의 텍스트를 저장합니다.
이 값은 ` toolButtonStyle `가 ` Qt::ToolButtonTextUnderIcon`, ` Qt::ToolButtonTextBesideIcon` 또는 ` Qt::ToolButtonTextOnly`인 경우에만 사용됩니다. 기본값은 빈 문자열입니다.
Qt::ToolButtonStyle QStyleOptionToolButton::toolButtonStyle
이 변수는 도구 버튼의 모양을 설명하는 ‘ Qt::ToolButtonStyle ’ 값을 저장합니다.
기본값은 ` Qt::ToolButtonIconOnly`입니다.
QToolButton::toolButtonStyle()도 참조하십시오 .
© 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.
