QStyleOption Class

void MyPushButton::paintEvent(QPaintEvent *)
{
    QStyleOptionButton option;
    option.initFrom(this);
    option.state = isDown() ? QStyle::State_Sunken : QStyle::State_Raised;
    if (isDefault())
        option.features |= QStyleOptionButton::DefaultButton;
    option.text = text();
    option.icon = icon();

    QPainter painter(this);
    style()->drawControl(QStyle::CE_PushButton, &option, &painter, this);
}

void MyStyle::drawPrimitive(PrimitiveElement element,
                            const QStyleOption *option,
                            QPainter *painter,
                            const QWidget *widget)
{
    if (element == PE_FrameFocusRect) {
        const QStyleOptionFocusRect *focusRectOption =
                qstyleoption_cast<const QStyleOptionFocusRect *>(option);
        if (focusRectOption) {
            // ...
        }
    }
    // ...
}

メンバー変数ドキュメント

Qt::LayoutDirection QStyleOption::direction

この変数は、コントロールにテキストを描画するときに使用するテキストレイアウト方向を保持する。

デフォルトでは、レイアウト方向はQt::LeftToRight です。

initFrom()も参照 。

QFontMetrics QStyleOption::fontMetrics

この変数は、コントロールでテキストを描画するときに使用するフォント・メトリクスを保持する。

デフォルトでは、アプリケーションのデフォルトフォントが使用されます。

initFrom()も参照してください 。

QPalette QStyleOption::palette

この変数は、コントロールをペイントするときに使用するパレットを保持する。

デフォルトでは、アプリケーションのデフォルトパレットが使用されます。

initFrom()も参照 。

QRect QStyleOption::rect

この変数は、様々な計算やペイントに使用される面積を保持する。

これは要素の種類によって異なる意味を持ちます。例えば、QStyle::CE_PushButton 要素の場合はボタン全体の矩形となり、QStyle::CE_PushButtonLabel 要素の場合はプッシュボタンラベルの領域のみとなります。

デフォルト値はヌル矩形、つまり幅も高さも 0 に設定された矩形です。

initFrom()も参照してください 。

QStyle::State QStyleOption::state

この変数は、コントロールを描画するときに使用されるスタイルフラグを保持する。

デフォルト値はQStyle::State_None 。

initFrom(),QStyle::drawPrimitive(),QStyle::drawControl(),QStyle::drawComplexControl(),QStyle::Stateも参照 。

QObject *QStyleOption::styleObject

この変数はスタイルされるオブジェクトを保持します。

組み込みスタイルは以下の型をサポートしています：QWidget QGraphicsObject とQQuickItem 。

initFrom()も参照してください 。

int QStyleOption::type

この変数はスタイルオプションのオプションタイプを保持します。

デフォルト値はSO_Default です。

OptionTypeも参照してください 。

int QStyleOption::version

この変数は、スタイル・オプションのバージョンを保持します。

この値は、サブクラスが互換性を壊すことなく拡張機能を実装するために使用することができます。qstyleoption_cast() 関数を使用する場合、通常はこの値をチェックする必要はありません。

デフォルト値は 1 です。

void MyStyle::drawPrimitive(PrimitiveElement element,
                            const QStyleOption *option,
                            QPainter *painter,
                            const QWidget *widget)
{
    if (element == PE_FrameFocusRect) {
        const QStyleOptionFocusRect *focusRectOption =
                qstyleoption_cast<const QStyleOptionFocusRect *>(option);
        if (focusRectOption) {
            // ...
        }
    }
    // ...
}