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

option で指定されたスタイルオプションで、指定されたpainter を使用して、指定された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

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

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

与えられた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

与えられたプリミティブ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 内の指定されたposition にあるサブコントロールを返します (option で指定されたスタイルオプション付き)。

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 （option で指定 さ れた ス タ イルを持つ） の、 指定 さ れたsubControl を含む矩形を返 し ます。矩形はスクリーン座標で定義される。

引数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)

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

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

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

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

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

QWidget::layoutDirectionも参照のこと 。