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

Qt スタイルシートは、ウィジェットの外観をカスタマイズするための様々なプロパティ、擬似状態、サブコントロールをサポートしています。

スタイル設定可能なウィジェット一覧

次の表は、スタイルシートを使ってカスタマイズできるQtウィジェットの一覧です：

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*。
• メッセージボックス・テキスト・インタラクション・フラグ
• 不透明度
• プレースホルダテキスト色* - 選択範囲の背景色
• 選択範囲の背景色* 選択範囲の背景色* 選択範囲の背景色* 選択範囲の背景色* 選択範囲の背景色* 選択範囲の背景色
• 選択部分の色
• 選択部分の装飾
• 間隔
• サブコントロール原点
• サブコントロールの位置
• ウィジェットのアニメーション時間

アクセントカラー

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

代替背景色

QAbstractItemView サブクラスで使われるalternate background color 。

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

例

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

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

背景

背景を設定するための省略記法。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も参照。

背景色

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

例

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

背景画像

ウィジェットに使用される背景画像。画像の半透明部分はbackground-color 。

例

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

背景繰り返し

background-origin の矩形を埋めるために背景画像を繰り返すかどうか、またどのように繰り返すか。

このプロパティが指定されていない場合、背景画像は両方向に繰り返される (repeat)。

例

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

背景位置

background-origin 長方形内の背景画像の配置。

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

例

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

背景アタッチメント

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

例

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

背景

背景クリップ

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およびThe Box Model も参照してください。

背景-オリジン

ウィジェットの背景の矩形。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およびThe Box Model も参照のこと。

ボーダー

ウィジェットのボーダーを設定するための省略記法。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-color,border-top-style, および/またはborder-top-width を指定するのと同等です。

ボーダーライト

ウィジェットの右ボーダーを設定するための省略記法。border-right-color,border-right-style, および/またはborder-right-width を指定するのと同等。

ボーダーボトム

ウィジェットのボトムボーダーを設定するための省略記法。border-bottom-color,border-bottom-style, および/またはborder-bottom-width を指定するのと同等。

ボーダー左

ウィジェットの左ボーダーを設定するための省略記法。border-left-color,border-left-style, および/またはborder-left-width を指定するのと同等。

ボーダーカラー

ボーダーのすべての辺の色。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,The Box Modelも参照してください。

ボーダートップ色

ボーダーの上端の色。

ボーダー右端色

ボーダーの右端の色。

ボーダー下端色

ボーダーの下端の色。

ボーダー左端色

ボーダーの左端の色。

ボーダーイメージ

ボーダーを塗りつぶす画像。画像は9つの部分に分割され、必要に応じて適切に引き伸ばされます。詳しくはボーダー画像をご覧ください。

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

border-color,border-style,border-width、ボックス・モデルも参照のこと。

ボーダー半径

ボーダーの角の半径。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およびThe Box Model も参照のこと。

ボーダートップ左半径

ボーダーの左上隅の半径。

ボーダー右上半径

ボーダーの右上隅の半径。

ボーダー右下半径

ボーダーの右下隅の半径。このプロパティに正の値を設定すると、角が丸くなります。

ボーダー左下半径

ボーダーの左下角の半径。このプロパティに正の値を設定すると、角が丸くなります。

ボーダースタイル

ボーダーのすべてのエッジのスタイル。

このプロパティは、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,The Box Modelも参照してください。

ボーダートップスタイル

ボーダーの上端のスタイル。

ボーダー右端スタイル

ボーダーの右端のスタイル。

ボーダーボトムスタイル

ボーダーの下端のスタイル。

ボーダー左端スタイル

ボーダーの左端のスタイル。

ボーダー幅

枠線の幅。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,The Box Modelも参照。

ボーダートップ幅

ボーダーの上辺の幅。

ボーダー右幅

ボーダーの右端の幅。

ボーダー下幅

ボーダーの下辺の幅。

ボーダー左幅

ボーダーの左端の幅。

下

positionが relative （デフォルト）の場合、サブコントロールを一定のオフセットだけ上に移動させる。 bottom: yを指定することは top: -y.

positionがabsolute の場合、bottom プロパティは、親のボトムエッジに対するサブコントロールのボトムエッジを指定します（subcontrol-origin も参照）。

例

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

left、right、topも参照。

ボタンレイアウト

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

このプロパティが指定されない場合、SH_DialogButtonLayout スタイル・ヒントの現在のスタイルで指定された値がデフォルトとなります。

例

* { button-layout: 2 }

色

テキストのレンダリングに使用する色。

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

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

例

QPushButton { color: red }

backgroundと selection-colorも参照してください。

ダイアログボタンボックスボタンにアイコンを持つ

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

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

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

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

フォント

テキストのフォントを設定するための省略記法。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" }

フォントサイズ

フォントサイズ。このバージョンの Qt では、pt と px メトリクスのみがサポートされています。

例

QTextEdit { font-size: 12px }

フォントスタイル

フォントのスタイル。

例

QTextEdit { font-style: italic }

フォントウェイト

フォントの太さ。

グリッドラインカラー

QTableView におけるグリッド線の色。

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

例

* { gridline-color: gray }

高さ

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

