QStyle Class

./myapplication -style windows

void MyWidget::paintEvent(QPaintEvent * /* event */)
{
    QPainter painter(this);

    QStyleOptionFocusRect option;
    option.initFrom(this);
    option.backgroundColor = palette().color(QPalette::Background);

    style()->drawPrimitive(QStyle::PE_FrameFocusRect, &option, &painter, this);
}

    QStylePainter painter(this);
    ...
    painter.drawPrimitive(QStyle::PE_FrameFocusRect, option);

    QPainter painter(this);
    ...
    style()->drawPrimitive(QStyle::PE_FrameFocusRect, &option, &painter, this);

class CustomStyle : public QProxyStyle
{
    Q_OBJECT

public:
    CustomStyle(const QWidget *widget);
    ~CustomStyle() {}

    void drawPrimitive(PrimitiveElement element, const QStyleOption *option,
                       QPainter *painter, const QWidget *widget) const override;
};

void CustomStyle::drawPrimitive(PrimitiveElement element, const QStyleOption *option,
                                QPainter *painter, const QWidget *widget) const
{
    if (element == PE_IndicatorSpinUp || element == PE_IndicatorSpinDown) {
        QPolygon points(3);
        int x = option->rect.x();
        int y = option->rect.y();
        int w = option->rect.width() / 2;
        int h = option->rect.height() / 2;
        x += (option->rect.width() - w) / 2;
        y += (option->rect.height() - h) / 2;

        if (element == PE_IndicatorSpinUp) {
            points[0] = QPoint(x, y + h);
            points[1] = QPoint(x + w, y + h);
            points[2] = QPoint(x + w / 2, y);
        } else { // PE_SpinBoxDown
            points[0] = QPoint(x, y);
            points[1] = QPoint(x + w, y);
            points[2] = QPoint(x + w / 2, y + h);
        }

        if (option->state & State_Enabled) {
            painter->setPen(option->palette.mid().color());
            painter->setBrush(option->palette.buttonText());
        } else {
            painter->setPen(option->palette.buttonText().color());
            painter->setBrush(option->palette.mid());
        }
        painter->drawPolygon(points);
    } else {
        QProxyStyle::drawPrimitive(element, option, painter, widget);
    }
}

    const QSpinBox *spinBox = qobject_cast<const QSpinBox *>(widget);
    if (spinBox) {
    ...
    }

#include <QtWidgets>

#include "customstyle.h"

int main(int argc, char *argv[])
{
    QApplication::setStyle(new CustomStyle);
    QApplication app(argc, argv);
    QSpinBox spinBox;
    spinBox.show();
    return app.exec();
}

./myapplication -style custom

    switch (element) {
        case (PE_PanelItemViewItem): {
            painter->save();

            QPoint topLeft = option->rect.topLeft();
            QPoint bottomRight = option->rect.topRight();
            QLinearGradient backgroundGradient(topLeft, bottomRight);
            backgroundGradient.setColorAt(0.0, QColor(Qt::yellow).lighter(190));
            backgroundGradient.setColorAt(1.0, Qt::white);
            painter->fillRect(option->rect, QBrush(backgroundGradient));

            painter->restore();
        break;
        }
        default:
            QProxyStyle::drawPrimitive(element, option, painter, widget);
    }

멤버 함수 문서

QStyle::QStyle()

스타일 객체를 생성합니다.

[virtual noexcept] QStyle::~QStyle()

스타일 개체를 파괴합니다.

[static] QRect QStyle::alignedRect(Qt::LayoutDirection direction, Qt::Alignment alignment, const QSize &size, const QRect &rectangle)

지정된 alignment 및 direction 에 따라 지정된 rectangle 에 정렬된 지정된 size 의 새 직사각형을 반환합니다.

int QStyle::combinedLayoutSpacing(QSizePolicy::ControlTypes controls1, QSizePolicy::ControlTypes controls2, Qt::Orientation orientation, QStyleOption *option = nullptr, QWidget *widget = nullptr) const

