Qt スタイルシートリファレンス

Qtスタイルシートは、ウィジェットの外観をカスタマイズできるようにする、さまざまなプロパティ、疑似状態、およびサブコントロールをサポートしています。

スタイル設定可能なウィジェットのリスト

以下の表は、スタイルシートを使用してカスタマイズできる Qt Widgetsの一覧です：

QPushButton { background-color: red; border: none; }

QToolButton { background-color: red; border: none; }

void CustomWidget::paintEvent(QPaintEvent *)
{
    QStyleOption opt;
    opt.initFrom(this);
    QPainter p(this);
    style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);
}

プロパティの一覧

このセクションでは、Qt Style Sheets でサポートされているすべてのプロパティを一覧表示します。プロパティに指定できる値は、そのプロパティの型によって異なります。特に指定がない限り、以下のプロパティはすべてのウィジェットに適用されます。 アスタリスク * が付いているプロパティは Qt 固有のものであり、CSS2 や CSS3 には対応するプロパティがありません。Qt 固有のプロパティは以下の通りです:

• gridline-color*
• image*
• lineedit-password-character*
• lineedit-password-mask-delay*
• メッセージボックスのテキスト・インタラクションフラグ*
• 不透明度*
• プレースホルダーテキストの色*
• 選択背景色*
• 選択色*
• 選択時の装飾を表示*
• spacing*
• サブコントロールの原点*
• サブコントロールの位置*
• ウィジェット・アニメーション・持続時間*

アクセント色

このプロパティは、インタラクティブなUI要素を強調表示するために使用される「Accent 」を設定します。このプロパティが設定されていない場合、デフォルトでは「highlight 」の色が使用されます。

alternate-background-color

QAbstractItemView のサブクラスで使用されるalternate background color 。

このプロパティが設定されていない場合、デフォルト値はパレットのAlternateBase ロールに設定されている値になります。

例：

QTreeView {
    alternate-background-color: blue;
    background: yellow;
}

「background」および「selection-background-color」も参照してください。

background

背景を設定するための省略表記。background-color 、background-image 、background-repeat 、および/またはbackground-position を指定することと同等です。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QDialog 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSplitter 、QTextEdit 、QToolTip 、およびプレーンのQWidgetでサポートされています。

例：

QTextEdit { background: yellow }

多くの場合、Qt::BrushStyle に示されているスタイルと同様の塗りつぶしパターンを設定する必要があります。Qt::SolidPattern 、Qt::RadialGradientPattern 、Qt::LinearGradientPattern 、Qt::ConicalGradientPattern に対しては、background-color プロパティを使用できます。その他のパターンは、そのパターンを含む背景画像を作成することで簡単に実現できます。

例：

QLabel {
    background-image: url(dense6pattern.png);
    background-repeat: repeat-xy;
}

関連項目：background-origin、selection-background-color、background-clip、background-attachment、alternate-background-color。

background-color

ウィジェットに使用される背景色。

例：

QLabel { background-color: yellow }
QLineEdit { background-color: rgb(255, 0, 0) }

background-image

ウィジェットに使用される背景画像。画像の半透明部分からは、background-color が透けて見えます。

例：

QFrame { background-image: url(:/images/hydro.png) }

background-repeat

背景画像をbackground-origin 矩形全体に配置するために、繰り返しを行うかどうか、およびその方法。

このプロパティが指定されていない場合、背景画像は両方向（repeat ）に繰り返し表示されます。

例：

QFrame {
    background: white url(:/images/ring.png);
    background-repeat: repeat-y;
    background-position: left;
}

background-position

background-origin 矩形内における背景画像の位置合わせ。

このプロパティが指定されていない場合、配置はtop left となります。

例：

QFrame {
    background: url(:/images/footer.png);
    background-position: bottom left;
}

background-attachment

QAbstractScrollArea 内の背景画像が、ビューポートに対してスクロールされるか固定されるかを決定します。デフォルトでは、背景画像はビューポートに合わせてスクロールされます。

例：

