En esta página

Referencia de hojas de estilo de Qt

Las hojas de estilo de Qt admiten diversas propiedades, pseudoestados y subcontroles que permiten personalizar el aspecto de los widgets.

Lista de widgets personalizables

En la siguiente tabla se enumeran los Qt Widgets que se pueden personalizar mediante hojas de estilo:

WidgetCómo aplicar estilos
QAbstractScrollArea Compatible con el modelo de caja.

All derivatives of QAbstractScrollArea, including QTextEdit, and QAbstractItemView (all item view classes), support scrollable backgrounds using background-attachment. Setting the background-attachment to fixed provides a background-image that does not scroll with the viewport. Setting the background-attachment to scroll, scrolls the background-image when the scroll bars move.

Consulta «Personalización de QAbstractScrollArea » para ver un ejemplo.
QCheckBox Admite el modelo de caja. El indicador de selección se puede personalizar mediante el subcontrol ::indicator. Por defecto, el indicador se coloca en la esquina superior izquierda del rectángulo de contenido del widget.

La propiedad spacing especifica el espaciado entre el indicador de selección y el texto.

Consulte Personalización de QCheckBox para ver un ejemplo.
QColumnView El controlador se puede personalizar utilizando la propiedad «image ».

Los indicadores de flecha se pueden personalizar utilizando los subcontroles ::left-arrow y ::right-arrow.
QComboBox El marco que rodea el cuadro combinado se puede personalizar utilizando el modelo «box».

El botón desplegable se puede personalizar utilizando el subcontrol ::drop-down. Por defecto, el botón desplegable se coloca en la esquina superior derecha del rectángulo de relleno del widget.

El símbolo de flecha dentro del botón desplegable se puede personalizar mediante el subcontrol ::down-arrow. Por defecto, la flecha se sitúa en el centro del rectángulo de contenido del subcontrol desplegable.

El color del texto de marcador de posición se puede establecer mediante la propiedad placeholder-text-color.

Consulte Personalización de QComboBox para ver un ejemplo.
QDateEdit Véase QSpinBox.
QDateTimeEdit Véase QSpinBox.
QDialog Solo admite las propiedades background, background-clip y background-origin.

Advertencia: Asegúrate de definir la macro « Q_OBJECT » para tu widget personalizado.

QDialogButtonBox La disposición de los botones se puede modificar mediante la propiedad ` button-layout `.
QDockWidget Permite aplicar estilos a la barra de título y a los botones de la barra de título cuando está acoplado.

Se puede aplicar un estilo al borde del widget acoplado mediante la propiedad «border ». El subcontrol «::title» se puede utilizar para personalizar la barra de título. Los botones de cierre y de flotación se posicionan con respecto al subcontrol ::title utilizando ::close-button y ::float-button, respectivamente.

Cuando la barra de título es vertical, se establece la pseudoclase :vertical. Además, dependiendo de QDockWidget::DockWidgetFeature, se establecen los pseudoestados :closable, :floatable y :movable.

Nota: Utiliza QMainWindow::separator para aplicar estilo al controlador de redimensionamiento.

Advertencia: La hoja de estilo no tiene ningún efecto cuando la ventana « QDockWidget » está desacoplada, ya que Qt utiliza ventanas nativas de nivel superior cuando está desacoplada.

Consulta «Personalización de QDockWidget » para ver un ejemplo.

QDoubleSpinBox Véase QSpinBox.
QFrame Admite el modelo de caja.

Since 4.3, setting a stylesheet on a QLabel automatically sets the QFrame::frameStyle property to QFrame::StyledPanel.

Consulta «Personalización de QFrame » para ver un ejemplo.
QGroupBox Admite el modelo de caja.

El estilo del título se puede definir mediante el subcontrol ::title. Por defecto, el título se coloca según el valor de QGroupBox::textAlignment.

In the case of a checkable QGroupBox, the title includes the check indicator. The indicator is styled using the ::indicator subcontrol. The spacing property can be used to control the spacing between the text and indicator.

Consulta «Personalización de QGroupBox » para ver un ejemplo.
QHeaderView Admite el modelo de caja.

El estilo de las secciones de la vista de encabezado se define mediante el subcontrol ::section. El subcontrol section admite los pseudoestados :middle, :first, :last, :only-one, :next-selected, :previous-selected, :selected y :checked.

El indicador de ordenación se puede personalizar mediante los subcontroles ::up-arrow y ::down-arrow.

Consulte Personalización de QHeaderView para ver un ejemplo.
QLabel Admite el modelo de caja. No admite el pseudoestado :hover.

Since 4.3, setting a stylesheet on a QLabel automatically sets the QFrame::frameStyle property to QFrame::StyledPanel.

Consulta «Personalización de QFrame» para ver un ejemplo (un « QLabel » deriva de « QFrame »).
QLineEdit Admite el modelo de caja.

El color y el fondo del elemento seleccionado se personalizan mediante selection-color y selection-background-color, respectivamente.

El color del texto del marcador de posición se puede configurar mediante la propiedad placeholder-text-color.

El estilo de los caracteres de la contraseña se puede personalizar mediante la propiedad lineedit-password-character.

El retraso de la máscara de contraseña se puede modificar mediante la propiedad «lineedit-password-mask-delay»

Consulte «Personalización de QLineEdit» para ver un ejemplo.
QListView Admite el modelo de caja.

When alternating row colors is enabled, the alternating colors can be styled using the alternate-background-color property.

El color y el fondo del elemento seleccionado se definen mediante las propiedades «selection-color» y «selection-background-color», respectivamente.

El comportamiento de la selección se controla mediante la propiedad «show-decoration-selected ».

Utiliza el subcontrol ::item para un control más preciso sobre los elementos de la vista de lista ( QListView).

Consulta QAbstractScrollArea para aplicar estilos a los fondos desplazables.

Consulta Personalización de QListView para ver un ejemplo.
QListWidget Véase QListView.
QMainWindow Admite la personalización del estilo del separador.

The separator in a QMainWindow when using QDockWidget is styled using the ::separator subcontrol.

Consulta «Personalización de QMainWindow » para ver un ejemplo.
QMenu Admite el modelo de caja.

El estilo de los elementos individuales se define mediante el subcontrol ::item. Además de los pseudoestados que suelen admitirse, el subcontrol item admite los pseudoestados :selected, :default, :exclusive y los pseudoestados no exclusivos.

El indicador de los elementos de menú marcables se diseña mediante el subcontrol ::indicator.

El separador se diseña mediante el subcontrol ::separator.

En el caso de los elementos con un submenú, las flechas se diseñan mediante los subcontro les right-arrow y left-arrow.

El control de desplazamiento se diseña mediante el subcontrol ::scroller.

El elemento desprendible se diseña mediante el subcontrol ::tearoff.

Véase Personalización de QMenu para ver un ejemplo.
QMenuBar Admite el modelo de caja.

La propiedad «spacing» especifica el espaciado entre los elementos del menú. El estilo de los elementos individuales se aplica mediante el subcontrol ::item.

Advertencia: Cuando se ejecuta en Qt/Mac, la barra de menús suele integrarse en la barra de menús del sistema. En este caso, la hoja de estilos no tendrá ningún efecto.

Consulte Personalización de QMenuBar para ver un ejemplo.

QMessageBox La propiedad «messagebox-text-interaction-flags» se puede utilizar para modificar la interacción con el texto del cuadro de mensaje.
QProgressBar Admite el modelo de caja.

Se puede aplicar estilo a los segmentos de la barra de progreso mediante el subcontrol ::chunk. El segmento se muestra en el rectángulo «Contents» del widget.

Si la barra de progreso muestra texto, utiliza la propiedad «text-align» para posicionar el texto.

Las barras de progreso indeterminadas tienen establecido el pseudoestado «:indeterminate ».

Consulta «Personalización de QProgressBar » para ver un ejemplo.
QPushButton Admite el modelo de caja.

Admite los pseudoestados :default, :flat y :checked.

Desde la versión 5.15, se puede establecer la propiedad «icon» para anular el icono del botón.

For QPushButton with a menu, the menu indicator is styled using the ::menu-indicator subcontrol. Appearance of checkable push buttons can be customized using the :open and :closed pseudo-states.

Advertencia: Si solo estableces un color de fondo en un ` QPushButton`, es posible que el fondo no se vea a menos que establezcas la propiedad `border` en algún valor. Esto se debe a que, por defecto, el ` QPushButton ` dibuja un borde nativo que se superpone por completo al color de fondo. Por ejemplo,

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

