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 および が 0 個以上の の OR 組み合わせである場合にも使用できます。controls2 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

指定されたpainter を用いて、option で指定されたスタイルオプションで、指定されたcontrol を描画します。

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 を、option で指定されたスタイルオプションで、指定されたpainter で描画します。

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

指定された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

指定されたrectangle に、指定されたpainter とpalette を用いて、指定された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

与えられたプリミティブelement を、option で指定されたスタイルオプションを使用して、与えられたpainter で描画します。

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 パラメータは追加情報を渡すことができますが、パレットを含む必要があります。

すべての pixmap が適合するわけではないことに注意してください。

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 オブジェクト（またはそのサブクラスの1つ）へのポインタである。このオブジェクトは、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 は、メトリックの計算に使用できます。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

指定されたcontentsSize に基づき、指定されたoption とtype で記述された要素のサイズを返します。

引数option は、QStyleOption またはそのサブクラスの1つへのポインタです。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 は標準的な pixmap で、既存の 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 またはそのサブクラスの1つへのポインタであり、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 からウィジェットを削除してキャッシュし、スタイルが変更された後に再び挿入する場合などです。

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)

指定されたdirection に基づいてスクリーン座標に変換された、与えられたlogicalPosition を返します。boundingRectangle は、変換を実行するときに使用されます。

QWidget::layoutDirectionも参照してください 。

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

指定されたdirection に基づいてスクリーン座標に変換された、指定されたlogicalRectangle を返します。変換を行う際にはboundingRectangle が使用される。

この関数は、右から左へのデスクトップをサポートするために提供されており、通常、subControlRect() 関数の実装で使用される。

QWidget::layoutDirectionも参照して ください。