QTextEdit {
    background-image: url("leaves.png");
    background-attachment: fixed;
}

「background」も参照してください

background-clip

background が描画されるウィジェットの矩形。

このプロパティは、background-color およびbackground-image がクリップされる矩形を指定します。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QDialog 、QFrame 、QGroupBox 、QLabel 、QPushButton 、QRadioButton 、QSplitter 、QTextEdit 、QToolTip 、およびプレーンのQWidgetでサポートされています。

このプロパティが指定されていない場合、デフォルトはborder となります。

例：

QFrame {
    background-image: url(:/images/header.png);
    background-position: top left;
    background-origin: content;
    background-clip: padding;
}

関連項目：background、background-origin、およびボックスモデル。

background-origin

ウィジェットの背景矩形。background-position およびbackground-image と組み合わせて使用します。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QDialog 、QFrame 、QGroupBox 、QLabel 、QPushButton 、QRadioButton 、QSplitter 、QTextEdit 、QToolTip 、および通常のQWidgetでサポートされています。

このプロパティが指定されていない場合、デフォルトはpadding となります。

例：

QFrame {
    background-image: url(:/images/header.png);
    background-position: top left;
    background-origin: content;
}

「background」および「ボックスモデル」も参照してください。

border

ウィジェットの境界線を設定するための省略表記です。border-color 、border-style 、および/またはborder-width を指定することと同等です。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSplitter 、QTextEdit 、QToolTip 、および通常のQWidgetでサポートされています。

例：

QLineEdit { border: 1px solid white }

border-top

ウィジェットの上側の境界線を設定するための省略表記です。border-top-color 、border-top-style 、および/またはborder-top-width を指定することと同等です。

border-right

ウィジェットの右側の境界線を設定するための省略表記です。border-right-color 、border-right-style 、および/またはborder-right-width を指定することと同等です。

border-bottom

ウィジェットの底辺の境界線を設定するための短縮表記です。border-bottom-color 、border-bottom-style 、および/またはborder-bottom-width を指定することと同等です。

border-left

ウィジェットの左枠線を設定するための短縮表記です。border-left-color 、border-left-style 、および/またはborder-left-width を指定することと同等です。

border-color

すべての境界線の色の指定。border-top-color 、border-right-color 、border-bottom-color 、およびborder-left-color を指定することと同等です。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSplitter 、QTextEdit 、QToolTip 、およびプレーンのQWidgetでサポートされています。

このプロパティが指定されていない場合、デフォルトではcolor（つまり、ウィジェットの前景色）になります。

例：

QLineEdit {
    border-width: 1px;
    border-style: solid;
    border-color: white;
}

関連項目：border-style、border-width、border-image、およびボックスモデル。

border-top-color

境界線の上端の色。

border-right-color

境界線の右端の色。

border-bottom-color

境界線の底辺の色。

border-left-color

境界線の左端の色。

border-image

境界線を埋めるために使用される画像です。画像は9つの部分に分割され、必要に応じて適切に伸縮されます。詳細については、「境界線画像」を参照してください。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSplitter 、QTextEdit 、およびQToolTip でサポートされています。

「border-color」、「border-style」、「border-width」、および「ボックスモデル」も参照してください。

border-radius

境界線の角の半径。border-top-left-radius 、border-top-right-radius 、border-bottom-right-radius 、およびborder-bottom-left-radius を指定することと同等です。

border-radius は、要素の背景を切り取ります。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSplitter 、QTextEdit 、およびQToolTip でサポートされています。

このプロパティが指定されていない場合、デフォルト値は 0 になります。

例：

QLineEdit {
    border-width: 1px;
    border-style: solid;
    border-radius: 4px;
}

「border-width」および「ボックスモデル」も参照してください。

border-top-left-radius

境界線の左上隅の半径。

border-top-right-radius

境界線の右上隅の半径。

border-bottom-right-radius

境界線の右下隅の半径。このプロパティに正の値を指定すると、角が丸くなります。

border-bottom-left-radius

境界線の左下隅の半径。このプロパティに正の値を指定すると、角が丸くなります。

