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:
| Widget | Có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, 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.
|
| 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, 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: 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:
- gridline-color*
- image*
- lineedit-password-character*
- lineedit-password-mask-delay*
- indicadores de interacción del texto del cuadro de mensaje*
- opacidad*
- color-del-texto-del-marcador-de-posición*
- color-de-fondo-de-la-selección*
- color de selección*
- mostrar-decoración-seleccionada*
- espaciado*
- origen-del-subcontrol*
- posición-del-subcontrol*
- duración-de-la-animación-del-componente*
color-de-resaltado
| Tipo | Pincel |
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
| Tipo | Pincel |
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
| Tipo | Fondo |
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
| Tipo | Pincel |
El color de fondo utilizado para el widget.
Ejemplos:
imagen de fondo
| Tipo | URL |
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
| Tipo | Repetición |
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
| Tipo | Alineación |
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
| Tipo | Fijació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
| Tipo | Origen |
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
| Tipo | Origen |
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
| Tipo | Borde |
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
| Tipo | Borde |
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
| Tipo | Borde |
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
| Tipo | Borde |
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
| Tipo | Borde |
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
| Tipo | Pincel |
El color del borde superior.
color del borde derecho
| Tipo | Pincel |
El color del borde derecho.
color del borde inferior
| Tipo | Pincel |
El color del borde inferior.
color del borde izquierdo
| Tipo | Pincel |
El color del borde izquierdo.
border-image
| Tipo | Imagen del borde |
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
| Tipo | Radio |
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
| Tipo | Radio |
El radio de la esquina superior izquierda del borde.
border-top-right-radius
| Tipo | Radio |
El radio de la esquina superior derecha del borde.
border-bottom-right-radius
| Tipo | Radio |
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
| Tipo | Radio |
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
| Tipo | 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
| Tipo | Estilo del borde} |
El estilo del borde superior.
border-right-style
| Tipo | Estilo del borde |
El estilo del borde derecho.
border-bottom-style
| Tipo | Estilo del borde |
El estilo del borde inferior.
border-left-style
| Tipo | Estilo del borde |
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
| Tipo | Longitud |
El ancho del borde superior.
border-right-width
| Tipo | Longitud |
El ancho del borde derecho.
ancho-del-borde-inferior
| Tipo | Longitud |
El ancho del borde inferior.
ancho-del-borde-izquierdo
| Tipo | Longitud |
El ancho del borde izquierdo.
parte inferior
| Tipo | Longitud |
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
| Tipo | Nú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
| Tipo | Pincel |
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
| Tipo | Booleano |
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
| Tipo | Fuente |
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
| Tipo | Cadena |
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
| Tipo | 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*
| Tipo | Color |
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
| Tipo | Longitud |
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
| Tipo | URL+ |
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
| Tipo | Longitud |
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*
| Tipo | URL+ |
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
| Tipo | alineación |
La alineación de la posición de la imagen se puede especificar utilizando una posición relativa o absoluta.
izquierda
| Tipo | Longitud |
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
| Tipo | Longitud |
Espacio entre los caracteres de una cadena dentro de un widget.
lineedit-password-character*
| Tipo | Nú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*
| Tipo | Nú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
| Tipo | Longitud |
El margen superior del widget.
margen-derecho
| Tipo | Longitud |
El margen derecho del widget.
margin-bottom
| Tipo | Longitud |
El margen inferior del widget.
margin-left
| Tipo | Longitud |
El margen izquierdo del widget.
altura máxima
| Tipo | Longitud |
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
| Tipo | Longitud |
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*
| Tipo | Nú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
| Tipo | Longitud |
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
| Tipo | Longitud |
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*
| Tipo | Nú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
| Tipo | Color |
El color del contorno. Véase también «border-color».
outline-offset
| Tipo | Longitud |
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
| Tipo | Radio |
El radio de la esquina redondeada inferior izquierda del contorno.
radio-del-contorno-inferior-derecho
| Tipo | Radio |
El radio de la esquina redondeada inferior derecha del contorno.
radio-superior-izquierdo-del-contorno
| Tipo | Radio |
El radio de la esquina superior izquierda del contorno.
radio-superior-derecho-del-contorno
| Tipo | Radio |
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
| Tipo | Longitud |
El relleno superior del widget.
padding-right
| Tipo | Longitud |
El relleno a la derecha del widget.
padding-bottom
| Tipo | Longitud |
El relleno inferior del widget.
padding-left
| Tipo | Longitud |
El relleno a la izquierda del widget.
pintar-colores-alternos-de-filas-para-el-área-vacía
| Tipo | bool |
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*
| Tipo | Pincel « » |
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
| Tipo | relative | 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 ».
derecha
| Tipo | Longitud |
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*
| Tipo | Pincel |
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*
| Tipo | Pincel |
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*
| Tipo | Booleano |
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*
| Tipo | Longitud |
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*
| Tipo | 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-position*
| Tipo | Alineación |
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
| Tipo | bool |
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*
| Tipo | Nú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
| Tipo | Alineación |
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
| Tipo | none underline overline line-through |
Efectos de texto adicionales.
Inicio
| Tipo | Longitud |
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
| Tipo | Longitud |
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
| Tipo | Longitud |
Espacio entre cada palabra de una cadena dentro de un widget.
-qt-background-role
| Tipo | PaletteRole |
El « background-color » del subcontrol o widget en función del rol elegido.
-qt-style-features
| Tipo | list |
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».
| Nombre | QStyle::StandardPixmap |
|---|---|
| backward-icon | QStyle::SP_ArrowBack |
| cd-icon | QStyle::SP_DriveCDIcon |
| computer-icon | QStyle::SP_ComputerIcon |
| icono-escritorio | QStyle::SP_DesktopIcon |
| icono-aplicar-diálogo | QStyle::SP_DialogApplyButton |
| icono-de-cancelar-en-ventana-de-diálogo | QStyle::SP_DialogCancelButton |
| icono-de-cerrar-cuadro-de-diálogo | QStyle::SP_DialogCloseButton |
| icono-de-descartar-del-cuadro-de-diálogo | QStyle::SP_DialogDiscardButton |
| icono-de-ayuda-del-cuadro-de-diálogo | QStyle::SP_DialogHelpButton |
| icono-sin-icono-de-cuadro-de-diálogo | QStyle::SP_DialogNoButton |
| icono-de-aceptar-del-diálogo | QStyle::SP_DialogOkButton |
| icono-de-abrir-cuadro-de-diálogo | QStyle::SP_DialogOpenButton |
| icono-de-restablecer-cuadro-de-diálogo | QStyle::SP_DialogResetButton |
| icono-guardar-diálogo | QStyle::SP_DialogSaveButton |
| icono-de-diálogo-sí | QStyle::SP_DialogYesButton |
| icono-de-directorio-cerrado | QStyle::SP_DirClosedIcon |
| icono-de-directorio | QStyle::SP_DirIcon |
| icono-de-enlace-de-directorio | QStyle::SP_DirLinkIcon |
| icono-de-directorio-abierto | QStyle::SP_DirOpenIcon |
| icono-de-cierre-del-widget-del-dock | QStyle::SP_DockWidgetCloseButton |
| icono-de-flecha-hacia-abajo | QStyle::SP_ArrowDown |
| icono de DVD | QStyle::SP_DriveDVDIcon |
| icono-de-archivo | QStyle::SP_FileIcon |
| icono-de-enlace-a-archivo | QStyle::SP_FileLinkIcon |
| icono-de-vista-de-contenido-del-diálogo-de-archivos | QStyle::SP_FileDialogContentsView |
| icono-de-vista-detallada-del-diálogo-de-archivos | QStyle::SP_FileDialogDetailedView |
| icono-fin-del-diálogo-de-archivos | QStyle::SP_FileDialogEnd |
| icono-de-vista-informativa-del-diálogo-de-archivos | QStyle::SP_FileDialogInfoView |
| icono-de-vista-de-lista-del-diálogo-de-archivos | QStyle::SP_FileDialogListView |
| icono de nuevo directorio del cuadro de diálogo de archivos | QStyle::SP_FileDialogNewFolder |
| filedialog-icono-directorio-superior | QStyle::SP_FileDialogToParent |
| icono-inicio-diálogo-de-archivos | QStyle::SP_FileDialogStart |
| icono-disquete | QStyle::SP_DriveFDIcon |
| icono-de-reenvío | QStyle::SP_ArrowForward |
| icono-de-disco-duro | QStyle::SP_DriveHDIcon |
| icono-de-inicio | QStyle::SP_DirHomeIcon |
| icono-botón-borrar-campo-de-texto | QStyle::SP_LineEditClearButton |
| icono de flecha a la izquierda | QStyle::SP_ArrowLeft |
| icono-cuadro-de-mensaje-crítico | QStyle::SP_MessageBoxCritical |
| icono de cuadro de mensaje informativo | QStyle::SP_MessageBoxInformation |
| icono-de-cuadro-de-mensaje-pregunta | QStyle::SP_MessageBoxQuestion |
| icono-de-cuadro-de-mensaje-de-advertencia | QStyle::SP_MessageBoxWarning |
| icono-red | QStyle::SP_DriveNetIcon |
| icono-de-flecha-hacia-la-derecha | QStyle::SP_ArrowRight |
| icono-de-ayuda-contextual-de-la-barra-de-título | QStyle::SP_TitleBarContextHelpButton |
| icono-de-maximización-de-la-barra-de-título | QStyle::SP_TitleBarMaxButton |
| icono-de-menú-en-la-barra-de-título | QStyle::SP_TitleBarMenuButton |
| icono-de-minimización-de-la-barra-de-título | QStyle::SP_TitleBarMinButton |
| icono-normal-de-la-barra-de-título | QStyle::SP_TitleBarNormalButton |
| icono-de-oscurecimiento-de-la-barra-de-título | QStyle::SP_TitleBarShadeButton |
| icono-de-desocultar-de-la-barra-de-título | QStyle::SP_TitleBarUnshadeButton |
| icono-papelera | QStyle::SP_TrashIcon |
| icono-flecha-arriba | QStyle::SP_ArrowUp |
Lista de tipos de propiedad
La siguiente tabla resume la sintaxis y el significado de los diferentes tipos de propiedad.
| Tipo | Sintaxis | Descripción | ||
|---|---|---|---|---|
| Alineación | { top | bottom | left | right | center }* | Horizontal and/or vertical alignment. Example: | ||
| 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 | 1 | Verdadero (1) o falso (0).Ejemplo: | ||
| 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: | ||
| 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: | ||
| 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: 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 | Longitud | El 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 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: | ||
| Icono | (URL (disabled | active | normal | selected)? (on | off)? )* | Una lista de direcciones URL: QIcon::Mode y QIcon::State. Ejemplo: | ||
| 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:
Sin embargo, Qt está limitado a los tamaños de fuente especificados en | ||
| Número | Un entero decimal o un número real | Ejemplos: 0, 18, +127, -255, 12.34, -.5, 0009. | ||
| Fuente | ,margin, | border | padding | content | Indicates which of four rectangles to use.
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, | ||
| 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.
| ||
| 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:
| Pseudoestado | Descripció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:
| Subcontrol | Descripció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.