Referencia de Hojas de Estilo Qt

Las Hojas de Estilo de Qt soportan varias propiedades, pseudoestados y subcontroles que hacen posible personalizar la apariencia de los widgets.

Lista de widgets estilizables

La siguiente tabla enumera los Qt Widgets que pueden personalizarse utilizando hojas de estilo:

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); }

Lista de propiedades

Esta sección lista todas las propiedades soportadas por las Hojas de Estilo Qt. Los valores que se pueden dar a una propiedad dependen del tipo de propiedad. 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 o CSS3. Las propiedades específicas de Qt son las siguientes:

• gridline-color*
• imagen*
• Lineedit-contraseña-carácter*.
• lineedit-password-mask-delay* (retardo de máscara de contraseña)
• messagebox-texto-interacción-flags*
• opacidad*
• color-texto-marcador de posición*
• selección-color-fondo*
• selection-color*
• mostrar-decoración-seleccionado*
• espaciado*
• subcontrol-origen*
• subcontrol-position*
• duración de la animación del widget

acento-color

Esta propiedad establece el color Accent, que se utiliza para acentuar los elementos interactivos de la interfaz de usuario. Si no se establece esta propiedad, se utiliza por defecto el color highlight.

alternate-background-color

El alternate background color utilizado en QAbstractItemView subclases.

Si no se establece esta propiedad, el valor por defecto es el establecido para la función AlternateBase de la paleta.

Ejemplo:

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

Ver también background y selection-background-color.

fondo

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

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

Ejemplo:

QTextEdit { background: yellow }

A menudo, es necesario establecer un patrón de relleno similar a los estilos de Qt::BrushStyle. Puede utilizar la propiedad background-color para Qt::SolidPattern, Qt::RadialGradientPattern, Qt::LinearGradientPattern y Qt::ConicalGradientPattern. Los otros 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

El color de fondo utilizado para el widget.

Ejemplos:

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

background-image

La imagen de fondo utilizada para el widget. Las partes semitransparentes de la imagen dejan entrever la dirección background-color.

Ejemplo:

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

background-repeat

Cómo se repite la imagen de fondo para rellenar el rectángulo background-origin.

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

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

Ejemplo:

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

Véase también background

background-clip

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

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

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

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.

fondo-origen

El rectángulo de fondo del widget, para utilizar junto con background-position y background-image.

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

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 background y The Box Model.

borde

Notación abreviada para establecer el borde del widget. Equivale a especificar border-color, border-style, y/o border-width.

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

Ejemplo:

QLineEdit { border: 1px solid white }

border-top

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

borde-derecho

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

borde-inferior

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

borde-izquierdo

Notación abreviada para establecer el borde izquierdo del widget. Equivale a especificar border-left-color, border-left-style, y/o border-left-width.

borde-color

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

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

Si no se especifica esta propiedad, 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

Color del borde superior del borde.

color-borde-derecho

Color del borde derecho.

color-borde-inferior

Color del borde inferior del borde.

border-left-color

Color del borde izquierdo.

borde-imagen

La imagen utilizada para rellenar el borde. La imagen se corta en nueve partes y se estira adecuadamente si es necesario. Vea Imagen de borde para más detalles.

Esta propiedad es compatible con las subclases QAbstractItemView, 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 The Box Model.

radio del borde

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 radio del borde recorta el fondo del elemento.

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

Si no se especifica esta propiedad, su valor por defecto 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

Radio de la esquina superior izquierda del borde.

border-top-right-radius

Radio de la esquina superior derecha del borde.

border-bottom-right-radius

Radio de la esquina inferior derecha del borde. Establecer esta propiedad a un valor positivo da como resultado una esquina redondeada.

border-bottom-left-radius

Radio de la esquina inferior izquierda del borde. Establecer esta propiedad a un valor positivo da como resultado una esquina redondeada.

Estilo de borde

El estilo de todos los bordes del borde.

Esta propiedad es soportada por QAbstractItemView subclases, QAbstractSpinBox subclases, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, y QToolTip.

Si no se especifica esta propiedad, 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 border-top

Estilo del borde superior del borde.

estilo-borde-derecho

Estilo del borde derecho del borde.

estilo del borde inferior

Estilo del borde inferior del borde.

estilo-borde-izquierdo

El estilo del borde izquierdo del borde.

ancho-borde

La anchura del borde. Equivale a configurar border-top-width, border-right-width, border-bottom-width, y border-left-width.

Esta propiedad es compatible con las subclases QAbstractItemView, 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

Ancho del borde superior del borde.

border-right-width

Anchura del borde derecho del borde.

border-bottom-width

Ancho del borde inferior del borde.

ancho-borde-izquierdo

Anchura del borde izquierdo del borde.

inferior

Si position es relative (por defecto), desplaza un subcontrol un cierto desplazamiento hacia arriba; especificar bottom: y equivale 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 padre (véase también origen del subcontrol).

