Qt4.7文档翻译：Qt样式单参考,Qt Style Sheets Reference

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

属性类型来进行赋值。除非另外有说明，否则以下的属性对所有部件都有用。带有星号*的属性是Qt 特有的，在CSS2 或CSS3 中没有等价属性。

| 属性 | 类型 | 说明 | | alternate-background-color | Brush | 在 QAbstractItemView子类中使用的交替背景色。如果这個属性没有设置的话，那么默认值就是为调色板（palette）的AlternateBase角色（role）设置的值。示例：QTreeView {alternate-background-color: blue;background: yellow;}参考 background和 selection-background-color。 | | background | Background | 用来设置背景的省写（Shorthand）方式。等价于设置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 | Brush | 为这個部件使用的背景颜色。示例：QLabel { background-color: yellow }QLineEdit { background-color: rgb(255, 0, 0) } | | background-image | Url | 为这個部件使用的背景图片。图片的半透明部分会露出背景颜色（background-color）。示例：QFrame { background-image: url(:/../img/hydro.png) } | | background-repeat | Repeat | 在填充background-origin矩形的过程中，背景图片是否要重要，以及如何重复。如果没有设置的话，则背景图片在两个方向上都重复（repeat）。示例：QFrame {background: white url(:/../img/ring.png);background-repeat: repeat-y;background-position: left;} | | background-position | Alignment | 背景图片在background-origin矩形中的对齐方式。没有设置的话，则对齐方式是top left（左上）。Example:QFrame {background: url(:/../img/footer.png);background-position: bottom left;} | | background-attachment | Attachment | 确定在一個 QAbstractScrollArea中的背景图片是否会随视口（viewport）滚动。默认情况下，背景图片会随视口滚动。示例：QTextEdit {background-image: url(“leaves.png”);background-attachment: fixed;}参考 background。 | | background-clip | Origin | 在部件的矩形区域中绘制背景（background）的区域。这個属性指定的是background-color和background-image在其中被修剪（clipped）的矩形区域。这個属性被 QAbstractItemView子类、 QAbstractSpinBox子类、 QCheckBox、 QComboBox、 QDialog、 QFrame、 QGroupBox、 QLabel、 QPushButton、 QRadioButton、 QSplitter、 QTextEdit、 QToolTip和普通的 QWidget支持。如果这個属性没有设置的话，则默认值是border。示例：QFrame {background-image: url(:/../img/header.png);background-position: top left;background-origin: content;background-clip: padding;}参考 background、 background-origin和盒状模型（The Box Model）。 | | background-origin | Origin | 部件的背景矩形区域，与background-position和background-image结合使用。这個属性被 QAbstractItemView子类、 QAbstractSpinBox子类、 QCheckBox、 QComboBox、 QDialog、 QFrame、 QGroupBox、 QLabel、 QPushButton、 QRadioButton、 QSplitter、 QTextEdit、 QToolTip和普通的 QWidget支持。如果这個属性没有设置的话，则默认值是padding。示例：QFrame {background-image: url(:/../img/header.png);background-position: top left;background-origin: content;}参考 background和盒状模型。 | | border | 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 | 用来设置部件的顶部边框的省写方式。等价于设置border-top-color、border-top-style和／或border-top-width。 | | border-right | Border | 用来设置部件的右侧边框的省写方式。等价于设置border-right-color、border-right-style和／或border-right-width。 | | border-bottom | Border | 用来设置部件的底部边框的省写方式。等价于设置border-bottom-color、border-bottom-style和／或border-bottom-width。 | | border-left | Border | 用来设置部件的左侧边框的省写方式。等价于设置border-left-color、border-left-style和／或border-left-width。 | | border-color | Box Colors | 边框的所有边的颜色。等价于指定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 | Brush | 边框的顶部边线的颜色。 | | border-right-color | Brush | 边框的右侧边线的颜色。 | | border-bottom-color | Brush | 边框的底部边线的颜色。 | | border-left-color | Brush | 边框的左侧边线的颜色。 | | border-image | Border Image | 用来填充边框的图片。图片被切成9块，并且在必要的时候还会被拉伸（stretched）。参考 Border Image以了解细节。这個属性被 QAbstractItemView子类、 QAbstractSpinBox子类、 QCheckBox、 QComboBox、 QFrame、 QGroupBox、 QLabel、 QLineEdit、 QMenu、 QMenuBar、 QPushButton、 QRadioButton、 QSplitter、 QTextEdit和 QToolTip支持。参考 border-color、 border-style、 border-width和盒状模型。 | | border-radius | Radius | 边框的边角的半径。等价于指定border-top-left-radius、border-top-right-radius、border-bottom-right-radius和border-bottom-left-radius。边框半径（border-radius）会修剪（clips）这個元素的背景（ background）。这個属性被 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 | Radius | 边框的左上角的半径。 | | border-top-right-radius | Radius | 边框的右上角的半径。 | | border-bottom-right-radius | Radius | 边框的右下角的半径。将这個属性设置成正数的值就会产生圆角。 | | border-bottom-left-radius | Radius | 边框的左下角的半径。将这個属性设置成正数的值就会产生圆角。 | | border-style | 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 Style | 边框的顶部边线的风格。 | | border-right-style | Border Style | 边框的右侧边线的风格。 | | border-bottom-style | Border Style | 边框的底部边线的风格。 | | border-left-style | Border Style | 边框的左侧边线的风格。 | | border-width | Box Lengths | 边框的宽度。等价于设置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 | Length | 边框的顶部边线的宽度。 | | border-right-width | Length | 边框的右侧边线的宽度。 | | border-bottom-width | Length | 边框的底部边线的宽度。 | | border-left-width | Length | 边框的左侧边线的宽度。 | | bottom | Length | 如果 position（位置）是relative（相对的）（默认值），则将一个子控件（ subcontrol）向上移动一定的位置；在那种情况下，指定bottom: y等价于指定 top : - y。如果 position是absolute（绝对的），则bottom属性指定的是这个子控件的底部边线相对于亲代（parent）部件的底部边线的位置（参考 subcontrol-origin）。示例：QSpinBox::down-button { bottom: 2px }参考 left、 right和 top。 | | button-layout | Number | 在一個 QDialogButtonBox或 QMessageBox中的按钮的布局。可选值是0 (WinLayout)、1 (MacLayout)、2 (KdeLayout)和3 (GnomeLayout)。如果这個属性没有指定的话，则默认值是由当前风格中的SH_DialogButtonLayout风格提示来确定的。示例： { button-layout: 2 } | | color | Brush | 用来渲染文字的颜色。所有支持（respect）QWidget::palette的部件都支持这個属性。如果这個属性没有设置的话，则默认值是为这個部件的调色板设置的QWidget::foregroundRole 的值（通常是黑色）。示例：QPushButton { color: red }参考 background和 selection-color。 | | dialogbuttonbox-buttons-have-icons | Boolean | QDialogButtonBox中的按钮是否要显示图标。如果这個属性设置为1，则 QDialogButtonBox中的按钮显示图标；如果设置为0，则不显示图标。参考List of Icons （图标列表）小节以了解如何设置图标。QDialogButtonBox { dialogbuttonbox-buttons-have-icons: 1; }注意：定义咯这個属性的样式必须在 QDialogButtonBox被创建之前就应用；也就是说妳必须将样式应用到它的亲代部件或者直接应用到程序本身。 | | font | Font | 用来设置文字的字体的省写方式。等价于设置font-family、font-size、font-style和／或font-weight。所有支持QWidget::font的部件都支持这個属性。如果没有设置，则默认值是QWidget::font。示例：QCheckBox { font: bold italic large “Times New Roman” } | | font-family | String | 字体族（family）。示例：QCheckBox { font-family: “New Century Schoolbook” } | | font-size | Font Size | 字体大小。在这個版本的Qt 中，只支持pt 和px 单位。示例：QTextEdit { font-size: 12px } | | font-style | Font Style | 字体风格。示例：QTextEdit { font-style: italic } | | font-weight | Font Weight | 字体的重量（weight）。 | | gridline-color | Color | 在 QTableView中的网格线的颜色。如果没有设置的话，则默认值是当前风格中为SH_Table_GridLineColor样式提示指定的值。示例：* { gridline-color: gray } | | height | Length | 一個子控件（ subcontrol）（在某些情况下，是部件）的高度。如果这個属性没有设置，则默认值取决于子控件／部件本身及当前的风格。警告：除非另有说明，否则这个属性对部件无效。如果妳想要某個部件拥有固定的高度，则将 min-height和 max-height设置成同一個值。示例：QSpinBox::down-button { height: 10px }参考 width。 | | icon-size | Length | 某個部件中的图标的宽度和高度。以下部件的图标尺寸可使用这個属性来设置。

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

