QStyleOptionMenuItem Class
QStyleOptionMenuItem 클래스는 메뉴 항목을 그리는 데 필요한 매개 변수를 설명하는 데 사용됩니다. 더 보기...
| Header: | #include <QStyleOptionMenuItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속합니다: | QStyleOption |
공용 타입
| enum | CheckType { NotCheckable, Exclusive, NonExclusive } |
| enum | MenuItemType { Normal, DefaultItem, Separator, SubMenu, Scroller, …, EmptyArea } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
공용 함수
| QStyleOptionMenuItem() | |
| QStyleOptionMenuItem(const QStyleOptionMenuItem &other) |
공용 변수
| QStyleOptionMenuItem::CheckType | checkType |
| bool | checked |
| QFont | font |
| QIcon | icon |
| int | maxIconWidth |
| bool | menuHasCheckableItems |
| QStyleOptionMenuItem::MenuItemType | menuItemType |
| QRect | menuRect |
| int | reservedShortcutWidth |
| QString | text |
상세 설명
QStyleOptionMenuItem에는 QStyle 함수가 QMenu 에서 메뉴 항목을 그리는 데 필요한 모든 정보가 포함되어 있습니다. 다른 메뉴 관련 위젯을 그리는 데에도 사용됩니다.
성능상의 이유로 멤버 함수는 거의 없으며 멤버 변수에 직접 액세스합니다(예: . 또는 -> 연산자 사용). 이렇게 하면 구조가 사용하기 쉽고 스타일 함수에 사용되는 매개변수라는 점을 강조할 수 있습니다.
QStyleOption 를참조하세요 .
멤버 유형 문서
enum QStyleOptionMenuItem::CheckType
이 열거형은 항목에 체크 표시를 그릴지 여부 또는 아예 그릴지 여부를 나타내는 데 사용됩니다.
| Constant | 값 | 설명 |
|---|---|---|
QStyleOptionMenuItem::NotCheckable | 0 | 항목은 체크 표시할 수 없습니다. |
QStyleOptionMenuItem::Exclusive | 1 | 항목이 라디오 버튼과 같은 독점 확인 항목입니다. |
QStyleOptionMenuItem::NonExclusive | 2 | 항목이 비독점 체크 항목(예: 확인란)입니다. |
checkType, QAction::checkable, QAction::checked, QActionGroup::exclusionPolicy 을참조하세요 .
enum QStyleOptionMenuItem::MenuItemType
이 열거형은 구조가 설명하는 메뉴 항목의 유형을 나타냅니다.
| Constant | 값 | 설명 |
|---|---|---|
QStyleOptionMenuItem::Normal | 0 | 일반 메뉴 항목입니다. |
QStyleOptionMenuItem::DefaultItem | 1 | QMenu::defaultAction()로 지정된 기본 동작인 메뉴 항목입니다. |
QStyleOptionMenuItem::Separator | 2 | 메뉴 구분 기호. |
QStyleOptionMenuItem::SubMenu | 3 | 메뉴 항목이 하위 메뉴를 가리키고 있음을 나타냅니다. |
QStyleOptionMenuItem::Scroller | 4 | 팝업 메뉴 스크롤러(현재 macOS에서만 사용됨). |
QStyleOptionMenuItem::TearOff | 5 | 메뉴의 잘라내기 핸들입니다. |
QStyleOptionMenuItem::Margin | 6 | 메뉴의 여백입니다. |
QStyleOptionMenuItem::EmptyArea | 7 | 메뉴의 빈 영역입니다. |
menuItemType 를참조하세요 .
enum QStyleOptionMenuItem::StyleOptionType
이 열거형은 스타일 옵션의 유형에 대한 정보를 저장하는 데 사용되며 각 QStyleOption 하위 클래스마다 정의됩니다.
| Constant | 값 | 설명 |
|---|---|---|
QStyleOptionMenuItem::Type | SO_MenuItem | 제공되는 스타일 옵션의 유형입니다(이 클래스의 경우SO_MenuItem ). |
이 유형은 QStyleOption, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 유형을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 자체 QStyleOption 하위 클래스와 자체 스타일을 만들려는 경우가 아니라면 이에 대해 걱정할 필요가 없습니다.
StyleOptionVersion 를참조하세요 .
enum QStyleOptionMenuItem::StyleOptionVersion
이 열거형은 스타일 옵션의 버전에 대한 정보를 저장하는 데 사용되며 각 QStyleOption 서브클래스에 대해 정의됩니다.
| Constant | 값 | 설명 |
|---|---|---|
QStyleOptionMenuItem::Version | 1 | 1 |
이 버전은 QStyleOption 하위 클래스에서 호환성을 깨지 않고 확장을 구현하는 데 사용됩니다. qstyleoption_cast ()를 사용하는 경우 일반적으로 확인할 필요가 없습니다.
StyleOptionType 를참조하세요 .
멤버 함수 문서
QStyleOptionMenuItem::QStyleOptionMenuItem()
멤버 변수를 기본값으로 초기화하여 QStyleOptionMenuItem을 생성합니다.
QStyleOptionMenuItem::QStyleOptionMenuItem(const QStyleOptionMenuItem &other)
other 스타일 옵션의 복사본을 생성합니다.
멤버 변수 문서
QStyleOptionMenuItem::CheckType QStyleOptionMenuItem::checkType
이 변수에는 메뉴 항목의 체크 표시 유형이 저장됩니다.
기본값은 NotCheckable 입니다.
CheckType 를참조하세요 .
bool QStyleOptionMenuItem::checked
이 변수는 메뉴 항목의 선택 여부를 저장합니다.
기본값은 false입니다.
QFont QStyleOptionMenuItem::font
이 변수에는 메뉴 항목 텍스트에 사용되는 글꼴이 저장됩니다.
메뉴 텍스트를 그릴 때 바로가기를 뺀 글꼴입니다. 바로 가기는 일반적으로 페인터의 글꼴을 사용하여 그려집니다. 기본적으로 애플리케이션의 기본 글꼴이 사용됩니다.
QIcon QStyleOptionMenuItem::icon
이 변수는 메뉴 항목의 아이콘을 저장합니다.
기본값은 빈 아이콘, 즉 픽셀맵도 파일 이름도 없는 아이콘입니다.
int QStyleOptionMenuItem::maxIconWidth
이 변수는 메뉴 항목에 있는 아이콘의 최대 아이콘 너비를 보유합니다.
이 변수는 아이콘을 올바른 위치에 그리거나 항목을 올바르게 정렬하는 데 사용할 수 있습니다. 이 변수는 메뉴 항목에 아이콘이 있는지 여부에 관계없이 설정해야 합니다. 기본값은 0입니다.
bool QStyleOptionMenuItem::menuHasCheckableItems
이 변수는 메뉴 전체에 체크 가능한 항목이 있는지 여부를 저장합니다.
기본값은 true입니다.
이 옵션을 false로 설정하면 메뉴에 체크할 수 있는 항목이 없습니다. 이렇게 하면 GUI 스타일에서 일반적으로 체크 열에 사용되는 가로 공간을 절약할 수 있습니다.
QStyleOptionMenuItem::MenuItemType QStyleOptionMenuItem::menuItemType
이 변수에는 메뉴 항목의 유형이 저장됩니다.
기본값은 Normal 입니다.
MenuItemType 를참조하세요 .
QRect QStyleOptionMenuItem::menuRect
이 변수는 전체 메뉴의 직사각형을 보유합니다.
기본값은 널 직사각형, 즉 너비와 높이가 모두 0으로 설정된 직사각형입니다.
int QStyleOptionMenuItem::reservedShortcutWidth
이 변수는 메뉴 항목의 바로가기에 대한 예약 너비를 보유합니다.
QMenu 메뉴에 표시되는 모든 항목 중 가장 넓은 바로가기가 차지하는 너비로 설정합니다.
기본값은 0입니다.
QString QStyleOptionMenuItem::text
이 변수에는 메뉴 항목의 텍스트가 저장됩니다.
텍스트 형식은 "메뉴 텍스트\t바로가기"와 같은 형식입니다.
메뉴 항목에 바로 가기가 없는 경우 메뉴 항목의 텍스트만 포함됩니다. 기본값은 빈 문자열입니다.
© 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.