Ejemplo:

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

Ver también izquierda, derecha y arriba.

disposición de los botones

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

Si no se especifica esta propiedad, por defecto toma el valor especificado por el estilo actual para la sugerencia de estilo SH_DialogButtonLayout.

Ejemplo:

* { button-layout: 2 }

color

El color utilizado para representar el texto.

Esta propiedad es soportada por todos los widgets que respetan la QWidget::palette.

Si no se establece esta propiedad, el valor predeterminado es el que esté establecido en la paleta del widget para QWidget::foregroundRole (normalmente negro).

Ejemplo:

QPushButton { color: red }

Ver también background y selection-color.

dialogbuttonbox-buttons-have-icons

Si los botones de un 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.

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

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

fuente

Notación abreviada para establecer el tipo de letra 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 la QWidget::font.

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

Ejemplo:

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

font-family

Familia de fuentes.

Ejemplo:

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

font-size

El tamaño de la fuente. En esta versión de Qt, sólo se admiten las métricas pt y px.

Ejemplo:

QTextEdit { font-size: 12px }

font-style

El estilo de fuente.

Ejemplo:

QTextEdit { font-style: italic }

font-weight

El peso de la fuente.

Color de la rejilla

Color de la línea de la cuadrícula en QTableView.

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

Ejemplo:

* { gridline-color: gray }

altura

La altura de un subcontrol (o en su caso, de un widget).

Si no se especifica esta propiedad, toma por defecto un valor que depende del subcontrol/widget y del estilo actual.

Ejemplo:

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

Véase también anchura.

icono

El icono que se utiliza, para los widgets que tienen un icono.

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

Disponible desde 5.15.

tamaño-icono

La anchura y la altura del icono en un widget.

El tamaño del icono de los siguientes widgets puede establecerse utilizando esta propiedad.

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

imagen*

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

La propiedad image acepta una lista de Urlso un svg. La imagen real que se dibuja se determina utilizando el mismo algoritmo que QIcon (es decir, la imagen nunca se escala hacia arriba sino hacia abajo si es necesario). Si se especifica un svg, la imagen se escala al tamaño del rectángulo de contenido.

Al establecer la propiedad image en los subcontroles se establece implícitamente la anchura y la altura del subcontrol (a menos que la imagen esté en un SVG).

En Qt 4.3 y posteriores, la alineación de la imagen dentro del rectángulo puede especificarse utilizando image-position.

Esta propiedad es sólo para subcontroles-no la soportamos para otros elementos.

Ejemplo:

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

image-position

En Qt 4.3 y posteriores, la alineación de la posición de la imagen se puede especificar utilizando posición relativa o absoluta.

izquierda

Si la posición es relative (por defecto), mueve un subcontrol un cierto desplazamiento hacia la derecha.

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

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

Ejemplo:

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

Véase también derecha, arriba y abajo.

espaciado entre letras

Espacio entre caracteres en una cadena dentro de un widget.

lineedit-contraseña-carácter*

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

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

Ejemplo:

* { lineedit-password-character: 9679 }

lineedit-contraseña-máscara-retraso*

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

Si no se especifica esta propiedad, el valor predeterminado 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 QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, y QToolTip.

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

Ejemplo:

QLineEdit { margin: 2px }

Véase también relleno, espaciado y El modelo de caja.

margin-top

Margen superior del widget.

margin-right

Margen derecho del widget.

margin-bottom

Margen inferior del widget.

margin-left

Margen izquierdo del widget.

max-height

Altura máxima del widget o subcontrol.

Esta propiedad es soportada por QAbstractItemView subclases, QAbstractSpinBox subclases, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, y QToolTip.

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

Ejemplo:

QSpinBox { max-height: 24px }

Véase también max-width.

max-width

Ancho máximo del widget o subcontrol.

Esta propiedad es soportada por QAbstractItemView subclases, QAbstractSpinBox subclases, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, y QToolTip.

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

Ejemplo:

QComboBox { max-width: 72px }

Véase también altura máxima.

messagebox-text-interaction-flags* (etiquetas de interacción de texto en el buzón de mensajes)

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, el valor predeterminado es el especificado por el estilo actual para la sugerencia de estilo SH_MessageBox_TextInteractionFlags.

Ejemplo:

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

altura mínima

Altura mínima del widget o subcontrol.

Esta propiedad es soportada por QAbstractItemView subclases, QAbstractSpinBox subclases, 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 obtiene a partir 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 }

Véase también min-width.

min-width

Ancho mínimo del widget o subcontrol.

Esta propiedad es soportada por QAbstractItemView subclases, QAbstractSpinBox subclases, 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 anchura mínima se obtiene a partir 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 }

Véase también altura mínima.

opacidad*

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