| | image | Url+ | 被绘制到一個子控件（ subcontrol）的内容区域的图片。image（图片）属性接受一组 Url（统一资源定位器）或一個svg（可缩放矢量图）。实际绘制的图片是由与 QIcon相同的算法来确定的，（也就是说）图片绝不会被放大但必要的时候一定会缩小。如果指定咯一個svg，则图片会缩放到内容区域的大小。在子控件上设置图片会隐式地设置那個子控件的宽度和高度（除非图片是一個SVG）。在Qt 4.3 和以后的版本中，可使用 image-position来指定图片在矩形区域中的对齐方式。这個属性是只为子控件（ subcontrol）设计的—我们不在其它元素中支持它。警告：需要有QIcon SVG 插件才能渲染SVG 图片。示例：/ 隐式地将down-button 的大小设置成spindown.png 的大小 /QSpinBox::down-button { image: url(:/../img/spindown.png) } | | image-position | alignme nt | 在Qt 4.3 及以后的版本中，图片的位置可使用相对定位和绝对定位来设置。 | | left | Length | 如果 position（位置）是relative（相对的）（默认值），则将某個 subcontrol（子控件）向右移动一定距离。如果 position是absolute（绝对的），则left属性指定的是这個子控件的左边线与亲代部件的左边线的相对位置（参考 subcontrol-origin）。如果没有设置，则默认值是0。示例：QSpinBox::down-button { left: 2px }参考 right、 top和 bottom。 | | lineedit-password-character | Number | 以Unicode（统一码）指定的 QLineEdit密码字符。如果这個属性没有设置，则默认值是由当前风格中的SH_LineEdit_PasswordCharacter样式提示确定的。示例： { lineedit-password-character: 9679 } | | margin | Box Lengths | 部件的边距（margins）。等价于指定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 | Length | 部件的顶部边距。 | | margin-right | Length | 部件的右侧边距。 | | margin-bottom | Length | 部件的底部边距。 | | margin-left | Length | 部件的左侧边距。 | | max-height | Length | 这個部件或者其子控件的最大高度。这個属性被 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 | Length | 这個部件或者其子控件的最大宽度。这個属性被 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 | Number | 在消息框中的文字的交互行为。可能取的值取决于Qt::TextInteractionFlags。如果属性没有设置的话，则默认值是由当前风格中的SH_MessageBox_TextInteractionFlags样式提示确定的。示例：QMessageBox { messagebox-text-interaction-flags: 5 } | | min-height | Length | 这個部件或者其子控件的最小高度。这個属性被 QAbstractItemView子类、 QAbstractSpinBox子类、 QCheckBox、 QComboBox、 QFrame、 QGroupBox、 QLabel、 QLineEdit、 QMenu、 QMenuBar、 QPushButton、 QRadioButton、 QSizeGrip、 QSpinBox、 QSplitter、 QStatusBar、 QTextEdit和 QToolTip支持。如果这個属性没有指定的话，则最小高度是基于这個部件的内容和样式来继承的。这個值是相对于盒状模型中的内容区域的。示例：QComboBox { min-height: 24px }参考 min-width。 | | min-width | Length | 这個部件或者其子控件的最小宽度。这個属性被 QAbstractItemView子类、 QAbstractSpinBox子类、 QCheckBox、 QComboBox、 QFrame、 QGroupBox、 QLabel、Q LineEdit、 QMenu、 QMenuBar、 QPushButton、 QRadioButton、 QSizeGrip、 QSpinBox、 QSplitter、 QStatusBar、 QTextEdit和 QToolTip支持。如果这個属性没有指定的话，则最小宽度是基于这個部件的内容和样式来继承的。这個值是相对于盒状模型中的内容区域的。示例：QComboBox { min-width: 72px }参考 min-height。 | | opacity | Number | 某個部件的透明度。取值范围从0 (透明)到255 (不透明)。当前只被工具提示（ tooltips）支持。如果这個属性没有设置，则默认值由当前风格中的SH_ToolTipLabel_Opacity样式提示确定。示例：QToolTip { opacity: 223 } | | padding | Box Lengths | 这個部件的填充宽度（padding）。等价于设置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 | Length | 这個部件的顶部填充距离。 | | padding-right | Length | 这個部件的右侧填充距离。 | | padding-bottom | Length | 这個部件的底部填充距离。 | | padding-left | Length | 这個部件的左侧填充距离。 | | paint-alternating-row-colors-for-empty-area | bool | QTreeView是否要为空白区域（没有条目的区域）绘制交替行颜色 | | position | relative | absolute | 用 left、 right、 top和 bottom指定的偏移值是相对的还是绝对的坐标。如果没有设置，则默认值是relative。 | | right | Length | 如果 position（位置）是relative（相对的）（默认值），则将某個 subcontrol（子控件）向左移动一定距离；在那种情况下，指定right: x就等价于指定 left : - x。如果 position是absolute（绝对的），则right属性指定的是这個子控件的右边线相对于亲代部件的右边线的位置（参考 subcontrol-origin）。示例：QSpinBox::down-button { right: 2px }参考 left、 top和 bottom。 | | selection-background-color | Brush | 选中的文字或条目的背景。所有支持QWidget::palette并且显示选中文字的部件都支持这個属性。如果没有设置，则默认值是为调色板的Highlight角色设置的值。示例：QTextEdit { selection-background-color: darkblue }参考 selection-color和 background。 | | selection-color | Brush | 选中的文字或条目的前景。所有支持QWidget::palette并且显示选中文字的部件都支持这個属性。如果没有设置，则默认值是为调色板的HighlightedText角色设置的值。示例：QTextEdit { selection-color: white }参考 selection-background-color和 color。 | | show-decoration-selected | Boolean | 控制的是在一個 QListView中的选中区域是要覆盖整个行还是只覆盖文字的区域。如果没有设置，则默认值是由当前风格中的SH_ItemView_ShowDecorationSelected样式提示确定的。示例： { show-decoration-selected: 1 } | | spacing | Length | 这個部件内部的间隔（spacing）。这個属性被 QCheckBox、可选中的 QGroupBox、 QMenuBar和 QRadioButton支持。如果没有指定，则默认值取决于部件本身及当前风格。示例：QMenuBar { spacing: 10 }参考 padding和 margin。 | | subcontrol-origin | Origin | 这個 subcontrol（子控件）在亲代元素中的根源（origin）矩形。如果没有指定，则默认值为padding。示例：QSpinBox::up-button {image: url(:/../img/spinup.png);subcontrol-origin: content;subcontrol-position: right top;}参考 subcontrol-position。 | | subcontrol-position | Alignment | 这個子控件（ subcontrol）在由 subcontrol-origin确定的根源矩形中的对齐方式。如果没有设置的话，则默认值取决于子控件本身。示例：QSpinBox::down-button {image: url(:/../img/spindown.png);subcontrol-origin: padding;subcontrol-position: right bottom;}参考 subcontrol-origin。 | | text-align | Alignment | 文字和图标在这個部件的内容中的对齐方式。如果没有设置的话，则默认值取决于原生（native）风格。示例：QPushButton {text-align: left;}当前只有 QPushButton和 QProgressBar支持这個属性。 | | text-decoration | none underline overline line-through | 附加的文字效果 | | top | Length | 如果 position是relative（相对的）（默认值），则将一個 subcontrol（子控件）向下移动指定距离。如果 position是absolute（绝对的），则top属性指定的是这個子控件的顶部边线相对于亲代部件的顶部边线的位置（参考 subcontrol-origin）。如果没有设置的话，则默认值是0。示例：QSpinBox::up-button { top: 2px }参考 left、 right和 bottom。 | | width | Length | 一個 subcontrol（子控件）（或者在某些情况下会是部件）的宽度。如果没有设置的话，则默认值取决于子控件／部件本身及当前的风格。警告：除非另外说明，否则这個属性对于部件无效。如果妳想让某個部件具有固定的宽度，则将 min-width和 max-width设置成相同的值。示例：QSpinBox::up-button { width: 12px }参考 height。 |

Icon 。

注意，要想让 QDialogButtonBox 中的按钮里出现图标的话，妳需要将dialogbuttonbox-buttons-have-icons 属性设置成true（真）。并且，要对图标的尺寸进行自定义的话，则使用icon-size 属性。

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Qt4.7文档翻译：Qt样式单参考,Qt Style Sheets Reference

项目列表

Qt4.7文档翻译：Qt样式单参考,Qt Style Sheets Reference