QStyle Class

./myapplication -style windows

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

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

    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:
    explicit CustomStyle(const QWidget *widget = nullptr);
    ~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)

지정된 size 에 따라, 주어진 rectangle 에 맞춰 지정된 alignment 및 direction 에 따라 정렬된 새로운 사각형을 반환합니다.

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개 이상의 의 OR 조합입니다. control types

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

layoutSpacing()도 참조하십시오 .

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

지정된 ` control `를, 제공된 ` painter `를 사용하여 ` option`에 명시된 스타일 옵션으로 그립니다.

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

option 매개변수는 QStyleOptionComplex 객체에 대한 포인터이며, qstyleoption_cast() 함수를 사용하여 올바른 서브클래스로 형변환할 수 있습니다. 지정된 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

지정된 ` element `를 제공된 ` painter `를 사용하여 ` option`로 지정된 스타일 옵션에 따라 그립니다.

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

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

여기에 나열되지 않은 컨트롤 요소가 있다면, 이는 해당 요소가 일반 QStyleOption 객체를 사용하기 때문입니다.

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

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

지정된 pixmap 를, 제공된 painter 를 사용하여, 지정된 alignment 에 따라, 지정된 rectangle 에 그립니다.

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

지정된 ` pixmap`의 복사본을 반환하며, 이 복사본은 지정된 ` iconMode `에 따라 스타일이 적용되고 ` option`로 지정된 색상 팔레트를 반영합니다.

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

모든 픽스맵이 이 조건을 충족하는 것은 아니며, 이 경우 반환되는 픽스맵은 단순한 복사본입니다.

QIcon도 참조하십시오 .

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

지정된 position 에 있는 하위 컨트롤을, 지정된 complex control 로 반환합니다( option 에 지정된 스타일 옵션이 적용됨).

position 는 화면 좌표로 표현된다는 점에 유의하십시오.

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

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

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

지정된 ` rectangle ` 내에서, 정의된 ` alignment`에 따라 지정된 ` pixmap `을 그릴 영역을 반환합니다.

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

지정된 rectangle 내에서, 지정된 글꼴 metrics 및 alignment 에 따라 제공된 text 을 그릴 영역을 반환합니다. 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 는 메트릭 계산에 사용될 수 있습니다. option 는 qstyleoption_cast() 함수를 사용하여 적절한 형식으로 형변환할 수 있습니다. option 는 이를 활용할 수 있는 PixelMetrics의 경우에도 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

지정된 ` option ` 및 ` type`에 의해 설명되는 요소의 크기를, 제공된 ` contentsSize`을 기준으로 반환합니다.

option 인자는 QStyleOption 또는 그 하위 클래스 중 하나를 가리키는 포인터입니다. option 는 qstyleoption_cast() 함수를 사용하여 적절한 형식으로 형변환할 수 있습니다. 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

제공된 스타일 option 로 정의된 주어진 widget 에 대한 지정된 스타일 hint 을 나타내는 정수를 반환합니다.

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

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

주어진 복소수 control 의 지정된 subControl 를 포함하는 사각형을 반환합니다(스타일은 option 로 지정됨). 이 사각형은 화면 좌표계로 정의됩니다.

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()`의 대응 함수입니다. 이 함수는 스타일이 동적으로 변경될 때마다 폴리싱 처리된 모든 위젯에 대해 호출되며, 새로운 스타일이 설정을 다시 폴리싱 처리하기 전에 이전 스타일의 설정을 폴리싱 해제해야 합니다.

unpolish()는 위젯이 소멸될 때만 호출된다는 점에 유의하십시오. 이는 경우에 따라 문제를 일으킬 수 있습니다. 예를 들어, UI에서 위젯을 제거한 후 캐시해 두었다가, 스타일이 변경된 후에 다시 삽입하는 경우 등이 해당되며, Qt Widgets의 일부 클래스는 위젯을 캐시합니다.

polish()도 참조하십시오 .

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

지정된 ` application`의 초기화를 해제합니다.

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

Qt::AlignAbsolute 가 없는 Qt::AlignLeft 또는 Qt::AlignRight 의 alignment 를, 레이아웃 direction 에 따라 Qt::AlignAbsolute 가 적용된 Qt::AlignLeft 또는 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도 참조하십시오 .