Consulta «Personalización de QPushButton » para ver un ejemplo.

QRadioButton Admite el modelo de cuadro.

El indicador de selección se puede personalizar mediante el subcontrol ::indicator. Por defecto, el indicador se coloca en la esquina superior izquierda del rectángulo de contenido del widget.

La propiedad spacing especifica el espaciado entre el indicador de selección y el texto.

Consulte Personalización de QRadioButton para ver un ejemplo.
QScrollBar Admite el modelo de caja.

The Contents rectangle of the widget is considered to be the groove over which the slider moves. The extent of the QScrollBar (i.e the width or the height depending on the orientation) is set using the width or height property respectively. To determine the orientation, use the :horizontal and the :vertical pseudo states.

El control deslizante se puede personalizar mediante el subcontrol ::handle. Al establecer el ancho mínimo (min-width) o la altura mínima (min-height), se establecen restricciones de tamaño para el control deslizante en función de su orientación.

El subcontrol ::add-line se puede utilizar para personalizar el botón que permite añadir una línea. Por defecto, el subcontrol «add-line» se sitúa en la esquina superior derecha del rectángulo «Border» del widget. Dependiendo de la orientación, se muestran las flechas ::right-arrow o ::down-arrow. Por defecto, las flechas se sitúan en el centro del rectángulo «Contents» del subcontrol «add-line».

El subcontrol ::sub-line se puede utilizar para aplicar estilo al botón que permite restar una línea. Por defecto, el subcontrol ::sub-line se coloca en la esquina inferior derecha del rectángulo «Border» del widget. Dependiendo de la orientación, se muestra la flecha ::left-arrow o la flecha ::up-arrow. Por defecto, las flechas se sitúan en el centro del rectángulo «Contenido» del subcontrol «sub-line».

El subcontrol ::sub-page se puede utilizar para aplicar estilos a la región del control deslizante que resta una página. El subcontrol ::add-page se puede utilizar para aplicar estilos a la región del control deslizante que añade una página.

Véase Personalización de QScrollBar para ver un ejemplo.
QSizeGrip Admite las propiedades width, height e image.

Véase Personalización de QSizeGrip para ver un ejemplo.
QSlider Admite el modelo de caja.

Para los controles deslizantes horizontales, deben especificarse las propiedades min-width y height. Para los controles deslizantes verticales, deben especificarse las propiedades min-height y width.

El estilo de la ranura del control deslizante se define mediante el subcontrol ::groove. Por defecto, la ranura se sitúa en el rectángulo «Contents» del widget. El estilo del controlador del control deslizante se define mediante el subcontrol ::handle. Este subcontrol se desplaza dentro del rectángulo «Contents» del subcontrol «groove».

Véase Personalización de QSlider para ver un ejemplo.
QSpinBox El marco del cuadro giratorio se puede personalizar mediante el modelo de caja.

El botón «arriba» y la flecha «arriba» se pueden personalizar mediante los subcontroles ::up-button y ::up-arrow. Por defecto, el botón «arriba» se sitúa en la esquina superior derecha del rectángulo de relleno del widget. Si no se especifica un tamaño explícito, ocupa la mitad de la altura de su rectángulo de referencia. La flecha hacia arriba se sitúa en el centro del rectángulo de contenido del botón hacia arriba.

El botón hacia abajo y la flecha hacia abajo se pueden personalizar mediante los subcontroles ::down-button y ::down-arrow. Por defecto, el botón «abajo» se sitúa en la esquina inferior derecha del rectángulo de relleno del widget. Si no se especifica un tamaño explícito, ocupa la mitad de la altura de su rectángulo de referencia. La flecha «abajo» se sitúa en el centro del rectángulo de contenido del botón «abajo».

Véase Personalización de QSpinBox para ver un ejemplo.
QSplitter Admite el modelo de caja. El estilo del controlador del separador se define mediante el subcontrol ::handle.

Véase «Personalización de QSplitter» para ver un ejemplo.
QStatusBar Solo admite la propiedad «background ». El marco de los elementos individuales se puede diseñar mediante el subcontrol ::item.

Véase Personalización de QStatusBar para ver un ejemplo.
QTabBar Las pestañas individuales se pueden personalizar mediante el subcontrol ::tab. Los botones de cierre se configuran mediante el subcontrol ::close-button. Las pestañas admiten los pseudoestados :only-one, :first, :last, :middle, :previous–selected, :next-selected y :selected.

Los pseudoestados :top, :left, :right y :bottom dependen de la orientación de las pestañas.

Overlapping tabs for the selected state are created by using negative margins or using the absolute position scheme.

The tear indicator of the QTabBar is styled using the ::tear subcontrol.

QTabBar used two QToolButtons for its scrollers that can be styled using the QTabBar QToolButton selector. To specify the width of the scroll button use the ::scroller subcontrol.

The alignment of the tabs within the QTabBar is styled using the alignment property.

Advertencia: Para cambiar la posición del control « QTabBar » dentro de un « QTabWidget », utiliza el subcontrol «tab-bar» (y configura «subcontrol-position»).

Consulte Personalización de QTabBar para ver un ejemplo.

QTabWidget El estilo del marco del widget de pestañas se define mediante el subcontrol ::pane. El estilo de las esquinas izquierda y derecha se define mediante ::left-corner y ::right-corner, respectivamente. La posición de la barra de pestañas se controla mediante el subcontrol ::tab-bar.

By default, the subcontrols have positions of a QTabWidget in the windows style. To place the QTabBar in the center, set the subcontrol-position of the tab-bar subcontrol.

Los pseudoestados :top, :left, :right y :bottom dependen de la orientación de las pestañas.

Véase «Personalización de QTabWidget» para ver un ejemplo.
QTableView Admite el modelo de caja. Cuando está activada la opción « alternating row colors », los colores alternos se pueden personalizar mediante la propiedad «alternate-background-color ».

El color y el fondo del elemento seleccionado se personalizan mediante «selection-color» y «selection-background-color», respectivamente.

The corner widget in a QTableView is implemented as a QAbstractButton and can be styled using the "QTableView QTableCornerButton::section" selector.

Advertencia: Si solo estableces un color de fondo en un QTableCornerButton, es posible que el fondo no se vea a menos que establezcas la propiedad «border» en algún valor. Esto se debe a que, por defecto, el QTableCornerButton dibuja un borde nativo que se superpone por completo al color de fondo.


El color de la cuadrícula se puede especificar mediante la propiedad `gridline-color`.

Consulta QAbstractScrollArea para aplicar estilos a los fondos desplazables.

Consulta Personalización de QTableView para ver un ejemplo.

QTableWidget Consulte QTableView.
QTextEdit Admite el modelo de caja.

El color y el fondo del texto seleccionado se personalizan mediante selection-color y selection-background-color, respectivamente.

El color del texto del marcador de posición se puede establecer mediante la propiedad placeholder-text-color.

Consulte QAbstractScrollArea para personalizar fondos desplazables.
QTimeEdit Consulte QSpinBox.
QToolBar Admite el modelo de caja.

Los pseudoestados :top, :left, :right y :bottom dependen del área en la que se agrupe la barra de herramientas.

Los pseudoestados :first, :last, :middle y :only-one indican la posición de la barra de herramientas dentro de un grupo de líneas (véase QStyleOptionToolBar::positionWithinLine).

The separator of a QToolBar is styled using the ::separator subcontrol.

El controlador (para mover la barra de herramientas) se diseña utilizando el subcontrol ::handle.

Consulta «Personalización de QToolBar» para ver un ejemplo.
QToolBox Admite el modelo de caja.

Las pestañas individuales se pueden diseñar utilizando el subcontrol ::tab. Las pestañas admiten los pseudoestados :only-one, :first, :last, :middle, :previous-selected, :next-selected y :selected.
QToolButton Admite el modelo de caja.

If the QToolButton has a menu, is ::menu-indicator subcontrol can be used to style the indicator. By default, the menu-indicator is positioned at the bottom right of the Padding rectangle of the widget.

If the QToolButton is in QToolButton::MenuButtonPopup mode, the ::menu-button subcontrol is used to draw the menu button. ::menu-arrow subcontrol is used to draw the menu arrow inside the menu-button. By default, it is positioned in the center of the Contents rectangle of the menu-button subcontrol.