레이아웃에서 controls1 와 controls2 사이에 사용해야 하는 간격을 반환합니다. orientation 는 컨트롤을 나란히 배치할지 또는 세로로 쌓을지를 지정합니다. option 매개변수는 부모 위젯에 대한 추가 정보를 전달하는 데 사용할 수 있습니다. widget 매개변수는 선택 사항이며 option 이 nullptr 인 경우에도 사용할 수 있습니다.

controls1 와 controls2 가 0 이상 control types 의 OR 조합인 경우에도 사용할 수 있습니다.

이 함수는 레이아웃 시스템에 의해 호출됩니다. PM_LayoutHorizontalSpacing 또는 PM_LayoutVerticalSpacing 이 음수 값을 반환하는 경우에만 사용됩니다.

layoutSpacing()도 참조하세요 .

[pure virtual] void QStyle::drawComplexControl(QStyle::ComplexControl control, const QStyleOptionComplex *option, QPainter *painter, const QWidget *widget = nullptr) const

option 에 지정된 스타일 옵션과 함께 제공된 painter 을 사용하여 주어진 control 을 그립니다.

widget 인수는 선택 사항이며 컨트롤을 그리는 데 보조적으로 사용할 수 있습니다.

option 매개 변수는 qstyleoption_cast() 함수를 사용하여 올바른 하위 클래스로 형변환할 수 있는 QStyleOptionComplex 객체에 대한 포인터입니다. 지정된 option 의 rect 멤버는 논리적 좌표에 있어야 합니다. 이 함수를 다시 구현할 때는 drawPrimitive() 또는 drawControl() 함수를 호출하기 전에 visualRect()를 사용하여 논리적 좌표를 화면 좌표로 변경해야 합니다.

아래 표에는 복잡한 제어 요소와 관련 스타일 옵션 하위 클래스가 나열되어 있습니다. 스타일 옵션에는 그림을 그릴 때 사용되는 style flags 을 포함하는 QStyleOption::state 을 포함하여 컨트롤을 그리는 데 필요한 모든 매개변수가 포함되어 있습니다. 이 표에는 지정된 option 을 적절한 하위 클래스로 캐스팅할 때 설정되는 플래그도 설명되어 있습니다.

drawPrimitive() 및 drawControl()도 참조하세요 .

[pure virtual] void QStyle::drawControl(QStyle::ControlElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = nullptr) const

option 에 지정된 스타일 옵션으로 주어진 painter 을 사용하여 주어진 element 을 그립니다.

widget 인수는 선택 사항이며 컨트롤을 그리는 데 보조적으로 사용할 수 있습니다. option 매개 변수는 qstyleoption_cast() 함수를 사용하여 올바른 하위 클래스로 캐스팅할 수 있는 QStyleOption 객체에 대한 포인터입니다.

아래 표에는 컨트롤 요소와 관련 스타일 옵션 하위 클래스가 나열되어 있습니다. 스타일 옵션에는 그릴 때 사용되는 스타일 플래그를 저장하는 QStyleOption::state 을 포함하여 컨트롤을 그리는 데 필요한 모든 매개 변수가 포함되어 있습니다. 이 표에는 지정된 옵션을 적절한 하위 클래스로 형변환할 때 설정되는 플래그도 설명되어 있습니다.

컨트롤 요소가 여기에 나열되지 않은 경우 일반 QStyleOption 객체를 사용하기 때문입니다.

drawPrimitive() 및 drawComplexControl()도 참조하십시오 .

[virtual] void QStyle::drawItemPixmap(QPainter *painter, const QRect &rectangle, int alignment, const QPixmap &pixmap) const

지정된 rectangle, 지정된 alignment, 지정된 painter 을 사용하여 지정된 pixmap 을 그립니다.

drawItemText()도 참조하세요 .

[virtual] void QStyle::drawItemText(QPainter *painter, const QRect &rectangle, int alignment, const QPalette &palette, bool enabled, const QString &text, QPalette::ColorRole textRole = QPalette::NoRole) const

제공된 painter 및 palette 을 사용하여 지정된 rectangle 에 주어진 text 을 그립니다.

