QStyleOptionGraphicsItem Class
QStyleOptionGraphicsItem 클래스는 QGraphicsItem 를 그리는 데 필요한 매개변수를 정의하는 데 사용됩니다. 더 보기...
| 헤더: | #include <QStyleOptionGraphicsItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QStyleOption |
공개 유형
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
공개 함수
| QStyleOptionGraphicsItem() | |
| QStyleOptionGraphicsItem(const QStyleOptionGraphicsItem &other) | |
| QStyleOptionGraphicsItem & | operator=(const QStyleOptionGraphicsItem &) |
공개 변수
| QRectF | exposedRect |
정적 공용 멤버
| qreal | levelOfDetailFromTransform(const QTransform &worldTransform) |
상세 설명
성능상의 이유로 멤버 함수는 거의 없으며, 멤버 변수에 대한 액세스는 직접적으로 이루어집니다(즉, . 또는 -> 연산자를 사용). 이로 인해 구조체를 사용하기 쉬우며, 이러한 구조체가 단순히 스타일 함수에서 사용하는 매개변일 뿐임을 강조합니다.
QStyleOption 및 QGraphicsItem::paint()항목도 참조하십시오 .
멤버 유형 설명
enum QStyleOptionGraphicsItem::StyleOptionType
이 열거형은 스타일 옵션의 유형에 대한 정보를 담는 데 사용되며, 각 ` QStyleOption ` 하위 클래스에 대해 정의됩니다.
| 상수 | 상수명 | 상수값 |
|---|---|---|
QStyleOptionGraphicsItem::Type | SO_GraphicsItem | 제공된 스타일 옵션의 유형(이 클래스의 경우SO_GraphicsItem ). |
이 유형은 QStyleOption, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 유형을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 사용자 정의 QStyleOption 하위 클래스와 사용자 정의 스타일을 만들려는 경우가 아니라면 이 부분에 대해 걱정할 필요가 없습니다.
StyleOptionVersion도 참조하십시오 .
enum QStyleOptionGraphicsItem::StyleOptionVersion
이 열거형은 스타일 옵션의 버전에 대한 정보를 저장하는 데 사용되며, 각 QStyleOption 하위 클래스에 대해 정의됩니다.
| 상수 | 상수 | 상수값 |
|---|---|---|
QStyleOptionGraphicsItem::Version | 1 | 1 |
이 버전은 QStyleOption 의 하위 클래스에서 호환성을 해치지 않고 확장을 구현하는 데 사용됩니다. qstyleoption_cast()를 사용하는 경우, 일반적으로 이 값을 확인할 필요가 없습니다.
StyleOptionType도 참조하십시오 .
멤버 함수 문서
QStyleOptionGraphicsItem::QStyleOptionGraphicsItem()
QStyleOptionGraphicsItem을 생성합니다.
QStyleOptionGraphicsItem::QStyleOptionGraphicsItem(const QStyleOptionGraphicsItem &other)
other 의 복사본을 생성합니다.
[static] qreal QStyleOptionGraphicsItem::levelOfDetailFromTransform(const QTransform &worldTransform)
worldTransform 의 디테일 수준을 반환합니다.
이 값은 아이템을 그리는 데 사용된 페인터의 worldTransform 를 사용하여 매핑된 유니티 사각형의 최대 높이 및 너비 값을 나타냅니다. 기본적으로 변환이 적용되지 않은 경우, 이 값은 1입니다. 1:2로 축소된 경우 디테일 레벨은 0.5가 되고, 2:1로 확대된 경우 이 값은 2가 됩니다.
QGraphicsScene::minimumRenderSize()도 참조하십시오 .
[noexcept default] QStyleOptionGraphicsItem &QStyleOptionGraphicsItem::operator=(const QStyleOptionGraphicsItem &)
other 를 이 QStyleOptionGraphicsItem 인스턴스에 복사 할당합니다.
멤버 변수 설명
QRectF QStyleOptionGraphicsItem::exposedRect
이 변수는 아이템 좌표계에서 노출된 사각형을 저장합니다.
아이템의 일부만 노출된 경우, 이 사각형을 활용하여 아이템 그리기 속도를 높일 수 있습니다. 아이템 전체가 노출된 경우, 이 사각형은 ` QGraphicsItem::boundingRect()`와 동일합니다.
이 멤버는 QGraphicsItem::ItemUsesExtendedStyleOption 플래그가 설정된 아이템에 대해서만 초기화됩니다.
© 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.