When the QToolButton displays arrows, the ::up-arrow, ::down-arrow, ::left-arrow and ::right-arrow subcontrols are used.

Advertencia: Si solo estableces un color de fondo (background-color) en un elemento ` QToolButton`, el fondo no se verá a menos que establezcas la propiedad `border` con algún valor. Esto se debe a que, por defecto, el elemento ` QToolButton ` dibuja un borde nativo que se superpone por completo al color de fondo. Por ejemplo,

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

Consulta «Personalización de QToolButton » para ver un ejemplo.

QToolTip Admite el modelo de caja. La propiedad «opacity» controla la opacidad de la información sobre herramientas.

Véase Personalización de QFrame para ver un ejemplo (un QToolTip es un QFrame).
QTreeView Admite el modelo de caja. Cuando alternating row colors está activado, los colores alternos se pueden personalizar mediante la propiedad alternate-background-color.

El color y el fondo del elemento seleccionado se personalizan mediante selection-color y selection-background-color, respectivamente.

El comportamiento de la selección se controla mediante la propiedad «show-decoration-selected ».

Las ramas de la vista de árbol se pueden personalizar mediante el subcontrol «::branch ». El subcontrol «::branch» admite los pseudoestados «:open», «:closed», «:has-sibling» y «:has-children ».

Utiliza el subcontrol ::item para un control más preciso sobre los elementos de la vista de árbol ( QTreeView).

Consulta QAbstractScrollArea para aplicar estilos a los fondos desplazables.

Consulta Personalización de QTreeView para ver un ejemplo de cómo aplicar estilos a las ramas.
QTreeWidget Consulte QTreeView.
QWidget Solo admite las propiedades background, background-clip y background-origin.

If you subclass from QWidget, you need to provide a paintEvent for your custom QWidget as below:
void CustomWidget::paintEvent(QPaintEvent *)
{
    QStyleOption opt;
    opt.initFrom(this);
    QPainter p(this);
    style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);
}

El código anterior no realiza ninguna operación si no hay ninguna hoja de estilos definida.

Advertencia: Asegúrate de definir la macro Q_OBJECT para tu widget personalizado.

Lista de propiedades

En esta sección se enumeran todas las propiedades compatibles con Qt Style Sheets. Los valores que se pueden asignar a una propiedad dependen del tipo de esta. A menos que se especifique lo contrario, las siguientes propiedades se aplican a todos los widgets. Las propiedades marcadas con un asterisco * son específicas de Qt y no tienen equivalente en CSS2 ni en CSS3. Las propiedades específicas de Qt son las siguientes:

color-de-resaltado

TipoPincel

Esta propiedad establece el color de acento ( Accent), que se utiliza para resaltar los elementos interactivos de la interfaz de usuario. Si no se establece esta propiedad, el valor por defecto es el color de fondo ( highlight ).

color de fondo alternativo

TipoPincel

El objeto « alternate background color » se utiliza en las subclases de « QAbstractItemView ».

Si no se establece esta propiedad, el valor por defecto es el que se haya establecido para el rol « AlternateBase » de la paleta.

Ejemplo:

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

Véase también «background » y «selection-background-color».

fondo

TipoFondo

Notación abreviada para configurar el fondo. Equivalente a especificar background-color, background-image, background-repeat y/o background-position.

Esta propiedad es compatible con las subclases de QAbstractItemView, las subclases de QAbstractSpinBox, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip y los QWidgets simples.

Ejemplo:

QTextEdit { background: yellow }

A menudo, es necesario establecer un patrón de relleno similar a los estilos que aparecen en Qt::BrushStyle. Puedes utilizar la propiedad «background-color» para Qt::SolidPattern, Qt::RadialGradientPattern, Qt::LinearGradientPattern y Qt::ConicalGradientPattern. Los demás patrones se consiguen fácilmente creando una imagen de fondo que contenga el patrón.

Ejemplo:

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

Véase también «background-origin», «selection-background-color», «background-clip», «background-attachment» y «alternate-background-color».

color de fondo

TipoPincel

El color de fondo utilizado para el widget.

Ejemplos:

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

imagen de fondo

TipoURL

La imagen de fondo utilizada para el widget. Las partes semitransparentes de la imagen permiten que se vea el « background-color ».

Ejemplo:

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

background-repeat

Indica si la imagen de fondo se repite para rellenar el rectángulo « background-origin » y de qué forma.

Si no se especifica esta propiedad, la imagen de fondo se repite en ambas direcciones (repeat).

Ejemplo:

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

background-position

La alineación de la imagen de fondo dentro del rectángulo « background-origin ».

Si no se especifica esta propiedad, la alineación es « top » left.

Ejemplo:

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

background-attachment

TipoFijación

Determina si la imagen de fondo de un elemento ` QAbstractScrollArea ` se desplaza o permanece fija con respecto a la ventana gráfica. Por defecto, la imagen de fondo se desplaza junto con la ventana gráfica.

Ejemplo:

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

Véase también «background»

background-clip

TipoOrigen

El rectángulo del widget, en el que se dibuja el « background ».

Esta propiedad especifica el rectángulo al que se recortan el « background-color » y el « background-image ».

Esta propiedad es compatible con las subclases de « QAbstractItemView », las subclases de « QAbstractSpinBox », « QCheckBox », « QComboBox », « QDialog », « QFrame », « QGroupBox », « QLabel », « QPushButton », « QRadioButton », « QSplitter », « QTextEdit », « QToolTip » y los « QWidget» simples.

Si no se especifica esta propiedad, el valor por defecto es border.

Ejemplo:

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

Véase también «background», «background-origin » y «El modelo de caja».

background-origin

TipoOrigen

El rectángulo de fondo del widget, que se utiliza junto con « background-position » y « background-image ».

Esta propiedad es compatible con las subclases de ` QAbstractItemView `, las subclases de ` QAbstractSpinBox `, ` QCheckBox`, ` QComboBox`, ` QDialog`, ` QFrame`, ` QGroupBox`, ` QLabel`, ` QPushButton`, ` QRadioButton`, ` QSplitter`, ` QTextEdit`, ` QToolTip` y los ` QWidget` simples.

Si no se especifica esta propiedad, el valor por defecto es padding.

Ejemplo:

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

Véase también «fondo » y «El modelo de caja».

border

TipoBorde

Notación abreviada para configurar el borde del widget. Equivalente a especificar « border-color », « border-style » y/o « border-width ».

Esta propiedad es compatible con las subclases de ` QAbstractItemView `, las subclases de ` QAbstractSpinBox `, ` QCheckBox`, ` QComboBox`, ` QFrame`, ` QGroupBox`, ` QLabel`, ` QLineEdit`, ` QMenu`, ` QMenuBar`, ` QPushButton`, ` QRadioButton`, ` QSplitter`, ` QTextEdit`, ` QToolTip` y los ` QWidget` simples.

Ejemplo:

QLineEdit { border: 1px solid white }

border-top

TipoBorde

Notación abreviada para establecer el borde superior del widget. Equivalente a especificar « border-top-color », « border-top-style » y/o « border-top-width ».

border-right

TipoBorde

Notación abreviada para establecer el borde derecho del widget. Equivalente a especificar « border-right-color », « border-right-style » y/o « border-right-width ».

border-bottom

TipoBorde

Notación abreviada para establecer el borde inferior del widget. Equivalente a especificar « border-bottom-color », « border-bottom-style » y/o « border-bottom-width ».

border-left

TipoBorde

Notación abreviada para configurar el borde izquierdo del widget. Equivalente a especificar « border-left-color », « border-left-style » y/o « border-left-width ».

color del borde

El color de todos los bordes. Equivale a especificar border-top-color, border-right-color, border-bottom-color y border-left-color.

Esta propiedad es compatible con las subclases de QAbstractItemView, las subclases de QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip y los QWidgets simples.

Si no se especifica esta propiedad, el valor por defecto es «color» (es decir, el color de primer plano del widget).

Ejemplo:

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

Véase también «border-style», «border-width», «border-image» y «El modelo de caja».

border-top-color

TipoPincel

El color del borde superior.

color del borde derecho

TipoPincel

El color del borde derecho.

color del borde inferior

TipoPincel

El color del borde inferior.

color del borde izquierdo

TipoPincel

El color del borde izquierdo.

border-image

La imagen utilizada para rellenar el borde. La imagen se divide en nueve partes y se estira adecuadamente si es necesario. Consulta «Imagen del borde » para obtener más detalles.