このプロパティが指定されていない場合、サブコントロール/ウィジェットと現在のスタイルに依存する値がデフォルトとなる。

例

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

width も参照してください。

アイコン

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

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

5.15から利用可能です。

アイコンサイズ

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

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

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

image*

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

image プロパティには、Urlのリストまたはsvg を指定できます。実際に描画される画像は、QIcon と同じアルゴリズムで決定されます（つまり、画像は決して拡大されませんが、必要に応じて常に縮小されます）。svg が指定された場合、画像はコンテンツの矩形のサイズに拡大縮小されます。

サブコントロールに image プロパティを設定すると、サブコントロールの幅と高さが暗黙的に設定される（画像が SVG の場合を除く）。

Qt 4.3 以降では、矩形内の画像の配置はimage-position で指定できます。

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

例

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

画像位置

Qt 4.3以降では、画像イメージの位置のアライメントは、相対位置または絶対位置で指定できます。

左

positionがrelative (デフォルト) の場合、サブコントロールを一定のオフセットだけ右に移動する。

positionがabsolute の場合、left プロパティは、親の左端に対するサブコントロールの左端を指定します（subcontrol-origin も参照）。

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

例

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

right、top、bottomも参照。

lineedit-パスワード文字*。

QLineEdit パスワード文字を Unicode 数値で指定する。

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

例

* { lineedit-password-character: 9679 }

lineedit-password-mask-delay*。

lineedit-password-characterが可視文字に適用されるまでの、QLineEdit パスワードマスクの遅延時間(ミリ秒単位)。

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

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

例

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

マージン

ウィジェットのマージン。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,The Box Modelも参照してください。

マージントップ

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

マージン右

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

マージンボトム

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

マージンレフト

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

最大高さ

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

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

この値は、ボックスモデル内のコンテンツ矩形に対する相対値である。

例

QSpinBox { max-height: 24px }

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 も参照してください。

メッセージボックステキストインタラクションフラグ*。

メッセージボックスのテキストのインタラクション動作。指定可能な値はQt::TextInteractionFlags による。

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

例

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

ミニハイト

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

このプロパティは、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も参照してください。

最小幅

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

このプロパティは、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 }

アウトライン

オブジェクトの境界の周囲に描かれるアウトライン。

輪郭色

輪郭の色。border-colorも参照のこと。

アウトラインオフセット

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

アウトラインスタイル

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

アウトライン半径

アウトラインに角丸を追加します。

アウトライン下左半径

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

アウトライン右下半径

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

アウトライン左上半径

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

アウトライン右上半径

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

パディング

ウィジェットのパディング。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、The Box Modelも参照してください。

パディングトップ

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

パディング右

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

パディング・ボトム

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

パディング左

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

空領域のためのペイント代替行色

QTreeView 、空の領域（すなわち、アイテムがない領域）に対して行の色を交互に塗るかどうか。

プレースホルダ・テキストカラー

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

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

例

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

6.5 以降で使用可能。

ポジション

left、right、top、bottomで指定したオフセットが相対座標か絶対座標か。

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

右

positionが relative （デフォルト）の場合、サブコントロールをあるオフセットだけ左に移動する。 right: xを指定することは left: -x.

positionがabsolute の場合、right プロパティは、親の右端に対するサブコントロールの右端を指定します（subcontrol-origin も参照）。

例

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

left、top、bottomも参照。

選択背景色*。

選択されたテキストやアイテムの背景。

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

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

例

QTextEdit { selection-background-color: darkblue }

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

選択色*。

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

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

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

例

QTextEdit { selection-color: white }

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

選択された装飾

QListView 、選択範囲が行全体をカバーするか、テキストの範囲だけをカバーするかを制御する。

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

例

* { show-decoration-selected: 1 }

spacing*

ウィジェットの内部スペーシング。

このプロパティは、QCheckBox 、checkableQGroupBoxes、QMenuBar 、QRadioButton でサポートされている。

このプロパティが指定されていない場合、デフォルト値はウィジェットと現在のスタイルに依存します。

例

QMenuBar { spacing: 10 }

paddingと marginも参照。

サブコントロールオリジン

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

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

例

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

subcontrol-positionも参照のこと。

サブコントロールポジション

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

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

例

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

subcontrol-originも参照。

タイトルバー-ボタンにツールチップを表示する

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

ウィジェットのアニメーション時間

アニメーションの持続時間（ミリ秒）。ゼロに等しい値は、アニメーションが無効になることを意味する。

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

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

例

* { widget-animation-duration: 100 }

テキスト揃え

ウィジェットのコンテンツ内のテキストとアイコンの整列。

この値が指定されない場合、デフォルトはネイティブスタイルに依存する値になります。

例

QPushButton {
    text-align: left;
}

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

テキストデコレーション

追加のテキスト効果。

トップ

positionがrelative (デフォルト) の場合、サブコントロールを一定のオフセットだけ下に移動する。

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

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

例

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

left、right、bottomも参照。

幅

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

このプロパティが指定されていない場合、サブコントロール/ウィジェットと現在のスタイルに依存する値がデフォルトとなる。

例

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

heightも参照してください。

-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のメニュー・インジケータ・サブコントロールのカスタマイズを参照してください。