텍스트는 페인터의 펜을 사용하여 그려지고 지정된 alignment 에 따라 정렬 및 래핑됩니다. 명시적으로 textRole 을 지정하면 지정된 역할에 대한 palette 의 색을 사용하여 텍스트를 그립니다. enabled 매개변수는 항목의 활성화 여부를 나타내며, 이 함수를 다시 구현할 때는 enabled 매개변수가 항목이 그려지는 방식에 영향을 주어야 합니다.

Qt::Alignment 및 drawItemPixmap()도 참조하세요 .

[pure virtual] void QStyle::drawPrimitive(QStyle::PrimitiveElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = nullptr) const

option 에 지정된 스타일 옵션을 사용하여 제공된 painter 으로 주어진 프리미티브 element 를 그립니다.

widget 인수는 선택 사항이며 기본 요소를 그리는 데 도움이 될 수 있는 위젯을 포함할 수 있습니다.

아래 표에는 기본 요소와 관련 스타일 옵션 서브클래스가 나열되어 있습니다. 스타일 옵션에는 그릴 때 사용되는 스타일 플래그를 포함하는 QStyleOption::state 등 요소를 그리는 데 필요한 모든 매개변수가 포함되어 있습니다. 이 표에는 주어진 옵션을 적절한 하위 클래스로 형변환할 때 설정되는 플래그도 설명되어 있습니다.

기본 요소가 여기에 나열되지 않은 경우 일반 QStyleOption 객체를 사용하기 때문이라는 점에 유의하세요.

drawComplexControl() 및 drawControl()도 참조하세요 .

[pure virtual] QPixmap QStyle::generatedIconPixmap(QIcon::Mode iconMode, const QPixmap &pixmap, const QStyleOption *option) const

지정된 iconMode 에 따라 스타일이 지정되고 option 에 지정된 팔레트를 고려한 지정된 pixmap 의 복사본을 반환합니다.

option 매개변수는 추가 정보를 전달할 수 있지만 팔레트를 포함해야 합니다.

모든 픽셀맵이 일치하는 것은 아니며, 이 경우 반환되는 픽셀맵은 일반 사본입니다.

QIcon 를참조하세요 .

[pure virtual] QStyle::SubControl QStyle::hitTestComplexControl(QStyle::ComplexControl control, const QStyleOptionComplex *option, const QPoint &position, const QWidget *widget = nullptr) const

지정된 복합체 control ( option 에 지정된 스타일 옵션 사용)에서 지정된 position 의 하위 컨트롤을 반환합니다.

position 은 화면 좌표로 표현된다는 점에 유의하세요.

option 인수는 QStyleOptionComplex 객체(또는 그 하위 클래스 중 하나)에 대한 포인터입니다. 이 객체는 qstyleoption_cast() 함수를 사용하여 적절한 유형으로 형변환할 수 있습니다. 자세한 내용은 drawComplexControl()를 참조하세요. widget 인수는 선택 사항이며 함수에 대한 추가 정보를 포함할 수 있습니다.

drawComplexControl() 및 subControlRect()도 참조하세요 .

[virtual] QRect QStyle::itemPixmapRect(const QRect &rectangle, int alignment, const QPixmap &pixmap) const

정의된 alignment 에 따라 지정된 pixmap 을 그릴 수 있는 주어진 rectangle 내의 영역을 반환합니다.

[virtual] QRect QStyle::itemTextRect(const QFontMetrics &metrics, const QRect &rectangle, int alignment, bool enabled, const QString &text) const

지정된 글꼴 metrics 및 alignment 에 따라 제공된 text 을 그릴 수 있는 주어진 rectangle 내의 영역을 반환합니다. enabled 매개변수는 관련 항목이 활성화되어 있는지 여부를 나타냅니다.

지정된 rectangle 이 text 을 렌더링하는 데 필요한 영역보다 큰 경우 반환되는 직사각형은 지정된 alignment 에 따라 rectangle 내에서 오프셋됩니다. 예를 들어 alignment 가 Qt::AlignCenter 인 경우 반환되는 사각형은 rectangle 내에서 중앙에 위치합니다. 지정된 rectangle 이 필요한 영역보다 작으면 반환되는 사각형은 text 을 렌더링하기에 충분한 가장 작은 사각형이 됩니다.