Esta propiedad es compatible con las subclases de ` QAbstractItemView `, las subclases de ` QAbstractSpinBox `, ` QCheckBox`, ` QComboBox`, ` QFrame`, ` QGroupBox`, ` QLabel`, ` QLineEdit`, ` QMenu`, ` QMenuBar`, ` QPushButton`, ` QRadioButton`, ` QSplitter`, ` QTextEdit ` y ` QToolTip`.

Véase también border-color, border-style, border-width y El modelo de caja.

border-radius

TipoRadio

El radio de las esquinas del borde. Equivale a especificar « border-top-left-radius », « border-top-right-radius », « border-bottom-right-radius » y « border-bottom-left-radius ».

El `border-radius` recorta el fondo del elemento.

Esta propiedad es compatible con las subclases de QAbstractItemView, las subclases de QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit y QToolTip.

Si no se especifica esta propiedad, el valor predeterminado es 0.

Ejemplo:

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

Véase también «border-width » y «El modelo de caja».

border-top-left-radius

TipoRadio

El radio de la esquina superior izquierda del borde.

border-top-right-radius

TipoRadio

El radio de la esquina superior derecha del borde.

border-bottom-right-radius

TipoRadio

El radio de la esquina inferior derecha del borde. Al establecer esta propiedad en un valor positivo, se obtiene una esquina redondeada.

border-bottom-left-radius

TipoRadio

El radio de la esquina inferior izquierda del borde. Al establecer esta propiedad en un valor positivo, se obtiene una esquina redondeada.

estilo del borde

El estilo de todos los bordes del borde.

Esta propiedad es compatible con las subclases de ` QAbstractItemView `, las subclases de ` QAbstractSpinBox `, ` QCheckBox`, ` QComboBox`, ` QFrame`, ` QGroupBox`, ` QLabel`, ` QLineEdit`, ` QMenu`, ` QMenuBar`, ` QPushButton`, ` QRadioButton`, ` QSplitter`, ` QTextEdit` y ` QToolTip`.

Si no se especifica esta propiedad, el valor por defecto es none.

Ejemplo:

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

Véase también border-color, border-style, border-image y El modelo de caja.

estilo del borde superior

El estilo del borde superior.

border-right-style

El estilo del borde derecho.

border-bottom-style

El estilo del borde inferior.

border-left-style

El estilo del borde izquierdo.

ancho del borde

El ancho del borde. Equivalente a establecer « border-top-width », « border-right-width », « border-bottom-width » y « border-left-width ».

Esta propiedad es compatible con las subclases de QAbstractItemView, las subclases de QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit y QToolTip.

Ejemplo:

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

Véase también border-color, border-radius, border-style, border-image y El modelo de caja.

border-top-width

TipoLongitud

El ancho del borde superior.

border-right-width

TipoLongitud

El ancho del borde derecho.

ancho-del-borde-inferior

TipoLongitud

El ancho del borde inferior.

ancho-del-borde-izquierdo

TipoLongitud

El ancho del borde izquierdo.

parte inferior

TipoLongitud

Si la posición es « relative » (valor predeterminado), desplaza un subcontrol una cierta distancia hacia arriba; especificar bottom: y equivale entonces a especificar top: -y.

Si la posición es ` absolute`, la propiedad ` bottom ` especifica el borde inferior del subcontrol en relación con el borde inferior del control padre (véase también `subcontrol-origin`).

Ejemplo:

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

Véanse también «left», «right» y «top».

diseño de botones

TipoNúmero

La disposición de los botones en un « QDialogButtonBox » o un « QMessageBox ». Los valores posibles son 0 (WinLayout), 1 (MacLayout), 2 (KdeLayout), 3 (GnomeLayout) y 5 (AndroidLayout).

Si no se especifica esta propiedad, el valor por defecto es el especificado por el estilo actual para la indicación de estilo « SH_DialogButtonLayout ».

Ejemplo:

* { button-layout: 2 }

color

TipoPincel

El color utilizado para representar el texto.

Esta propiedad es compatible con todos los widgets que respetan el QWidget::palette.

Si no se establece esta propiedad, el valor por defecto es el que esté configurado en la paleta del widget para el « QWidget::foregroundRole » (normalmente negro).

Ejemplo:

QPushButton { color: red }

Véase también «background » y «selection-color».

dialogbuttonbox-buttons-have-icons

TipoBooleano

Indica si los botones de un cuadro de diálogo « QDialogButtonBox » muestran iconos

Si esta propiedad se establece en 1, los botones de un « QDialogButtonBox » muestran iconos; si se establece en 0, los iconos no se muestran.

Consulta la sección «Lista de iconos » para obtener información sobre cómo configurar los iconos.

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

Nota: Los estilos que definen esta propiedad deben aplicarse antes de crear el « QDialogButtonBox »; esto significa que debes aplicar el estilo al widget padre o a la propia aplicación.

fuente

TipoFuente

Notación abreviada para configurar la fuente del texto. Equivale a especificar « font-family », « font-size », « font-style » y/o « font-weight ».

Esta propiedad es compatible con todos los widgets que respetan el estándar QWidget::font.

Si no se establece esta propiedad, el valor por defecto es el QWidget::font.

Ejemplo:

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

font-family

TipoCadena

La familia de fuentes.

Ejemplo:

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

tamaño de fuente

El tamaño de la fuente. En esta versión de Qt, solo se admiten las unidades de medida «pt» y «px».

Ejemplo:

QTextEdit { font-size: 12px }

estilo de fuente

El estilo de fuente.

Ejemplo:

QTextEdit { font-style: italic }

peso de la fuente

El peso de la fuente.

color de las líneas de la cuadrícula*

TipoColor

El color de la línea de la cuadrícula en un ` QTableView`.

Si no se especifica esta propiedad, se utiliza por defecto el valor especificado por el estilo actual para la sugerencia de estilo « SH_Table_GridLineColor ».

Ejemplo:

* { gridline-color: gray }

altura

TipoLongitud

La altura de un subcontrol (o, en algunos casos, de un widget).

Si no se especifica esta propiedad, su valor por defecto depende del subcontrol o widget y del estilo actual.

Advertencia: A menos que se especifique lo contrario, esta propiedad no tiene ningún efecto cuando se aplica a widgets. Si deseas que un widget tenga una altura fija, establece «min-height» y «max-height» en el mismo valor.

Ejemplo:

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

Véase también «width».

icono

TipoURL+

El icono que se utiliza en los widgets que tienen icono.

El único widget que admite actualmente esta propiedad es QPushButton.

Nota: Es responsabilidad de la aplicación asignar un icono a un botón (mediante la API de QAbstractButton ), y no del estilo. Por lo tanto, ten cuidado al configurarlo, a menos que tu hoja de estilos esté dirigida a una aplicación específica.

Disponible desde la versión 5.15.

icon-size

TipoLongitud

La anchura y la altura del icono en un widget.

El tamaño del icono de los siguientes widgets se puede configurar mediante esta propiedad.

imagen*

TipoURL+

La imagen que se dibuja en el rectángulo de contenido de un subcontrol.

La propiedad «image» admite una lista de URLo un objeto « svg ». La imagen real que se dibuja se determina utilizando el mismo algoritmo que en « QIcon » (es decir, la imagen nunca se amplía, sino que siempre se reduce si es necesario). Si se especifica un ` svg `, la imagen se escala al tamaño del rectángulo de contenido. El tamaño de un ` svg ` se puede configurar mediante las propiedades `width` y `height` (compatibles desde Qt 6.13).

Al establecer la propiedad «image» en los subcontroles, se establecen implícitamente el ancho y la altura del subcontrol (a menos que la imagen sea un SVG).

Utiliza «image-position» para alinear la imagen dentro del rectángulo.

Esta propiedad es exclusiva de los subcontroles; no es compatible con otros elementos.

Advertencia: Se necesitael complemento SVG « QIcon » para renderizar imágenes SVG.

Ejemplo:

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

image-position

La alineación de la posición de la imagen se puede especificar utilizando una posición relativa o absoluta.

izquierda

TipoLongitud

Si la posición es « relative » (valor predeterminado), desplaza un subcontrol una determinada distancia hacia la derecha.

Si la posición es « absolute », la propiedad « left » especifica el borde izquierdo del subcontrol en relación con el borde izquierdo del control padre (véase también «subcontrol-origin»).

Si no se especifica esta propiedad, el valor por defecto es « 0 ».