border-style

すべての枠線のスタイル。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSplitter 、QTextEdit 、およびQToolTip でサポートされています。

このプロパティが指定されていない場合、デフォルト値はnone となります。

例：

QLineEdit {
    border-width: 1px;
    border-style: solid;
    border-color: blue;
}

関連項目：border-color、border-style、border-image、および「ボックスモデル」。

border-top-style

境界線の上端のスタイル。

border-right-style

境界線の右端のスタイル。

border-bottom-style

境界線の下端のスタイル。

border-left-style

境界線の左端のスタイル。

border-width

境界線の幅。border-top-width 、border-right-width 、border-bottom-width 、およびborder-left-width を設定することと同等です。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSplitter 、QTextEdit 、およびQToolTip でサポートされています。

例：

QLineEdit {
    border-width: 2px;
    border-style: solid;
    border-color: darkblue;
}

関連項目：border-color、border-radius、border-style、border-image、およびボックスモデル。

border-top-width

境界線の上端の幅。

border-right-width

境界線の右端の幅。

border-bottom-width

境界線の底辺の幅。

border-left-width

境界線の左端の幅。

bottom

positionが `relative `（デフォルト）の場合、サブコントロールを指定されたオフセット分だけ上方向に移動します。 bottom: y を指定することは、 top: -yを指定することと同じになる。

positionが `absolute` の場合、bottom プロパティは、親コントロールの下端に対するサブコントロールの下端の位置を指定します（subcontrol-origin も参照してください）。

例：

QSpinBox::down-button { bottom: 2px }

「left」、「right」、「top」も参照してください。

button-layout

QDialogButtonBox またはQMessageBox におけるボタンのレイアウト。取り得る値は、0 (WinLayout)、1 (MacLayout)、2 (KdeLayout)、3 (GnomeLayout)、および5 (AndroidLayout)です。

このプロパティが指定されていない場合、デフォルトでは、現在のスタイルでSH_DialogButtonLayout スタイルヒントに対して指定されている値が適用されます。

例：

* { button-layout: 2 }

color

テキストの描画に使用される色。

このプロパティは、QWidget::palette に従うすべてのウィジェットでサポートされています。

このプロパティが設定されていない場合、デフォルトはウィジェットのパレットでQWidget::foregroundRole に対して設定されている色（通常は黒）になります。

例：

QPushButton { color: red }

「background」および「selection-color」も参照してください。

dialogbuttonbox-buttons-have-icons

QDialogButtonBox 内のボタンにアイコンを表示するかどうか

このプロパティが 1 に設定されている場合、QDialogButtonBox のボタンにアイコンが表示されます。0 に設定されている場合は、アイコンは表示されません。

アイコンの設定方法については、「アイコンの一覧」のセクションを参照してください。

QDialogButtonBox { dialogbuttonbox-buttons-have-icons: 1; }

font

テキストのフォントを設定するための省略表記です。font-family 、font-size 、font-style 、および/またはfont-weight を指定することと同等です。

このプロパティは、QWidget::font を遵守するすべてのウィジェットでサポートされています。

このプロパティが設定されていない場合、デフォルト値は `QWidget::font` となります。

例：

QCheckBox { font: bold italic large "Times New Roman" }

font-family

フォントファミリー。

例：

QCheckBox { font-family: "New Century Schoolbook" }

font-size

フォントサイズ。このバージョンのQtでは、ptおよびpx単位のみがサポートされています。

例：

QTextEdit { font-size: 12px }

font-style

フォントスタイル。

例：

QTextEdit { font-style: italic }

font-weight

フォントの太さ。

gridline-color*

QTableView 内のグリッド線の色。

このプロパティが指定されていない場合、SH_Table_GridLineColor のスタイルヒントに対して現在のスタイルで指定されている値がデフォルトとして適用されます。

例：

* { gridline-color: gray }

height

サブコントロール（場合によってはウィジェット）の高さ。

このプロパティが指定されていない場合、サブコントロール／ウィジェットおよび現在のスタイルに応じて、デフォルト値が設定されます。