Si no se especifica esta propiedad, el valor predeterminado es el especificado por el estilo actual para la sugerencia de estilo SH_ToolTipLabel_Opacity.

Ejemplo:

QToolTip { opacity: 223 }

esquema

El contorno dibujado alrededor del borde del objeto.

contorno-color

Color del contorno. Véase también color del borde

contorno-desplazamiento

Desplazamiento del contorno desde el borde del widget.

estilo de contorno

Especifica el patrón utilizado para dibujar el contorno. Véase también estilo del borde

radio del contorno

Añade esquinas redondeadas al contorno.

outline-bottom-left-radius

Radio de la esquina redondeada inferior izquierda del contorno.

outline-bottom-right-radius

Radio de la esquina inferior derecha del contorno.

outline-top-left-radius

Radio de la esquina superior izquierda del contorno.

outline-top-right-radius

Radio de la esquina superior derecha 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 QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, y QToolTip.

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

Ejemplo:

QLineEdit { padding: 3px }

Véase también margen, espaciado y El modelo de caja.

padding-top

El relleno superior del widget.

padding-right

El relleno derecho del widget.

padding-bottom

El relleno inferior del widget.

padding-left

El relleno izquierdo del widget.

pintar-colores-alternativos-de-fila-para-área-vacía

Si QTreeView alterna los colores de las filas para el área vacía (es decir, el área en la que no hay artículos).

marcador de posición-color-texto*

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

Si no se establece esta propiedad, el valor por defecto es el establecido para la función PlaceholderText de la paleta.

Ejemplo:

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

Disponible desde 6.5.

posición

Si los desplazamientos especificados mediante izquierda, derecha, arriba y abajo son coordenadas relativas o absolutas.

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

derecha

Si position es relative (por defecto), desplaza un subcontrol un cierto desplazamiento hacia la izquierda; especificar right: x equivale 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 padre (véase también origen del subcontrol).

Ejemplo:

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

Ver también izquierda, arriba y abajo.

selección-color-fondo*

El fondo del texto o elementos seleccionados.

Esta propiedad es soportada por todos los widgets que respetan la QWidget::palette y que muestran texto de selección.

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

Ejemplo:

QTextEdit { selection-background-color: darkblue }

Ver también selection-color y background.

selección-color*

El primer plano del texto o elementos seleccionados.

Esta propiedad es soportada por todos los widgets que respetan la QWidget::palette y que muestran texto de selección.

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

Ejemplo:

QTextEdit { selection-color: white }

Ver también selection-background-color y color.

mostrar-decoración-seleccionado*

Controla si las selecciones en QListView cubren toda la fila o sólo la extensión del texto.

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

Ejemplo:

* { show-decoration-selected: 1 }

espaciado*

Espaciado interno en el widget.

Esta propiedad es compatible con QCheckBox, comprobable 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-origen*

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-posición*

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

Si no se especifica esta propiedad, toma por defecto un valor que depende del subcontrol.

Ejemplo:

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

Véase también subcontrol-origen.

titlebar-show-tooltips-on-buttons

Si se muestran consejos sobre herramientas en los botones de la barra de título de la ventana.

widget-animation-duration* (duración de la animación del widget)

Cuánto debe durar una animación (en milisegundos). Un valor igual a cero significa que las animaciones estarán desactivadas.

Si no se especifica esta propiedad, se utilizará por defecto el valor especificado por el estilo actual para la sugerencia 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 el valor que depende del estilo nativo.

Ejemplo:

QPushButton {
    text-align: left;
}

Esta propiedad sólo es compatible actualmente con QPushButton y QProgressBar.

decoración de texto

Efectos de texto adicionales.

top

Si la posición es relative (por defecto), mueve un subcontrol un cierto desplazamiento hacia abajo.

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

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

Ejemplo:

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

Ver también izquierda, derecha y abajo.

anchura

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

Si no se especifica esta propiedad, se establece por defecto un valor que depende del subcontrol/widget y del estilo actual.

Ejemplo:

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

Véase también altura.

espaciado entre palabras

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

-qt-background-role

El background-color para el subcontrol o widget basado en el rol elegido.

-qt-style-features

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

Lista de iconos

Los iconos utilizados en Qt pueden personalizarse utilizando las siguientes propiedades. Cada una de las propiedades listadas en esta sección tiene el tipo Icono.

Tenga en cuenta que para que los iconos aparezcan en los botones de QDialogButtonBox, debe establecer la propiedad dialogbuttonbox-buttons-have-icons a true. Además, para personalizar el tamaño de los iconos, utilice la propiedad icon-size.

Lista de tipos de propiedades

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

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); }

Lista de Pseudo-Estados

Se admiten los siguientes pseudoestados:

Lista de subcontroles

Están disponibles los siguientes subcontroles:

Consulte Personalizar el subcontrol del indicador de menú de QPushButton para ver un ejemplo de cómo personalizar un subcontrol.