Ejemplo:

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

Véase también «right», «top» y «bottom».

espaciado entre letras

TipoLongitud

Espacio entre los caracteres de una cadena dentro de un widget.

lineedit-password-character*

TipoNúmero

El carácter de la contraseña « QLineEdit » como número Unicode.

Si no se especifica esta propiedad, el valor por defecto es el especificado por el estilo actual para la sugerencia de estilo « SH_LineEdit_PasswordCharacter ».

Ejemplo:

* { lineedit-password-character: 9679 }

lineedit-password-mask-delay*

TipoNúmero

El retraso de la máscara de contraseña de « QLineEdit », expresado en milisegundos, antes de que «lineedit-password-character» se aplique al carácter visible.

Si no se especifica esta propiedad, el valor por defecto es el especificado por el estilo actual para la sugerencia de estilo « SH_LineEdit_PasswordMaskDelay ».

Disponible desde Qt 5.4.

Ejemplo:

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

margen

Los márgenes del widget. Equivale a especificar margin-top, margin-right, margin-bottom y margin-left.

Esta propiedad es compatible con las subclases de QAbstractItemView, las subclases de QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit y QToolTip.

Si no se especifica esta propiedad, el valor por defecto es 0.

Ejemplo:

QLineEdit { margin: 2px }

Véase también «padding», «spacing» y «El modelo de caja».

margin-top

TipoLongitud

El margen superior del widget.

margen-derecho

TipoLongitud

El margen derecho del widget.

margin-bottom

TipoLongitud

El margen inferior del widget.

margin-left

TipoLongitud

El margen izquierdo del widget.

altura máxima

TipoLongitud

La altura máxima del widget o de un subcontrol.

Esta propiedad es compatible con las subclases de ` QAbstractItemView `, las subclases de ` QAbstractSpinBox `, ` QCheckBox`, ` QComboBox`, ` QFrame`, ` QGroupBox`, ` QLabel`, ` QLineEdit`, ` QMenu`, ` QMenuBar`, ` QPushButton`, ` QRadioButton`, ` QSizeGrip`, ` QSpinBox`, ` QSplitter`, ` QStatusBar`, ` QTextEdit` y ` QToolTip`.

El valor es relativo al rectángulo de contenido en el modelo de caja.

Ejemplo:

QSpinBox { max-height: 24px }

Véase también max-width.

max-width

TipoLongitud

El ancho máximo del widget o de un subcontrol.

Esta propiedad es compatible con las subclases de ` QAbstractItemView `, las subclases de ` QAbstractSpinBox `, ` QCheckBox`, ` QComboBox`, ` QFrame`, ` QGroupBox`, ` QLabel`, ` QLineEdit`, ` QMenu`, ` QMenuBar`, ` QPushButton`, ` QRadioButton`, ` QSizeGrip`, ` QSpinBox`, ` QSplitter`, ` QStatusBar`, ` QTextEdit` y ` QToolTip`.

El valor es relativo al rectángulo de contenido en el modelo de caja.

Ejemplo:

QComboBox { max-width: 72px }

Véase también max-height.

messagebox-text-interaction-flags*

TipoNúmero

El comportamiento de interacción del texto en un cuadro de mensaje. Los valores posibles se basan en Qt::TextInteractionFlags.

Si no se especifica esta propiedad, se establece por defecto en el valor especificado por el estilo actual para la sugerencia de estilo « SH_MessageBox_TextInteractionFlags ».

Ejemplo:

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

min-height

TipoLongitud

La altura mínima del widget o de un subcontrol.

Esta propiedad es compatible con las subclases de ` QAbstractItemView `, las subclases de ` QAbstractSpinBox `, ` QCheckBox`, ` QComboBox`, ` QFrame`, ` QGroupBox`, ` QLabel`, ` QLineEdit`, ` QMenu`, ` QMenuBar`, ` QPushButton`, ` QRadioButton`, ` QSizeGrip`, ` QSpinBox`, ` QSplitter`, ` QStatusBar`, ` QTextEdit`, ` QToolButton` y ` QToolTip`.

Si no se especifica esta propiedad, la altura mínima se calcula en función del contenido del widget y del estilo.

El valor es relativo al rectángulo de contenido en el modelo de caja.

Ejemplo:

QComboBox { min-height: 24px }

Nota: Al establecer esta propiedad, es posible que los widgets se reduzcan a un tamaño inferior al espacio necesario para el contenido.

Véase también min-width.

min-width

TipoLongitud

El ancho mínimo del widget o de un subcontrol.

Esta propiedad es compatible con las subclases de « QAbstractItemView », las subclases de « QAbstractSpinBox », « QCheckBox », « QComboBox », « QFrame », « QGroupBox », « QLabel », « QLineEdit », « QMenu », « QMenuBar », « QPushButton », « QRadioButton », « QSizeGrip », « QSpinBox », « QSplitter », « QStatusBar », « QTextEdit », « QToolButton » y « QToolTip ».

Si no se especifica esta propiedad, el ancho mínimo se calcula en función del contenido del widget y del estilo.

El valor es relativo al rectángulo de contenido en el modelo de caja.

Ejemplo:

QComboBox { min-width: 72px }

Nota: Al establecer esta propiedad, es posible que los widgets se reduzcan a un tamaño inferior al espacio necesario para el contenido.

Véase también min-height.

opacity*

TipoNúmero

La opacidad de un widget. Los valores posibles van de 0 (transparente) a 255 (opaco). Por el momento, solo es compatible con tooltips.

Si no se especifica esta propiedad, se establece por defecto en el valor especificado por el estilo actual para la indicación de estilo « SH_ToolTipLabel_Opacity ».

Ejemplo:

QToolTip { opacity: 223 }

outline

El contorno dibujado alrededor del borde del objeto.

color del contorno

TipoColor

El color del contorno. Véase también «border-color».

outline-offset

TipoLongitud

El desplazamiento del contorno respecto al borde del widget.

estilo del contorno

Especifica el patrón utilizado para dibujar el contorno. Véase también border-style

radio-del-contorno

Añade esquinas redondeadas al contorno.

radio-del-contorno-inferior-izquierdo

TipoRadio

El radio de la esquina redondeada inferior izquierda del contorno.

radio-del-contorno-inferior-derecho

TipoRadio

El radio de la esquina redondeada inferior derecha del contorno.

radio-superior-izquierdo-del-contorno

TipoRadio

El radio de la esquina superior izquierda del contorno.

radio-superior-derecho-del-contorno

TipoRadio

El radio de la esquina superior derecha redondeada del contorno.

Relleno

El relleno del widget. Equivale a especificar « padding-top », « padding-right », « padding-bottom » y « padding-left ».

Esta propiedad es compatible con las subclases de ` QAbstractItemView `, las subclases de ` QAbstractSpinBox `, ` QCheckBox`, ` QComboBox`, ` QFrame`, ` QGroupBox`, ` QLabel`, ` QLineEdit`, ` QMenu`, ` QMenuBar`, ` QPushButton`, ` QRadioButton`, ` QSplitter`, ` QTextEdit` y ` QToolTip`.

Si no se especifica esta propiedad, el valor predeterminado es 0.

Ejemplo:

QLineEdit { padding: 3px }

Véase también «margin», «spacing» y «El modelo de caja».

padding-top

TipoLongitud

El relleno superior del widget.

padding-right

TipoLongitud

El relleno a la derecha del widget.

padding-bottom

TipoLongitud

El relleno inferior del widget.

padding-left

TipoLongitud

El relleno a la izquierda del widget.

pintar-colores-alternos-de-filas-para-el-área-vacía

Tipobool

Indica si el control « QTreeView » pinta los colores de las filas de forma alterna en el área vacía (es decir, el área donde no hay elementos).

color-del-texto-del-marcador*

TipoPincel «
»

El color utilizado para el texto de marcador de posición de los widgets de edición de texto.

Si no se establece esta propiedad, el valor por defecto es el que se haya definido para la función « PlaceholderText » de la paleta.

Ejemplo:

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

Disponible desde la versión 6.5.

posición

Tiporelative
| absolute

Si los desplazamientos especificados mediante «left», «right», «top» y «bottom» son coordenadas relativas o absolutas.

Si no se especifica esta propiedad, el valor por defecto es « relative ».

TipoLongitud

Si la posición es « relative » (por defecto), desplaza un subcontrol una cierta distancia hacia la izquierda; especificar right: x equivale entonces a especificar left: -x.