例：

QSpinBox::down-button { height: 10px }

「width」も参照してください。

アイコン

アイコンを持つウィジェットで使用されるアイコン。

現在、このプロパティをサポートしているウィジェットはQPushButton のみです。

バージョン5.15から利用可能です。

icon-size

ウィジェット内のアイコンの幅と高さ。

このプロパティを使用して、以下のウィジェットのアイコンサイズを設定できます。

• QCheckBox
• QListView
• QPushButton
• QRadioButton
• QTabBar
• QToolBar
• QToolBox
• QTreeView

image*

サブコントロールのコンテンツ矩形内に描画される画像。

imageプロパティには、URLのリストまたはsvg を指定できます。実際に描画される画像は、QIcon と同じアルゴリズムを使用して決定されます（つまり、画像は拡大されることはなく、必要に応じて常に縮小されます）。svg が指定された場合、画像はコンテンツ矩形のサイズに合わせてスケーリングされます。svg のサイズ設定は、widthおよびheightプロパティを使用して行うことができます（Qt 6.13以降でサポート）。

サブコントロールの image プロパティを設定すると、そのサブコントロールの width および height が暗黙的に設定されます（SVG 内の画像を除く）。

image-positionを使用して、矩形内での画像の位置を調整します。

このプロパティはサブコントロール専用であり、他の要素ではサポートされていません。

例：

// implicitly sets the size of down-button to the
// size of spindown.png
QSpinBox::down-button { image: url(:/images/spindown.png) }

image-position

画像の位置揃えは、相対位置または絶対位置を使用して指定できます。

left

positionが relative （デフォルト）の場合、サブコントロールを指定されたオフセット分だけ右に移動します。

positionが absolute の場合、left プロパティは、親コントロールの左端を基準としたサブコントロールの左端の位置を指定します（subcontrol-originも参照してください）。

このプロパティが指定されていない場合、デフォルトは0 となります。

例：

QSpinBox::down-button { left: 2px }

「right」、「top」、「bottom」も参照してください。

文字間隔

ウィジェット内の文字列における文字間のスペース。

lineedit-password-character*

QLineEdit のパスワード文字を表すUnicode番号。

このプロパティが指定されていない場合、デフォルトでは、現在のスタイルで「SH_LineEdit_PasswordCharacter 」スタイルヒントに指定された値が使用されます。

例：

* { lineedit-password-character: 9679 }

lineedit-password-mask-delay*

「QLineEdit 」のパスワードマスクの遅延時間（ミリ秒単位）。この時間が経過した後、「lineedit-password-character」が可視文字に適用されます。

このプロパティが指定されていない場合、デフォルトでは、SH_LineEdit_PasswordMaskDelay スタイルヒントに対して現在のスタイルで指定された値が適用されます。

Qt 5.4 以降で利用可能です。

例：

* { lineedit-password-mask-delay: 1000 }

margin

ウィジェットの余白。margin-top 、margin-right 、margin-bottom 、およびmargin-left を指定することと同等です。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSplitter 、QTextEdit 、およびQToolTip でサポートされています。

このプロパティが指定されていない場合、デフォルト値は0 となります。

例：

QLineEdit { margin: 2px }

「padding」、「spacing」、および「ボックスモデル」も参照してください。

margin-top

ウィジェットの上部マージン。

margin-right

ウィジェットの右マージン。

margin-bottom

ウィジェットの下側の余白。

margin-left

ウィジェットの左マージン。

max-height

ウィジェットまたはサブコントロールの最大高さ。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSizeGrip 、QSpinBox 、QSplitter 、QStatusBar 、QTextEdit 、およびQToolTip でサポートされています。

この値は、ボックスモデルにおけるコンテンツ矩形を基準としています。

例：

QSpinBox { max-height: 24px }

「max-width」も参照してください。

max-width

ウィジェットまたはサブコントロールの最大幅。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSizeGrip 、QSpinBox 、QSplitter 、QStatusBar 、QTextEdit 、およびQToolTip でサポートされています。

