QStyleOptionToolButton Class

QStyleOptionToolButton 클래스는 도구 단추를 그리기 위한 매개 변수를 설명하는 데 사용됩니다. 더 보기...

Header: #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)

공용 변수

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 하위 클래스마다 정의됩니다.

Constant설명
QStyleOptionToolButton::TypeSO_ToolButton제공되는 스타일 옵션의 유형입니다(이 클래스의 경우SO_ToolButton ).

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

StyleOptionVersion참조하세요 .

enum QStyleOptionToolButton::StyleOptionVersion

이 열거형은 스타일 옵션의 버전에 대한 정보를 저장하는 데 사용되며 각 QStyleOption 서브클래스에 대해 정의됩니다.

Constant설명
QStyleOptionToolButton::Version11

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

StyleOptionType참조하세요 .

열거형 Q스타일 옵션 도구 버튼::도구 버튼 기능
플래그 Q스타일 옵션 도구 버튼::도구 버튼 기능

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

상수설명
QStyleOptionToolButton::None0x00일반 도구 버튼입니다.
QStyleOptionToolButton::Arrow0x01도구 버튼은 화살표입니다.
QStyleOptionToolButton::Menu0x04도구 버튼에는 메뉴가 있습니다.
QStyleOptionToolButton::PopupDelay0x08메뉴가 표시될 때까지 지연이 있습니다.
QStyleOptionToolButton::HasMenu0x10버튼에 팝업 메뉴가 있습니다.
QStyleOptionToolButton::MenuButtonPopupMenu버튼에 메뉴가 있음을 나타내는 화살표가 표시되어야 합니다.

ToolButtonFeatures 유형은 QFlags<ToolButtonFeature>에 대한 typedef입니다. ToolButtonFeature 값의 OR 조합을 저장합니다.

features, QToolButton::toolButtonStyle() 및 QToolButton::popupMode()도 참조하세요 .

멤버 함수 문서

QStyleOptionToolButton::QStyleOptionToolButton()

멤버 변수를 기본값으로 초기화하여 QStyleOptionToolButton을 생성합니다.

QStyleOptionToolButton::QStyleOptionToolButton(const QStyleOptionToolButton &other)

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

멤버 변수 문서

Qt::ArrowType QStyleOptionToolButton::arrowType

이 변수는 도구 버튼의 화살표 방향을 유지합니다.

이 값은 featuresArrow 이 포함된 경우에만 사용됩니다. 기본값은 Qt::DownArrow 입니다.

QStyleOptionToolButton::ToolButtonFeatures QStyleOptionToolButton::features

이 변수에는 도구 버튼의 기능의 OR 조합이 저장됩니다.

기본값은 None 입니다.

ToolButtonFeature참조하세요 .

QFont QStyleOptionToolButton::font

이 변수에는 텍스트에 사용되는 글꼴이 저장됩니다.

이 값은 toolButtonStyleQt::ToolButtonTextUnderIcon, Qt::ToolButtonTextBesideIcon 또는 Qt::ToolButtonTextOnly 인 경우에만 사용됩니다. 기본적으로 애플리케이션의 기본 글꼴이 사용됩니다.

QIcon QStyleOptionToolButton::icon

이 변수는 도구 버튼의 아이콘을 저장합니다.

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

iconSize참조하세요 .

QSize QStyleOptionToolButton::iconSize

이 변수는 도구 버튼의 아이콘 크기를 저장합니다.

기본값은 QSize(-1, -1), 즉 잘못된 크기입니다.

QPoint QStyleOptionToolButton::pos

이 변수는 도구 버튼의 위치를 저장합니다.

기본값은 널 포인트, 즉 (0, 0)입니다.

QString QStyleOptionToolButton::text

이 변수에는 도구 버튼의 텍스트가 저장됩니다.

이 값은 toolButtonStyleQt::ToolButtonTextUnderIcon, Qt::ToolButtonTextBesideIcon 또는 Qt::ToolButtonTextOnly 인 경우에만 사용됩니다. 기본값은 빈 문자열입니다.

Qt::ToolButtonStyle QStyleOptionToolButton::toolButtonStyle

이 변수에는 도구 버튼의 모양을 설명하는 Qt::ToolButtonStyle 값이 저장됩니다.

기본값은 Qt::ToolButtonIconOnly 입니다.

QToolButton::toolButtonStyle()도 참조하세요 .

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