Si la posición es « absolute », la propiedad « right » especifica el borde derecho del subcontrol en relación con el borde derecho del control padre (véase también «subcontrol-origin»).

Ejemplo:

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

Véase también «left», «top» y «bottom».

selection-background-color*

TipoPincel

El fondo del texto o los elementos seleccionados.

Esta propiedad es compatible con todos los widgets que respetan el estándar « QWidget::palette » y que muestran texto seleccionado.

Si no se establece esta propiedad, el valor por defecto es el que se haya definido para la función « Highlight » de la paleta.

Ejemplo:

QTextEdit { selection-background-color: darkblue }

Véase también «selection-color » y «background».

color-de-selección*

TipoPincel

El color de primer plano del texto o los elementos seleccionados.

Esta propiedad es compatible con todos los widgets que respetan el estilo « QWidget::palette » y que muestran texto seleccionado.

Si no se establece esta propiedad, el valor por defecto es el que se haya definido para la función « HighlightedText » de la paleta.

Ejemplo:

QTextEdit { selection-color: white }

Véase también «selection-background-color » y «color».

show-decoration-selected*

TipoBooleano

Determina si las selecciones en un « QListView » abarcan toda la fila o solo el espacio que ocupa el texto.

Si no se especifica esta propiedad, el valor por defecto es el especificado por el estilo actual para la sugerencia de estilo « SH_ItemView_ShowDecorationSelected ».

Ejemplo:

* { show-decoration-selected: 1 }

spacing*

TipoLongitud

Espaciado interno en el widget.

Esta propiedad es compatible con QCheckBox, QGroupBoxes, QMenuBar y QRadioButton.

Si no se especifica esta propiedad, el valor por defecto depende del widget y del estilo actual.

Ejemplo:

QMenuBar { spacing: 10 }

Véase también «padding » y «margin».

subcontrol-origin*

TipoOrigen

El rectángulo de origen del subcontrol dentro del elemento padre.

Si no se especifica esta propiedad, el valor por defecto es « padding ».

Ejemplo:

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

Véase también «subcontrol-position».

subcontrol-position*

La alineación del subcontrol dentro del rectángulo de origen especificado por «subcontrol-origin».

Si no se especifica esta propiedad, su valor por defecto depende del subcontrol.

Ejemplo:

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

Véase también «subcontrol-origin».

titlebar-show-tooltips-on-buttons

Tipobool

Si se muestran las descripciones emergentes en los botones de la barra de título de la ventana.

duración-de-la-animación-del-widget*

TipoNúmero

Duración de una animación (en milisegundos). Un valor igual a cero significa que las animaciones estarán desactivadas.

Si no se especifica esta propiedad, se utiliza por defecto el valor especificado por el estilo actual para la indicación de estilo « SH_Widget_Animation_Duration ».

Disponible desde Qt 5.10.

Ejemplo:

* { widget-animation-duration: 100 }

text-align

La alineación del texto y el icono dentro del contenido del widget.

Si no se especifica este valor, se establece por defecto en el valor que depende del estilo nativo.

Ejemplo:

QPushButton {
    text-align: left;
}

Actualmente, esta propiedad solo es compatible con QPushButton y QProgressBar.

text-decoration

Tiponone
underline
overline
line-through

Efectos de texto adicionales.

Inicio

TipoLongitud

Si la posición es « relative » (valor predeterminado), desplaza un subcontrol una distancia determinada hacia abajo.

Si la posición es « absolute », la propiedad « top » especifica el borde superior del subcontrol en relación con el borde superior del control padre (véase también «subcontrol-origin»).

Si no se especifica esta propiedad, el valor por defecto es « 0 ».

Ejemplo:

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

Véase también «left», «right» y «bottom».

anchura

TipoLongitud

El ancho de un subcontrol (o de un widget, en algunos casos).

Si no se especifica esta propiedad, su valor por defecto depende del subcontrol o widget y del estilo actual.

Advertencia: A menos que se especifique lo contrario, esta propiedad no tiene ningún efecto cuando se aplica a widgets. Si deseas que un widget tenga un ancho fijo, establece los valores de «min-width» y «max-width» en el mismo valor.

Ejemplo:

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

Véase también «height».

espaciado entre palabras

TipoLongitud

Espacio entre cada palabra de una cadena dentro de un widget.

-qt-background-role

El « background-color » del subcontrol o widget en función del rol elegido.

-qt-style-features

Tipolist

La lista de propiedades CSS a las que se desean aplicar estilos específicos de Qt.

Nota: El « list » solo puede incluir propiedades que no estén basadas en mapas de píxeles.

Lista de iconos

Los iconos utilizados en Qt se pueden personalizar mediante las siguientes propiedades. Cada una de las propiedades enumeradas en esta sección es de tipo Icon.

Ten en cuenta que, para que los iconos aparezcan en los botones de un cuadro de diálogo « QDialogButtonBox », debes establecer la propiedad «dialogbuttonbox-buttons-have-icons» en «true». Además, para personalizar el tamaño de los iconos, utiliza la propiedad «icon-size».

NombreQStyle::StandardPixmap
backward-iconQStyle::SP_ArrowBack
cd-iconQStyle::SP_DriveCDIcon
computer-iconQStyle::SP_ComputerIcon
icono-escritorioQStyle::SP_DesktopIcon
icono-aplicar-diálogoQStyle::SP_DialogApplyButton
icono-de-cancelar-en-ventana-de-diálogoQStyle::SP_DialogCancelButton
icono-de-cerrar-cuadro-de-diálogoQStyle::SP_DialogCloseButton
icono-de-descartar-del-cuadro-de-diálogoQStyle::SP_DialogDiscardButton
icono-de-ayuda-del-cuadro-de-diálogoQStyle::SP_DialogHelpButton
icono-sin-icono-de-cuadro-de-diálogoQStyle::SP_DialogNoButton
icono-de-aceptar-del-diálogoQStyle::SP_DialogOkButton
icono-de-abrir-cuadro-de-diálogoQStyle::SP_DialogOpenButton
icono-de-restablecer-cuadro-de-diálogoQStyle::SP_DialogResetButton
icono-guardar-diálogoQStyle::SP_DialogSaveButton
icono-de-diálogo-síQStyle::SP_DialogYesButton
icono-de-directorio-cerradoQStyle::SP_DirClosedIcon
icono-de-directorioQStyle::SP_DirIcon
icono-de-enlace-de-directorioQStyle::SP_DirLinkIcon
icono-de-directorio-abiertoQStyle::SP_DirOpenIcon
icono-de-cierre-del-widget-del-dockQStyle::SP_DockWidgetCloseButton
icono-de-flecha-hacia-abajoQStyle::SP_ArrowDown
icono de DVDQStyle::SP_DriveDVDIcon
icono-de-archivoQStyle::SP_FileIcon
icono-de-enlace-a-archivoQStyle::SP_FileLinkIcon
icono-de-vista-de-contenido-del-diálogo-de-archivosQStyle::SP_FileDialogContentsView
icono-de-vista-detallada-del-diálogo-de-archivosQStyle::SP_FileDialogDetailedView
icono-fin-del-diálogo-de-archivosQStyle::SP_FileDialogEnd
icono-de-vista-informativa-del-diálogo-de-archivosQStyle::SP_FileDialogInfoView
icono-de-vista-de-lista-del-diálogo-de-archivosQStyle::SP_FileDialogListView
icono de nuevo directorio del cuadro de diálogo de archivosQStyle::SP_FileDialogNewFolder
filedialog-icono-directorio-superiorQStyle::SP_FileDialogToParent
icono-inicio-diálogo-de-archivosQStyle::SP_FileDialogStart
icono-disqueteQStyle::SP_DriveFDIcon
icono-de-reenvíoQStyle::SP_ArrowForward
icono-de-disco-duroQStyle::SP_DriveHDIcon
icono-de-inicioQStyle::SP_DirHomeIcon
icono-botón-borrar-campo-de-textoQStyle::SP_LineEditClearButton
icono de flecha a la izquierdaQStyle::SP_ArrowLeft
icono-cuadro-de-mensaje-críticoQStyle::SP_MessageBoxCritical
icono de cuadro de mensaje informativoQStyle::SP_MessageBoxInformation
icono-de-cuadro-de-mensaje-preguntaQStyle::SP_MessageBoxQuestion
icono-de-cuadro-de-mensaje-de-advertenciaQStyle::SP_MessageBoxWarning
icono-redQStyle::SP_DriveNetIcon
icono-de-flecha-hacia-la-derechaQStyle::SP_ArrowRight
icono-de-ayuda-contextual-de-la-barra-de-títuloQStyle::SP_TitleBarContextHelpButton
icono-de-maximización-de-la-barra-de-títuloQStyle::SP_TitleBarMaxButton
icono-de-menú-en-la-barra-de-títuloQStyle::SP_TitleBarMenuButton
icono-de-minimización-de-la-barra-de-títuloQStyle::SP_TitleBarMinButton
icono-normal-de-la-barra-de-títuloQStyle::SP_TitleBarNormalButton
icono-de-oscurecimiento-de-la-barra-de-títuloQStyle::SP_TitleBarShadeButton
icono-de-desocultar-de-la-barra-de-títuloQStyle::SP_TitleBarUnshadeButton
icono-papeleraQStyle::SP_TrashIcon
icono-flecha-arribaQStyle::SP_ArrowUp