この値は、ボックスモデルにおけるコンテンツ矩形を基準としています。

例：

QComboBox { max-width: 72px }

「max-height」も参照してください。

messagebox-text-interaction-flags*

メッセージボックス内のテキストに対する操作の挙動。取り得る値は、Qt::TextInteractionFlags に基づいています。

このプロパティが指定されていない場合、SH_MessageBox_TextInteractionFlags スタイルヒントに対して現在のスタイルで指定されている値がデフォルトとして使用されます。

例：

QMessageBox { messagebox-text-interaction-flags: 5 }

min-height

ウィジェットまたはサブコントロールの最小高さ。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSizeGrip 、QSpinBox 、QSplitter 、QStatusBar 、QTextEdit 、QToolButton 、およびQToolTip でサポートされています。

このプロパティが指定されていない場合、最小の高さはウィジェットのコンテンツとスタイルに基づいて算出されます。

この値は、ボックスモデルにおけるコンテンツ矩形を基準としています。

例：

QComboBox { min-height: 24px }

「min-width」も参照してください。

min-width

ウィジェットまたはサブコントロールの最小幅。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSizeGrip 、QSpinBox 、QSplitter 、QStatusBar 、QTextEdit 、QToolButton 、およびQToolTip でサポートされています。

このプロパティが指定されていない場合、最小幅はウィジェットのコンテンツとスタイルに基づいて算出されます。

この値は、ボックスモデルにおけるコンテンツ矩形を基準としています。

例：

QComboBox { min-width: 72px }

「min-height」も参照してください。

opacity*

ウィジェットの不透明度。指定可能な値は 0（透明）から 255（不透明）までです。現時点では、tooltips でのみサポートされています。

このプロパティが指定されていない場合、SH_ToolTipLabel_Opacity のスタイルヒントで指定された値がデフォルトとして適用されます。

例：

QToolTip { opacity: 223 }

outline

オブジェクトの境界線に沿って描画されるアウトライン。

outline-color

アウトラインの色。border-colorも参照してください。

outline-offset

ウィジェットの境界線からのアウトラインのオフセット。

outline-style

アウトラインの描画に使用されるパターンを指定します。border-styleも参照してください。

outline-radius

アウトラインの角を丸くします。

outline-bottom-left-radius

アウトラインの左下角の丸みの半径。

outline-bottom-right-radius

アウトラインの右下角の丸みの半径。

outline-top-left-radius

アウトラインの左上隅の半径。

outline-top-right-radius

アウトラインの右上角の丸みの半径。

パディング

ウィジェットのパディング。padding-top 、padding-right 、padding-bottom 、padding-left を指定することと同等です。

このプロパティは、QAbstractItemView のサブクラス、QAbstractSpinBox のサブクラス、QCheckBox 、QComboBox 、QFrame 、QGroupBox 、QLabel 、QLineEdit 、QMenu 、QMenuBar 、QPushButton 、QRadioButton 、QSplitter 、QTextEdit 、およびQToolTip でサポートされています。

このプロパティが指定されていない場合、デフォルト値は0 となります。

例：

QLineEdit { padding: 3px }

関連項目：margin、spacing、およびボックスモデル。

padding-top

ウィジェットの上側のパディング。

padding-right

ウィジェットの右側のパディング。

padding-bottom

ウィジェットの下側のパディング。

padding-left

ウィジェットの左側のパディング。

空の領域の行と列の色を交互に塗る

QTreeView が、空の領域（つまり、アイテムが存在しない領域）に対して、行の色を交互に塗り分けるかどうか

placeholder-text-color*

テキスト編集ウィジェットのプレースホルダーテキストに使用される色。

このプロパティが設定されていない場合、デフォルト値はパレットの「PlaceholderText 」ロールに設定されている色になります。

例：