Qt::Alignment도 참조하십시오 .

[pure virtual] int QStyle::layoutSpacing(QSizePolicy::ControlType control1, QSizePolicy::ControlType control2, Qt::Orientation orientation, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const

레이아웃에서 control1 와 control2 사이에 사용해야 하는 간격을 반환합니다. orientation 는 컨트롤을 나란히 배치할지 또는 세로로 쌓을지를 지정합니다. option 매개변수는 부모 위젯에 대한 추가 정보를 전달하는 데 사용할 수 있습니다. widget 매개변수는 선택 사항이며 option 이 nullptr 인 경우에도 사용할 수 있습니다.

이 함수는 레이아웃 시스템에 의해 호출됩니다. PM_LayoutHorizontalSpacing 또는 PM_LayoutVerticalSpacing 이 음수 값을 반환하는 경우에만 사용됩니다.

combinedLayoutSpacing()도 참조하세요 .

[since 6.1] QString QStyle::name() const

스타일의 이름을 반환합니다.

이 값은 QStyleFactory::create()로 스타일을 만드는 데 사용할 수 있습니다.

이 함수는 Qt 6.1에 도입되었습니다.

QStyleFactory::create()도 참조하십시오 .

[pure virtual] int QStyle::pixelMetric(QStyle::PixelMetric metric, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const

지정된 픽셀의 값을 반환합니다 metric.

지정된 option 및 widget 은 메트릭을 계산하는 데 사용할 수 있습니다. qstyleoption_cast () 함수를 사용하여 option 을 적절한 유형으로 형변환할 수 있습니다. option 을 사용할 수 있는 픽셀 메트릭의 경우에도 0이 될 수 있습니다. 적절한 option 형변환은 아래 표를 참조하세요:

일부 픽셀 메트릭은 위젯에서 호출되고 일부 픽셀 메트릭은 스타일 내부적으로만 호출됩니다. 메트릭이 위젯에서 호출되지 않는 경우 이를 사용하는 것은 스타일 작성자의 재량입니다. 일부 스타일의 경우 이 방법이 적절하지 않을 수 있습니다.

[virtual] void QStyle::polish(QWidget *widget)

주어진 widget 의 모양을 초기화합니다.

이 함수는 모든 위젯이 완전히 생성된 후 처음 표시되기 직전에 모든 위젯에 대해 호출됩니다.

기본 구현은 아무 작업도 수행하지 않습니다. 이 함수의 합리적인 작업은 위젯에 대한 QWidget::setBackgroundMode() 함수를 호출하는 것일 수 있습니다. 예를 들어 지오메트리를 설정하는 데 이 함수를 사용하지 마십시오. 이 함수를 다시 구현하면 위젯의 모양을 변경할 수 있는 백도어를 제공하지만, Qt의 스타일 엔진에서는 이 함수를 구현할 필요가 거의 없습니다; 대신 drawItemPixmap(), drawItemText(), drawPrimitive() 등을 다시 구현하십시오.

QWidget::inherits() 함수는 클래스별 커스터마이징을 허용하기에 충분한 정보를 제공할 수 있습니다. 그러나 새로운 QStyle 하위 클래스는 현재 및 향후 모든 위젯에서 합리적으로 작동할 것으로 예상되므로 하드 코딩된 사용자 정의는 제한적으로 사용하는 것이 좋습니다.

unpolish()도 참조하세요 .

[virtual] void QStyle::polish(QApplication *application)

오버로드된 함수입니다.

주어진 application 객체의 초기화가 늦어집니다.

[virtual] void QStyle::polish(QPalette &palette)

과부하가 걸린 함수입니다.

색상표에 대한 스타일별 요구 사항(있는 경우)에 따라 palette 을 변경합니다.

QPalette 및 QApplication::setPalette()도 참조하세요 .

const QStyle *QStyle::proxy() const

이 함수는 이 스타일에 대한 현재 프록시를 반환합니다. 기본적으로 대부분의 스타일은 자체적으로 반환합니다. 그러나 프록시 스타일이 사용 중인 경우 스타일이 프록시로 다시 호출할 수 있도록 허용합니다.

[pure virtual] QSize QStyle::sizeFromContents(QStyle::ContentsType type, const QStyleOption *option, const QSize &contentsSize, const QWidget *widget = nullptr) const

제공된 contentsSize 에 따라 지정된 option 및 type 에 설명된 요소의 크기를 반환합니다.

option 인수는 QStyleOption 또는 그 하위 클래스 중 하나에 대한 포인터입니다. qstyleoption_cast () 함수를 사용하여 option 을 적절한 유형으로 형변환할 수 있습니다. widget 인수는 선택적 인수이며 크기를 계산하는 데 사용되는 추가 정보를 포함할 수 있습니다.

적절한 option 형변환은 아래 표를 참조하세요:

ContentsType 및 QStyleOption 을참조하세요 .

[static] int QStyle::sliderPositionFromValue(int min, int max, int logicalValue, int span, bool upsideDown = false)

주어진 logicalValue 을 픽셀 위치로 변환합니다. min 매개변수는 0에 매핑되고 max 은 span 에 매핑되며 다른 값은 그 사이에 균등하게 분포됩니다.

이 함수는 span 가 4096 미만인 경우 오버플로 없이 전체 정수 범위를 처리할 수 있습니다.

기본적으로 이 함수는 가로 항목의 경우 최대값이 오른쪽에, 세로 항목의 경우 아래쪽에 있다고 가정합니다. 이 동작을 반전시키려면 upsideDown 매개 변수를 true로 설정합니다.

sliderValueFromPosition()도 참조하세요 .

[static] int QStyle::sliderValueFromPosition(int min, int max, int position, int span, bool upsideDown = false)

주어진 픽셀 position 을 논리적 값으로 변환합니다. 0은 min 매개변수에 매핑되고 span 은 max 에 매핑되며 다른 값은 그 사이에 균등하게 분포됩니다.

이 함수는 오버플로 없이 전체 정수 범위를 처리할 수 있습니다.

기본적으로 이 함수는 가로 항목의 경우 최대값이 오른쪽에, 세로 항목의 경우 아래쪽에 있다고 가정합니다. 이 동작을 반전시키려면 upsideDown 매개 변수를 true로 설정합니다.

sliderPositionFromValue()도 참조하세요 .

[pure virtual] QIcon QStyle::standardIcon(QStyle::StandardPixmap standardIcon, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const

주어진 standardIcon 에 대한 아이콘을 반환합니다.

standardIcon 은 기존 GUI 스타일이나 가이드라인을 따를 수 있는 표준 픽셀맵입니다. option 인수는 적절한 아이콘을 정의할 때 필요한 추가 정보를 전달하는 데 사용할 수 있습니다. widget 인수는 선택 사항이며 아이콘을 결정하는 데에도 사용할 수 있습니다.

[virtual] QPalette QStyle::standardPalette() const

스타일의 표준 팔레트를 반환합니다.

시스템 색상을 지원하는 시스템에서는 스타일의 표준 팔레트가 사용되지 않습니다. 특히 Windows Vista 및 Mac 스타일은 표준 팔레트를 사용하지 않고 기본 테마 엔진을 사용합니다. 이러한 스타일에서는 QApplication::setPalette()로 팔레트를 설정해서는 안 됩니다.

QApplication::setPalette()도 참조하세요 .

[pure virtual] int QStyle::styleHint(QStyle::StyleHint hint, const QStyleOption *option = nullptr, const QWidget *widget = nullptr, QStyleHintReturn *returnData = nullptr) const

widget 제공된 스타일 option 에 대해 지정된 스타일 hint 을 나타내는 정수를 반환합니다.

returnData 쿼리하는 위젯에 styleHint()가 반환하는 정수보다 더 자세한 데이터가 필요할 때 사용됩니다. 자세한 내용은 QStyleHintReturn 클래스 설명을 참조하세요.

[pure virtual] QRect QStyle::subControlRect(QStyle::ComplexControl control, const QStyleOptionComplex *option, QStyle::SubControl subControl, const QWidget *widget = nullptr) const

지정된 복합체 control ( option 에 지정된 스타일 사용)의 지정된 subControl 을 포함하는 사각형을 반환합니다. 사각형은 화면 좌표로 정의됩니다.

option 인수는 QStyleOptionComplex 또는 그 하위 클래스 중 하나에 대한 포인터이며 qstyleoption_cast() 함수를 사용하여 적절한 유형으로 형변환할 수 있습니다. 자세한 내용은 drawComplexControl()를 참조하세요. widget 인수는 선택 사항이며 함수에 대한 추가 정보를 포함할 수 있습니다.

drawComplexControl()도 참조하세요 .

[pure virtual] QRect QStyle::subElementRect(QStyle::SubElement element, const QStyleOption *option, const QWidget *widget = nullptr) const

제공된 스타일 option 에 설명된 대로 주어진 element 에 대한 하위 영역을 반환합니다. 반환된 사각형은 화면 좌표로 정의됩니다.

widget 인수는 선택 사항이며 면적을 결정하는 데 사용할 수 있습니다. QStyleOption 객체는 qstyleoption_cast() 함수를 사용하여 적절한 유형으로 형변환할 수 있습니다. 적절한 option 형변환은 아래 표를 참조하세요:

[virtual] void QStyle::unpolish(QWidget *widget)

주어진 widget 의 모양을 초기화 해제합니다.

이 함수는 polish()에 대응하는 함수입니다. 스타일이 동적으로 변경될 때마다 폴리싱된 모든 위젯에 대해 호출되며, 이전 스타일은 새 스타일이 설정을 다시 폴리싱하기 전에 폴리싱을 해제해야 합니다.

위젯이 소멸된 경우에만 언폴리싱()이 호출된다는 점에 유의하세요. 이는 UI에서 위젯을 제거하고 캐시했다가 스타일이 변경된 후에 다시 삽입하는 경우와 같이 일부 경우에 문제를 일으킬 수 있습니다; Qt의 일부 클래스는 위젯을 캐시합니다.

polish()도 참조하십시오 .

[virtual] void QStyle::unpolish(QApplication *application)

이 함수는 과부하가 걸린 함수입니다.

주어진 application 을 초기화 해제합니다.

[static] Qt::Alignment QStyle::visualAlignment(Qt::LayoutDirection direction, Qt::Alignment alignment)

레이아웃 direction 에 따라 Qt::AlignAbsolute 없는 Qt::AlignLeft 또는 Qt::AlignRight 의 alignment 를 Qt::AlignLeft 또는 Qt::AlignAbsolute 있는 Qt::AlignRight 로 변환합니다. 다른 정렬 플래그는 그대로 유지됩니다.

가로 맞춤을 지정하지 않으면 이 함수는 지정된 레이아웃의 기본 맞춤 direction 을 반환합니다.

QWidget::layoutDirection

[static] QPoint QStyle::visualPos(Qt::LayoutDirection direction, const QRect &boundingRectangle, const QPoint &logicalPosition)

지정된 logicalPosition 을 지정된 direction 을 기준으로 화면 좌표로 변환하여 반환합니다. boundingRectangle 은 번역을 수행할 때 사용됩니다.

QWidget::layoutDirection도 참조하세요 .

[static] QRect QStyle::visualRect(Qt::LayoutDirection direction, const QRect &boundingRectangle, const QRect &logicalRectangle)

지정된 logicalRectangle 을 지정된 direction 을 기준으로 화면 좌표로 변환하여 반환합니다. boundingRectangle 은 번역을 수행할 때 사용됩니다.

이 함수는 오른쪽에서 왼쪽 데스크톱을 지원하기 위해 제공되며 일반적으로 subControlRect() 함수의 구현에 사용됩니다.

QWidget::layoutDirection도 참조하세요 .