Lista de tipos de propiedad

La siguiente tabla resume la sintaxis y el significado de los diferentes tipos de propiedad.

:,
TipoSintaxisDescripción
Alineación { top
| bottom
| left
| right
| center }*
Horizontal and/or vertical alignment.

Example:

QTextEdit { background-position: bottom center }
Archivo adjunto { scroll
| fixed }*
Scroll or fixed attachment.
Antecedentes { Pincel
| URL
| Repetición
| Alineación }*
Una secuencia de «Brush», «Url», «Repeat» y «Alignment».
Booleano 0 | 1Verdadero (1) o falso (0).

Ejemplo:

QDialog { etch-disabled-text: 1 }
Borde { Estilo de borde
| Longitud
| Pincel }*
Propiedad de borde abreviada.
Imagen del borde none
| URL Número{4}
(stretch | repeat){0,2}
A border image is an image that is composed of nine parts (top left, top center, top right, center left, center, center right, bottom left, bottom center, and bottom right). When a border of a certain size is required, the corner parts are used as is, and the top, right, bottom, and left parts are stretched or repeated to produce a border with the desired size.

See the CSS3 Draft Specification for details.

Estilo «Border» dashed
| dot-dash
| dot-dot-dash
| dotted
| double
| groove
| inset
| outset
| ridge
| solid
| none
Specifies the pattern used to draw a border. See the CSS3 Draft Specification for details.
Colores de la caja Pincel{1,4}De una a cuatro apariciones de «Brush», que especifican los bordes superior, derecho, inferior e izquierdo de un cuadro, respectivamente. Si no se especifica el color de la izquierda, se considera que es el mismo que el de la derecha. Si no se especifica el color de la parte inferior, se considera que es el mismo que el de la parte superior. Si no se especifica el color de la derecha, se considera que es el mismo que el de la parte superior.

Ejemplo:

/* 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 }
Longitudes de los recuadros Longitud{1,4}De una a cuatro apariciones de «Longitud», que especifican los bordes superior, derecho, inferior e izquierdo de un cuadro, respectivamente. Si no se especifica la longitud de la izquierda, se considera que es igual a la de la derecha. Si no se especifica la longitud de la parte inferior, se considera que es igual a la de la parte superior. Si no se especifica la longitud de la derecha, se considera que es igual a la de la parte superior.

Ejemplos:

/* 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 }
Pincel Color
| Degradado
| PaletteRole
Especifica un color, un degradado o una entrada de la paleta.
Color rgb(r, g, b)
| rgba(r, g, b, a)
| hsv(h, s, v)
| hsva(h, s, v, a)
| hsl(h, s, l)
| hsla(h, s, l, a)
| #rrggbb
| Color Name
Especifica un color en formato RGB (rojo, verde, azul), RGBA (rojo, verde, azul, alfa), HSV (tono, saturación, valor), HSVA (tono, saturación, valor, alfa), HSL (tono, saturación, luminosidad), HSLA (tono, saturación, luminosidad, alfa) o un color con nombre. La sintaxis rgb() o rgba() puede utilizarse con valores enteros entre 0 y 255, o con porcentajes. Los valores de s, v, l y a en hsv(), hsva(), hsl() o hsla() deben estar todos en el rango de 0 a 255; si se utilizan porcentajes, el valor de h debe estar en el rango de 0 a 359. La compatibilidad con HSL(A) está disponible desde la versión 5.13.

Ejemplos:

/* 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%) }

Nota: Los colores RGB permitidos son los mismos que los permitidos con CSS 2.1, tal y como se enumeran aquí.

Fuente (Estilo de fuente | Grosor de fuente){0,2} Cadena de tamaño de fuente Propiedad de fuente abreviada.
Tamaño de la fuente LongitudEl tamaño de una fuente.
Estilo de fuente normal
| italic
| oblique
The style of a font.
Peso de la fuente normal
| bold
| 100
| 200
...
| 900
The weight of a font.
Gradient qlineargradient
| qradialgradient
| qconicalgradient
Specifies gradient fills. There are three types of gradient fills:
  • Los degradadoslineales interpolan los colores entre los puntos inicial y final.
  • Los degradadosradiales interpolan los colores entre un punto focal y los puntos finales situados en un círculo que lo rodea.
  • Los degradadoscónicos interpolan los colores alrededor de un punto central.

Los degradados se especifican en el modo de delimitación de objetos. Imagina que el rectángulo en el que se representa el degradado tiene su esquina superior izquierda en (0, 0) y su esquina inferior derecha en (1, 1). Los parámetros del degradado se especifican entonces como porcentajes entre 0 y 1. Estos valores se extrapolan a las coordenadas reales del rectángulo en tiempo de ejecución. Es posible especificar valores que se encuentren fuera del rectángulo delimitador (por ejemplo, -0,6 o 1,8).

Advertencia: Las paradas deben aparecer ordenadas de menor a mayor.

Ejemplos:

/* 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)
}
Icono (URL (disabled | active | normal | selected)? (on | off)? )*Una lista de direcciones URL: QIcon::Mode y QIcon::State.

Ejemplo:

* {
    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;
}
Longitud Número (px | pt | em | ex)?Un número seguido de una unidad de medida. El estándar CSS recomienda que los agentes de usuario ignoren una declaración con un valor no válido. En Qt, es obligatorio especificar unidades de medida. Para garantizar la compatibilidad con versiones anteriores de Qt, los números sin unidades de medida se tratan como píxeles en la mayoría de los contextos. Las unidades admitidas son:
  • px: píxeles
  • pt: el tamaño de un punto (es decir, 1/72 de pulgada)
  • em: el tamaño en relación con el tamaño de la fuente del elemento (por ejemplo, 2em significa 2 veces el tamaño de la fuente)
  • ex: la altura x de la fuente (es decir, la altura de la letra «x»)

Sin embargo, Qt está limitado a los tamaños de fuente especificados en pt y px, y cualquier otro tamaño debe estar en px, em o ex.

Número Un entero decimal o un número realEjemplos: 0, 18, +127, -255, 12.34, -.5, 0009.
Fuente ,margin,
| border
| padding
| content
Indicates which of four rectangles to use.
  • margin: El rectángulo de margen. El margen se encuentra fuera del borde.
  • border: El rectángulo de borde. Aquí es donde se dibuja cualquier borde.
  • padding: El rectángulo de relleno. A diferencia de los márgenes, el relleno se encuentra dentro del borde.
  • content: El rectángulo de contenido. Especifica dónde se sitúa el contenido real, excluyendo cualquier relleno, borde o margen.

Véase también «El modelo de caja».

PaletteRole alternate-base
| accent
| base
| bright-text
| button
| button-text
| dark
| highlight
| highlighted-text
| light
| link
| link-visited
| mid
| midlight
| placeholder-text
| shadow
| text
| tooltip-base
| tooltip-text
| window
| window-text
Estos valores se corresponden con la opción « Color roles » ( ) de la pestaña « QPalette » ( ) del widget.

Por ejemplo,

QPushButton { color: palette(dark); }
Radio Longitud{1, 2}Una o dos entradas de Longitud. Si solo se especifica una longitud, se utiliza como radio del cuarto de círculo que define la esquina. Si se especifican dos longitudes, la primera es el radio horizontal de un cuarto de elipse, mientras que la segunda es el radio vertical.
Repetir repeat-x
| repeat-y
| repeat
| no-repeat
A value indicating the nature of repetition.
  • repeat-x: Repetir horizontalmente.
  • repeat-y: Repetir verticalmente.
  • repeat: Repetir horizontal y verticalmente.
  • no-repeat: No repetir.
Url url(filename)filename es el nombre de un archivo en el disco local o almacenado mediante el sistema de recursos de Qt. Al establecer una imagen, se definen implícitamente el ancho y la altura del elemento.

Lista de pseudoestados

Se admiten los siguientes pseudoestados:

PseudoestadoDescripción
:active Este estado se establece cuando el widget se encuentra en una ventana activa.
:adjoins-item Este estado se establece cuando la rama «::branch» de un « QTreeView » está adyacente a un elemento.
:alternate Este estado se establece para cada fila alterna al dibujar la fila de un « QAbstractItemView » cuando « QAbstractItemView::alternatingRowColors()» está establecido en «true».
:bottom El elemento se sitúa en la parte inferior. Por ejemplo, un « QTabBar » cuyas pestañas estén situadas en la parte inferior.
:checked El elemento está marcado. Por ejemplo, el estado « checked » de « QAbstractButton ».
:closable Los elementos se pueden cerrar. Por ejemplo, el elemento « QDockWidget » tiene activada la función « QDockWidget::DockWidgetClosable ».
:closed El elemento se encuentra en estado cerrado. Por ejemplo, un elemento no desplegado en un QTreeView
:default El elemento es el predeterminado. Por ejemplo, un default QPushButton o una acción predeterminada en un QMenu.
:disabled El elemento es « disabled ».
:editable El QComboBox es editable.
:enabled El elemento es enabled.
:exclusive El elemento forma parte de un grupo de elementos exclusivo. Por ejemplo, un elemento de menú en un QActionGroup exclusivo.
:first El elemento es el primero (de una lista). Por ejemplo, la primera pestaña de un QTabBar.
:flat El elemento es plano. Por ejemplo, un flat QPushButton .
:floatable Los elementos pueden estar flotantes. Por ejemplo, el QDockWidget tiene activada la función QDockWidget::DockWidgetFloatable.
:focus El elemento tiene la función « input focus ».
:has-children El elemento tiene elementos secundarios. Por ejemplo, un elemento de un « QTreeView » que tiene elementos secundarios.
:has-siblings El elemento tiene elementos hermanos. Por ejemplo, un elemento de una « QTreeView » que tiene elementos hermanos.
:horizontal El elemento tiene orientación horizontal
:hover El cursor del ratón se encuentra sobre el elemento.
:indeterminate El elemento tiene un estado indeterminado. Por ejemplo, un « QCheckBox » o « QRadioButton » que se encuentra en « partially checked ».
:last El elemento es el último (de una lista). Por ejemplo, la última pestaña de un « QTabBar ».
:left El elemento está alineado a la izquierda. Por ejemplo, un QTabBar cuyas pestañas están alineadas a la izquierda.
:maximized El elemento está maximizado. Por ejemplo, un QMdiSubWindow maximizado.
:middle El elemento se encuentra en el centro (de una lista). Por ejemplo, una pestaña que no está al principio ni al final de un QTabBar.
:minimized El elemento está minimizado. Por ejemplo, un QMdiSubWindow minimizado.
:movable El elemento se puede mover. Por ejemplo, el QDockWidget tiene activada la función « QDockWidget::DockWidgetMovable ».
:no-frame El elemento no tiene marco. Por ejemplo, un « QSpinBox » o un « QLineEdit » sin marco.
:non-exclusive El elemento forma parte de un grupo de elementos no exclusivo. Por ejemplo, un elemento de menú en un QActionGroup no exclusivo.
:off En el caso de los elementos que se pueden activar o desactivar, esto se aplica a los elementos que se encuentran en estado «desactivado».
:on En el caso de los elementos que se pueden activar o desactivar, esto se aplica a los widgets que se encuentran en estado «activado».
:only-one El elemento es el único (de una lista). Por ejemplo, una pestaña aislada en un QTabBar.
:open El elemento se encuentra en estado abierto. Por ejemplo, un elemento expandido en un « QTreeView », o un « QComboBox » o « QPushButton » con un menú abierto.
:next-selected El elemento siguiente (en una lista) está seleccionado. Por ejemplo, la pestaña seleccionada de un QTabBar se encuentra junto a este elemento.
:pressed Se está pulsando el elemento con el ratón.
:previous-selected Está seleccionado el elemento anterior (de una lista). Por ejemplo, una pestaña de QTabBar que se encuentra junto a la pestaña seleccionada.
:read-only El elemento está marcado como de solo lectura o no editable. Por ejemplo, un QLineEdit de solo lectura o un QComboBox no editable.
:right El elemento está alineado a la derecha. Por ejemplo, un QTabBar cuyas pestañas están alineadas a la derecha.
:selected El elemento está seleccionado. Por ejemplo, la pestaña seleccionada en un QTabBar o el elemento seleccionado en un QMenu.
:top El elemento está situado en la parte superior. Por ejemplo, un QTabBar en el que las pestañas están situadas en la parte superior.
:unchecked El elemento es de tipo « unchecked ».
:vertical El elemento tiene orientación vertical.
:window El widget es una ventana (es decir, un widget de nivel superior).

Lista de subcontroles

Están disponibles los siguientes subcontroles:

SubcontrolDescripción
::add-line El botón para añadir una línea a un « QScrollBar ».
::add-page La región comprendida entre el control deslizante y la línea de « QScrollBar ».
::branch El indicador de ramificación de un « QTreeView ».
::chunk El indicador de progreso de un « QProgressBar ».
::close-button El botón de cierre de un « QDockWidget » o las pestañas de QTabBar
::corner La esquina entre dos barras de desplazamiento en un QAbstractScrollArea
::down-arrow La flecha hacia abajo de un « QComboBox », un « QHeaderView » (indicador de ordenación), un « QScrollBar » o un « QSpinBox ».
::down-button El botón hacia abajo de un QScrollBar o de un QSpinBox.
::drop-down El botón desplegable de un QComboBox.
::float-button El botón de flotación de un QDockWidget
::groove La ranura de un QSlider.
::indicator El indicador de un QAbstractItemView, un QCheckBox, un QRadioButton, un elemento de casilla de verificación QMenu o un elemento de casilla de verificación QGroupBox.
::handle El control deslizante de un QScrollBar, un QSplitter o un QSlider.
::icon El icono de un QAbstractItemView o un QMenu.
::item Un elemento de QAbstractItemView, QMenuBar, QMenu o QStatusBar.
::left-arrow La flecha izquierda de un QScrollBar.
::left-corner La esquina izquierda de un QTabWidget. Por ejemplo, este control se puede utilizar para controlar la posición del widget de la esquina izquierda en un QTabWidget.
::menu-arrow La flecha de un « QToolButton » con menú.
::menu-button El botón de menú de un « QToolButton ».
::menu-indicator El indicador de menú de un QPushButton.
::right-arrow La flecha derecha de un « QMenu » o un « QScrollBar ».
::pane El panel (marco) de un QTabWidget.
::right-corner La esquina derecha de un QTabWidget. Por ejemplo, este control se puede utilizar para controlar la posición del widget de la esquina derecha en un QTabWidget.
::scroller La barra de desplazamiento de un QMenu o un QTabBar.
::section La sección de un QHeaderView.
::separator El separador de un QMenu o de un QMainWindow.
::sub-line El botón para restar una línea de QScrollBar.
::sub-page La zona situada entre el control deslizante y la sublínea de un « QScrollBar ».
::tab La pestaña de un QTabBar o de un QToolBox.
::tab-bar La barra de pestañas de un ` QTabWidget`. Este subcontrol existe únicamente para controlar la posición del ` QTabBar ` dentro del ` QTabWidget`. Para aplicar estilos a las pestañas utilizando el subcontrol `::tab`.
::tear El indicador de desprendimiento de un « QTabBar ».
::tearoff El indicador de desprendimiento de un « QMenu ».
::text El texto de un « QAbstractItemView ».
::title El título de un « QGroupBox » o de un « QDockWidget ».
::up-arrow La flecha hacia arriba de un « QHeaderView » (indicador de ordenación), un « QScrollBar » o un « QSpinBox ».
::up-button El botón de subida de un QSpinBox.

Consulte Personalización del subcontrol «Indicador de menú» de QPushButton para ver un ejemplo de cómo personalizar un subcontrol.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.