QLineEdit { placeholder-text-color: #800000ff } /* semi-transparent blue */

バージョン6.5以降で利用可能です。

position

left、right、top、bottomを使用して指定されたオフセットが、相対座標か絶対座標か。

このプロパティが指定されていない場合、デフォルト値はrelative となります。

right

positionが relative （デフォルト）の場合、サブコントロールを指定されたオフセット分だけ左に移動します。 right: x は、 left: -xを指定することと同等になります。

positionがabsolute の場合、right プロパティは、親コンボックスの右端を基準としたサブコントロールの右端の位置を指定します（subcontrol-origin も参照してください）。

例：

QSpinBox::down-button { right: 2px }

「left」、「top」、「bottom」も参照してください。

selection-background-color*

選択されたテキストや項目の背景色。

このプロパティは、QWidget::palette に準拠し、選択テキストを表示するすべてのウィジェットでサポートされています。

このプロパティが設定されていない場合、デフォルト値はパレットの「Highlight 」ロールに設定されている値となります。

例：

QTextEdit { selection-background-color: darkblue }

「selection-color」および「background」も参照してください。

selection-color*

選択されたテキストまたは項目の前景色。

このプロパティは、QWidget::palette に従い、かつ選択テキストを表示するすべてのウィジェットでサポートされています。

このプロパティが設定されていない場合、デフォルト値はパレットのHighlightedText ロールに設定されている値となります。

例：

QTextEdit { selection-color: white }

関連項目：selection-background-colorおよびcolor。

show-decoration-selected*

QListView 内の選択範囲が、行全体を覆うか、それともテキストの範囲のみを覆うかを制御します。

このプロパティが指定されていない場合、SH_ItemView_ShowDecorationSelected のスタイルヒントに対して現在のスタイルで指定されている値がデフォルトとして適用されます。

例：

* { show-decoration-selected: 1 }

spacing*

ウィジェット内の間隔。

このプロパティは、QCheckBox 、checkableQGroupBoxes、QMenuBar 、およびQRadioButton でサポートされています。

このプロパティが指定されていない場合、デフォルト値はウィジェットおよび現在のスタイルによって異なります。

例：

QMenuBar { spacing: 10 }

「padding」および「margin」も参照してください。

subcontrol-origin*

親要素内におけるサブコントロールの原点矩形。

このプロパティが指定されていない場合、デフォルト値は `padding` です。

例：

QSpinBox::up-button {
    image: url(:/images/spinup.png);
    subcontrol-origin: content;
    subcontrol-position: right top;
}

「subcontrol-position」も参照してください。

subcontrol-position*

subcontrol-origin で指定された原点矩形内におけるサブコントロールの配置。

このプロパティが指定されていない場合、サブコントロールに応じて決定される値がデフォルトとして設定されます。

例：

QSpinBox::down-button {
    image: url(:/images/spindown.png);
    subcontrol-origin: padding;
    subcontrol-position: right bottom;
}

「subcontrol-origin」も参照してください。

titlebar-show-tooltips-on-buttons

ウィンドウのタイトルバーのボタンにツールチップを表示するかどうか。

widget-animation-duration*

アニメーションの継続時間（ミリ秒単位）。値が 0 の場合、アニメーションは無効になります。

このプロパティが指定されていない場合、デフォルトでは、SH_Widget_Animation_Duration スタイルヒントに対して現在のスタイルで指定された値が適用されます。

Qt 5.10 以降で利用可能です。

例:

* { widget-animation-duration: 100 }

text-align

ウィジェット内のコンテンツにおけるテキストとアイコンの配置。

この値が指定されていない場合、デフォルトではネイティブのスタイルに基づく値が適用されます。

例：

QPushButton {
    text-align: left;
}

このプロパティは現在、QPushButton およびQProgressBar でのみサポートされています。

text-decoration

その他のテキスト効果。

トップ

positionが relative （デフォルト）の場合、サブコントロールを指定されたオフセット分だけ下方向に移動します。

positionが absolute の場合、top プロパティは、親コントロールの上端に対するサブコントロールの上端の位置を指定します（subcontrol-originも参照してください）。

このプロパティが指定されていない場合、デフォルトは0 となります。

例：

QSpinBox::up-button { top: 2px }

「left」、「right」、「bottom」も参照してください。

width

サブコントロール（場合によってはウィジェット）の幅。

このプロパティが指定されていない場合、サブコントロール／ウィジェットおよび現在のスタイルに応じて、デフォルトの値が設定されます。

例：

QSpinBox::up-button { width: 12px }

「height」も参照してください。

word-spacing

ウィジェット内の文字列における、各単語間のスペース。

-qt-background-role

選択されたロールに基づいて、サブコントロールまたはウィジェットのbackground-color を指定します。

-qt-style-features

Qt固有のスタイルを適用したいCSSプロパティのリスト。

アイコンの一覧

Qtで使用されるアイコンは、以下のプロパティを使用してカスタマイズできます。このセクションに記載されている各プロパティの型は「Icon」です。

なお、QDialogButtonBox 内のボタンにアイコンを表示させるには、dialogbuttonbox-buttons-have-iconsプロパティをtrueに設定する必要があります。また、アイコンのサイズをカスタマイズするには、icon-sizeプロパティを使用してください。

プロパティタイプのリスト

以下の表は、さまざまなプロパティ型の構文と意味をまとめたものです。

QTextEdit { background-position: bottom center }

QDialog { etch-disabled-text: 1 }

/* red red red red */
QLabel { border-color: red }
/* red blue red blue */
QLabel { border-color: red blue }
/* red blue green blue */
QLabel { border-color: red blue green }
/* red blue green yellow */
QLabel { border-color: red blue green yellow }

/* 1px 1px 1px 1px */
QLabel { border-width: 1px }
/* 1px 2px 1px 2px */
QLabel { border-width: 1px 2px }
/* 1px 2px 3px 2px */
QLabel { border-width: 1px 2px 3px }
/* 1px 2px 3px 4px */
QLabel { border-width: 1px 2px 3px 4px }

/* opaque red */
QLabel { border-color: red }
/* opaque red */
QLabel { border-color: #FF0000 }
/* 75% opaque red */
QLabel { border-color: rgba(255, 0, 0, 75%) }
/* opaque red */
QLabel { border-color: rgb(255, 0, 0) }
/* opaque red */
QLabel { border-color: rgb(100%, 0%, 0%) }
/* opaque yellow */
QLabel { border-color: hsv(60, 100%, 100%) }
/* 75% blue */
QLabel { border-color: hsva(240, 255, 255, 75%) }
/* opaque yellow */
QLabel { border-color: hsl(60, 100%, 50%) }
/* 75% blue */
QLabel { border-color: hsla(240, 255, 50%, 75%) }

/* linear gradient from white to green */
QTextEdit {
    background: qlineargradient(x1:0, y1:0, x2:1, y2:1,
                stop:0 white, stop: 0.4 gray, stop:1 green)
}

/* linear gradient from white to green */
QTextEdit {
    background: qlineargradient(x1:0, y1:0, x2:1, y2:1,
                stop:0 white, stop: 0.4 rgba(10, 20, 30, 40),
                stop:1 rgb(0, 200, 230, 200))
}

/* conical gradient from white to green */
QTextEdit {
    background: qconicalgradient(cx:0.5, cy:0.5, angle:30,
                stop:0 white, stop:1 #00FF00)
}

/* radial gradient from white to green */
QTextEdit {
    background: qradialgradient(cx:0, cy:0, radius: 1,
                fx:0.5, fy:0.5, stop:0 white, stop:1 green)
}

* {
    file-icon: url(file.png),
               url(file_selected.png) selected;
  }

QMessageBox {
    dialogbuttonbox-buttons-have-icons: true;
    dialog-ok-icon: url(ok.svg);
    dialog-cancel-icon: url(cancel.png),
                        url(grayed_cancel.png) disabled;
}

QPushButton { color: palette(dark); }

疑似状態の一覧

以下の疑似状態がサポートされています：

サブコントロールのリスト

以下のサブコントロールが利用可能です：

サブコントロールのカスタマイズ方法の例については、「QPushButtonのメニューインジケータ・サブコントロールのカスタマイズ」を参照してください。