En esta página

QStyle Class

La clase QStyle es una clase base abstracta que encapsula el aspecto y el comportamiento de una interfaz gráfica de usuario. Más información...

Encabezado: #include <QStyle>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QObject
Heredado por:

QCommonStyle

Tipos públicos

enum ComplexControl { CC_SpinBox, CC_ComboBox, CC_ScrollBar, CC_Slider, CC_ToolButton, …, CC_CustomBase }
enum ContentsType { CT_CheckBox, CT_ComboBox, CT_HeaderSection, CT_LineEdit, CT_Menu, …, CT_MdiControls }
enum ControlElement { CE_PushButton, CE_PushButtonBevel, CE_PushButtonLabel, CE_DockWidgetTitle, CE_Splitter, …, CE_ShapedFrame }
enum PixelMetric { PM_ButtonMargin, PM_DockWidgetTitleBarButtonMargin, PM_ButtonDefaultIndicator, PM_MenuButtonIndicator, PM_ButtonShiftHorizontal, …, PM_CustomBase }
enum PrimitiveElement { PE_PanelButtonCommand, PE_FrameDefaultButton, PE_PanelButtonBevel, PE_PanelButtonTool, PE_PanelLineEdit, …, PE_PanelMenu }
enum RequestSoftwareInputPanel { RSIP_OnMouseClickAndAlreadyFocused, RSIP_OnMouseClick }
enum StandardPixmap { SP_TitleBarMinButton, SP_TitleBarMenuButton, SP_TitleBarMaxButton, SP_TitleBarCloseButton, SP_TitleBarNormalButton, …, SP_CustomBase }
flags State
enum StateFlag { State_None, State_Active, State_AutoRaise, State_Children, State_DownArrow, …, State_Small }
enum StyleHint { SH_EtchDisabledText, SH_DitherDisabledText, SH_ScrollBar_ContextMenu, SH_ScrollBar_MiddleClickAbsolutePosition, SH_ScrollBar_LeftClickAbsolutePosition, …, SH_Table_AlwaysDrawLeftTopGridLines }
enum SubControl { SC_None, SC_ScrollBarAddLine, SC_ScrollBarSubLine, SC_ScrollBarAddPage, SC_ScrollBarSubPage, …, SC_All }
flags SubControls
enum SubElement { SE_PushButtonContents, SE_PushButtonFocusRect, SE_PushButtonLayoutItem, SE_PushButtonBevel, SE_CheckBoxIndicator, …, SE_ToolBarHandle }

Funciones públicas

QStyle()
virtual ~QStyle()
int combinedLayoutSpacing(QSizePolicy::ControlTypes controls1, QSizePolicy::ControlTypes controls2, Qt::Orientation orientation, QStyleOption *option = nullptr, QWidget *widget = nullptr) const
virtual void drawComplexControl(QStyle::ComplexControl control, const QStyleOptionComplex *option, QPainter *painter, const QWidget *widget = nullptr) const = 0
virtual void drawControl(QStyle::ControlElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = nullptr) const = 0
virtual void drawItemPixmap(QPainter *painter, const QRect &rectangle, int alignment, const QPixmap &pixmap) const
virtual void drawItemText(QPainter *painter, const QRect &rectangle, int alignment, const QPalette &palette, bool enabled, const QString &text, QPalette::ColorRole textRole = QPalette::NoRole) const
virtual void drawPrimitive(QStyle::PrimitiveElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = nullptr) const = 0
virtual QPixmap generatedIconPixmap(QIcon::Mode iconMode, const QPixmap &pixmap, const QStyleOption *option) const = 0
virtual QStyle::SubControl hitTestComplexControl(QStyle::ComplexControl control, const QStyleOptionComplex *option, const QPoint &position, const QWidget *widget = nullptr) const = 0
virtual QRect itemPixmapRect(const QRect &rectangle, int alignment, const QPixmap &pixmap) const
virtual QRect itemTextRect(const QFontMetrics &metrics, const QRect &rectangle, int alignment, bool enabled, const QString &text) const
virtual int layoutSpacing(QSizePolicy::ControlType control1, QSizePolicy::ControlType control2, Qt::Orientation orientation, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const = 0
(since 6.1) QString name() const
virtual int pixelMetric(QStyle::PixelMetric metric, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const = 0
virtual void polish(QWidget *widget)
virtual void polish(QApplication *application)
virtual void polish(QPalette &palette)
const QStyle *proxy() const
virtual QSize sizeFromContents(QStyle::ContentsType type, const QStyleOption *option, const QSize &contentsSize, const QWidget *widget = nullptr) const = 0
virtual QIcon standardIcon(QStyle::StandardPixmap standardIcon, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const = 0
virtual QPalette standardPalette() const
virtual int styleHint(QStyle::StyleHint hint, const QStyleOption *option = nullptr, const QWidget *widget = nullptr, QStyleHintReturn *returnData = nullptr) const = 0
virtual QRect subControlRect(QStyle::ComplexControl control, const QStyleOptionComplex *option, QStyle::SubControl subControl, const QWidget *widget = nullptr) const = 0
virtual QRect subElementRect(QStyle::SubElement element, const QStyleOption *option, const QWidget *widget = nullptr) const = 0
virtual void unpolish(QWidget *widget)
virtual void unpolish(QApplication *application)

Miembros públicos estáticos

QRect alignedRect(Qt::LayoutDirection direction, Qt::Alignment alignment, const QSize &size, const QRect &rectangle)
int sliderPositionFromValue(int min, int max, int logicalValue, int span, bool upsideDown = false)
int sliderValueFromPosition(int min, int max, int position, int span, bool upsideDown = false)
Qt::Alignment visualAlignment(Qt::LayoutDirection direction, Qt::Alignment alignment)
QPoint visualPos(Qt::LayoutDirection direction, const QRect &boundingRectangle, const QPoint &logicalPosition)
QRect visualRect(Qt::LayoutDirection direction, const QRect &boundingRectangle, const QRect &logicalRectangle)

Descripción detallada

Qt contiene un conjunto de implementaciones de QStyle que se adaptan al aspecto de las plataformas que admite. Los estilos « windows » y « fusion » están integrados en el módulo « Qt Widgets ». Los estilos de plataforma son complementos de estilo: « windows11 », que sigue el diseño Fluent de Windows 11, y « windowsvista » en Windows, « macos » en macOS y « android » en Android. « QStyleFactory » enumera los estilos disponibles en tiempo de ejecución y los crea por su nombre.

Los widgets integrados de Qt utilizan QStyle para realizar casi todo su dibujo, lo que garantiza que tengan exactamente el mismo aspecto que los widgets nativos equivalentes. Las siguientes imágenes muestran el mismo formulario en los estilos « windows11 », « windowsvista » y « windows » en Windows, y en los estilos « fusion » y « macos ».

Formulario con campo de texto, cuadro combinado, cuadro giratorio, control deslizante, casilla de selección, barra de progreso y botones al estilo de Windows 11

Windows 11

Formulario con campo de texto, cuadro combinado, cuadro giratorio, control deslizante, casilla de selección, barra de progreso y botones al estilo de Windows Vista

Windows Vista

Formulario con campo de texto, cuadro combinado, cuadro giratorio, control deslizante, casilla de selección, barra de progreso y botones al estilo de Windows

Windows

Formulario con campo de texto, cuadro combinado, cuadro giratorio, control deslizante, casilla de selección, barra de progreso y botones con el estilo «Fusion»

Fusion

Formulario con campo de texto, cuadro combinado, cuadro giratorio, control deslizante, casilla de selección, barra de progreso y botones, con el estilo «Fusion» y una paleta de colores oscuros

Fusion con una paleta oscura

Formulario con campo de texto, cuadro combinado, cuadro giratorio, control deslizante, casilla de selección, barra de progreso y botones al estilo de macOS

macOS

Configuración del estilo

El estilo de toda la aplicación se puede configurar mediante la función QApplication::setStyle(). El usuario de la aplicación también puede especificarlo utilizando la opción de línea de comandos -style:

./myapplication -style windows

Si no se especifica ningún estilo, Qt elegirá el más adecuado para la plataforma o el entorno de escritorio del usuario.

También se puede establecer un estilo en un widget concreto mediante la función ` QWidget::setStyle()`.

Elección de un enfoque de estilo

Elige el mecanismo que mejor se adapte al grado de modificación que desees:

  • Para ajustar el estilo de la plataforma, crea una subclase de ` QProxyStyle`.
  • Para implementar un aspecto totalmente personalizado, crea una subclase de ` QCommonStyle`.
  • Para describir el diseño de forma declarativa y compartirlo con los controles de Qt Quick, utiliza StyleKit y su QStyleKitStyle.

En«Enfoques de estilo para Qt Widgets » se comparan estas opciones con las hojas de estilo de Qt y se explica cuándo es adecuado utilizar cada una de ellas.

Desarrollo de widgets personalizados con estilo

Si estás desarrollando widgets personalizados y quieres que tengan un buen aspecto en todas las plataformas, puedes utilizar las funciones de QStyle para realizar partes del dibujo del widget, como drawItemText(), drawItemPixmap(), drawPrimitive(), drawControl() y drawComplexControl().

La mayoría de las funciones de dibujo de QStyle admiten cuatro argumentos:

  • un valor de enumeración que especifica qué elemento gráfico se va a dibujar
  • un ` QStyleOption ` que especifica cómo y dónde renderizar ese elemento
  • un « QPainter » que se debe utilizar para dibujar el elemento
  • un ` QWidget ` sobre el que se realiza el dibujo (opcional)

Por ejemplo, si quieres dibujar un rectángulo de foco en tu widget, puedes escribir:

void MyWidget::paintEvent(QPaintEvent * /* event */)
{
    QPainter painter(this);

    QStyleOptionFocusRect option;
    option.initFrom(this);
    option.backgroundColor = palette().color(QPalette::Window);

    style()->drawPrimitive(QStyle::PE_FrameFocusRect, &option, &painter, this);
}

QStyle obtiene toda la información que necesita para renderizar el elemento gráfico a partir de ` QStyleOption`. El widget se pasa como último argumento por si el estilo lo necesita para realizar efectos especiales (como los botones animados predeterminados en macOS), pero no es obligatorio. De hecho, puedes utilizar QStyle para dibujar en cualquier dispositivo de pintura, no solo en widgets, configurando correctamente el ` QPainter `.

QStyleOption PE_FrameFocusRect cuenta con varias subclases para los distintos tipos de elementos gráficos que se pueden dibujar. Por ejemplo, espera un argumento . QStyleOptionFocusRect

Para garantizar que las operaciones de dibujo sean lo más rápidas posible, QStyleOption y sus subclases tienen miembros de datos públicos. Consulte la documentación de la clase QStyleOption para obtener más detalles sobre cómo utilizarla.

Para mayor comodidad, Qt proporciona la clase ` QStylePainter `, que combina un `QStyle`, un ` QPainter` y un ` QWidget`. Esto permite escribir

    QStylePainter painter(this);
    ...
painter.drawPrimitive(QStyle::PE_FrameFocusRect, option);

en lugar de

QPainter painter(this);
    ...
style()->drawPrimitive(QStyle::PE_FrameFocusRect, &option, &painter, this);

Creación de un estilo personalizado

Puedes crear una apariencia personalizada para tu aplicación creando un estilo propio. Hay dos formas de hacerlo. Para modificar aspectos concretos de un estilo existente, crea una subclase de ` QProxyStyle ` y reimplementa las funciones virtuales que dibujan o miden los elementos que deseas cambiar; el proxy reenvía todo lo demás al estilo que envuelve, que por defecto es el estilo de la plataforma. Para implementar una apariencia completa, crea una subclase de ` QCommonStyle`, que implementa el comportamiento que comparten todos los estilos de Qt y te deja a ti la tarea de dibujar los elementos. Los estilos integrados de Qt no forman parte de la API pública y no pueden servir como clases base; en su lugar, envuélvelos con ` QProxyStyle `.

Dependiendo de qué partes del estilo base desee modificar, deberá reimplementar las funciones que se utilizan para dibujar esas partes de la interfaz. Para ilustrarlo, modificaremos el aspecto de las flechas del cuadro de selección dibujadas por el estilo de la plataforma. Las flechas son elementos primitivos que se dibujan mediante la función drawPrimitive(), por lo que debemos reimplementar dicha función. Necesitamos la siguiente declaración de clase:

class CustomStyle : public QProxyStyle
{
    Q_OBJECT

public:
    explicit CustomStyle(const QWidget *widget = nullptr);
    ~CustomStyle() {}

    void drawPrimitive(PrimitiveElement element, const QStyleOption *option,
                       QPainter *painter, const QWidget *widget) const override;
};

Para dibujar sus flechas de arriba y abajo, ` QSpinBox ` utiliza los elementos primitivos ` PE_IndicatorSpinUp ` y ` PE_IndicatorSpinDown `. A continuación se muestra cómo reimplementar la función ` drawPrimitive()` para dibujarlas de forma diferente:

void CustomStyle::drawPrimitive(PrimitiveElement element, const QStyleOption *option,
                                QPainter *painter, const QWidget *widget) const
{
    if (element == PE_IndicatorSpinUp || element == PE_IndicatorSpinDown) {
        QPolygon points(3);
        int x = option->rect.x();
        int y = option->rect.y();
        int w = option->rect.width() / 2;
        int h = option->rect.height() / 2;
        x += (option->rect.width() - w) / 2;
        y += (option->rect.height() - h) / 2;

        if (element == PE_IndicatorSpinUp) {
            points[0] = QPoint(x, y + h);
            points[1] = QPoint(x + w, y + h);
            points[2] = QPoint(x + w / 2, y);
        } else { // PE_SpinBoxDown
            points[0] = QPoint(x, y);
            points[1] = QPoint(x + w, y);
            points[2] = QPoint(x + w / 2, y + h);
        }

        if (option->state & State_Enabled) {
            painter->setPen(option->palette.mid().color());
            painter->setBrush(option->palette.buttonText());
        } else {
            painter->setPen(option->palette.buttonText().color());
            painter->setBrush(option->palette.mid());
        }
        painter->drawPolygon(points);
    } else {
        QProxyStyle::drawPrimitive(element, option, painter, widget);
    }
}

Fíjate en que no utilizamos el argumento ` widget `, salvo para pasárselo a la función ` QProxyStyle::drawPrimitive()`. Como se ha mencionado anteriormente, la información sobre qué se va a dibujar y cómo debe dibujarse viene especificada por un objeto ` QStyleOption `, por lo que no es necesario preguntárselo al widget.

Si necesitas utilizar el argumento widget para obtener información adicional, asegúrate de que no sea 0 y de que sea del tipo correcto antes de utilizarlo. Por ejemplo:

const QSpinBox *spinBox = qobject_cast<const QSpinBox *>(widget);
if (spinBox) {
    //...
}

Al implementar un estilo personalizado, no se puede dar por sentado que el widget sea un ` QSpinBox ` solo porque el valor de la enumeración se denomine « PE_IndicatorSpinUp » o « PE_IndicatorSpinDown ».

Uso de un estilo personalizado

Hay varias formas de utilizar un estilo personalizado en una aplicación Qt. La forma más sencilla es pasar el estilo personalizado a la función estática ` QApplication::setStyle()` antes de crear el objeto ` QApplication `:

#include <QtWidgets>

#include "customstyle.h"

int main(int argc, char *argv[])
{
    QApplication::setStyle(new CustomStyle);
    QApplication app(argc, argv);
    QSpinBox spinBox;
    spinBox.show();
    return app.exec();
}

Puedes llamar a QApplication::setStyle() en cualquier momento, pero al hacerlo antes del constructor, te aseguras de que se respete la preferencia del usuario, establecida mediante la opción de línea de comandos -style.

Es posible que desees que tu estilo personalizado esté disponible para su uso en otras aplicaciones, que quizá no sean tuyas y, por lo tanto, no puedas recompilar. El sistema de complementos de Qt permite crear estilos como complementos. Los estilos creados como complementos son cargados como objetos compartidos en tiempo de ejecución por el propio Qt. Consulta la documentación de Qt Plugin para obtener más información sobre cómo crear un complemento de estilo.

Compila tu complemento y colócalo en el directorio « plugins/styles » de Qt. Ahora disponemos de un estilo acoplable que Qt puede cargar automáticamente. Para utilizar tu nuevo estilo con aplicaciones existentes, basta con iniciar la aplicación con el siguiente argumento:

./myapplication -style custom

La aplicación utilizará el aspecto y la sensación del estilo personalizado que has implementado.

Escritorios de lectura de derecha a izquierda

Los idiomas que se escriben de derecha a izquierda (como el árabe y el hebreo) suelen reflejar también todo el diseño de los widgets y requieren que la luz provenga de la esquina superior derecha de la pantalla en lugar de la superior izquierda.

Si creas un estilo personalizado, debes prestar especial atención al dibujar elementos asimétricos para asegurarte de que también se vean correctamente en un diseño invertido. Una forma sencilla de probar tus estilos es ejecutar las aplicaciones con la opción de línea de comandos ` -reverse ` o llamar a ` QApplication::setLayoutDirection()` en tu función ` main() `.

A continuación se indican algunos aspectos que debes tener en cuenta para que un estilo funcione correctamente en un entorno de escritura de derecha a izquierda:

  • subControlRect() y subElementRect() devuelven rectángulos en coordenadas de pantalla
  • QStyleOption::direction indica en qué dirección debe dibujarse el elemento
  • Si un estilo no tiene en cuenta la orientación de derecha a izquierda, mostrará los elementos como si fuera de izquierda a derecha
  • visualRect(), visualPos() y visualAlignment() son funciones útiles que convierten las representaciones lógicas en representaciones en pantalla.
  • alignedRect() devolverá un rectángulo lógico alineado con la dirección actual

Estilos en las vistas de elementos

El dibujo de los elementos en las vistas lo realiza un delegado. El delegado predeterminado de Qt, ` QStyledItemDelegate`, también se utiliza para calcular los rectángulos delimitadores de los elementos y de sus subelementos para los distintos tipos de elementos que admite ` data roles ` ` QStyledItemDelegate `. Consulta la descripción de la clase QStyledItemDelegate para saber qué tipos de datos y roles son compatibles. Puedes obtener más información sobre los roles de datos de los elementos en Programación de modelo/vista.

Cuando QStyledItemDelegate dibuja sus elementos, traza CE_ItemViewItem y calcula su tamaño con CT_ItemViewItem. Ten en cuenta también que utiliza SE_ItemViewItemText para establecer el tamaño de los editores. Al implementar un estilo para personalizar el dibujo de las vistas de los elementos, es necesario comprobar la implementación de QCommonStyle (y cualquier otra subclase de la que herede tu estilo). De esta forma, descubrirás qué elementos de estilo se dibujan y cómo, y podrás reimplementar el dibujo de aquellos elementos que deban dibujarse de forma diferente.

Incluimos un pequeño ejemplo en el que personalizamos el dibujo de los fondos de los elementos.

switch (element) {
    case (PE_PanelItemViewItem): {
        painter->save();

        QPoint topLeft = option->rect.topLeft();
        QPoint bottomRight = option->rect.topRight();
        QLinearGradient backgroundGradient(topLeft, bottomRight);
        backgroundGradient.setColorAt(0.0, QColor(Qt::yellow).lighter(190));
        backgroundGradient.setColorAt(1.0, Qt::white);
        painter->fillRect(option->rect, QBrush(backgroundGradient));

        painter->restore();
    break;
    }
    default:
        QProxyStyle::drawPrimitive(element, option, painter, widget);
}

El elemento primitivo ` PE_PanelItemViewItem ` se encarga de dibujar el fondo de los elementos y se invoca desde la implementación de ` CE_ItemViewItem` realizada por ` QCommonStyle`.

Para añadir compatibilidad con el dibujo de nuevos tipos de datos y funciones de datos de elementos, es necesario crear un delegado personalizado. Sin embargo, si solo necesitas dar soporte a los tipos de datos implementados por el delegado predeterminado, un estilo personalizado no necesita ir acompañado de un delegado. La descripción de la clase ` QStyledItemDelegate ` ofrece más información sobre los delegados personalizados.

El dibujo de los encabezados de la vista de elementos también lo realiza el estilo, lo que permite controlar el tamaño de los elementos del encabezado y el de las filas y columnas.

Véase también QStyleOption, QStylePainter, «Estilos y widgets sensibles al estilo», «Enfoques de estilo para Qt Widgets », QStyledItemDelegate y «Estilo».

Documentación sobre tipos de miembros

enum QStyle::ComplexControl

Esta enumeración describe los controles complejos disponibles. Los controles complejos tienen un comportamiento diferente según el lugar en el que el usuario haga clic sobre ellos o las teclas que pulse.

ConstanteValorDescripción
QStyle::CC_SpinBox0Un cuadro de selección, como QSpinBox.
QStyle::CC_ComboBox1Un cuadro combinado, como QComboBox.
QStyle::CC_ScrollBar2Una barra de desplazamiento, como QScrollBar.
QStyle::CC_Slider3Un control deslizante, como QSlider.
QStyle::CC_ToolButton4Un botón de herramienta, como el de QToolButton.
QStyle::CC_TitleBar5Una barra de título, como las que se utilizan en QMdiSubWindow.
QStyle::CC_GroupBox7Un cuadro de grupo, como el de QGroupBox.
QStyle::CC_Dial6Un dial, como QDial.
QStyle::CC_MdiControls8Los botones de minimizar, cerrar y estado normal en la barra de menús de una subventana MDI maximizada.
QStyle::CC_CustomBase0xf0000000Valor base para controles complejos personalizados. Los valores personalizados deben ser mayores que este valor.

Véase también SubControl y drawComplexControl().

enum QStyle::ContentsType

Esta enumeración describe los tipos de contenido disponibles. Se utilizan para calcular los tamaños del contenido de diversos widgets.

ConstanteValorDescripción
QStyle::CT_CheckBox1Una casilla de selección, como QCheckBox.
QStyle::CT_ComboBox4Un cuadro combinado, como QComboBox.
QStyle::CT_HeaderSection19Una sección de encabezado, como QHeader.
QStyle::CT_LineEdit14Un campo de edición de línea, como QLineEdit.
QStyle::CT_Menu10Un menú, como QMenu.
QStyle::CT_MenuBar9Una barra de menús, como QMenuBar.
QStyle::CT_MenuBarItem8Un elemento de barra de menús, como los botones de un QMenuBar.
QStyle::CT_MenuItem7Un elemento de menú, como QMenuItem.
QStyle::CT_ProgressBar6Una barra de progreso, como QProgressBar.
QStyle::CT_PushButton0Un botón pulsador, como QPushButton.
QStyle::CT_RadioButton2Un botón de opción, como QRadioButton.
QStyle::CT_SizeGrip16Un control de tamaño, como QSizeGrip.
QStyle::CT_Slider12Un control deslizante, como QSlider.
QStyle::CT_ScrollBar13Una barra de desplazamiento, como QScrollBar.
QStyle::CT_SpinBox15Un cuadro giratorio, como QSpinBox.
QStyle::CT_Splitter5Un separador, como QSplitter.
QStyle::CT_TabBarTab11Una pestaña en una barra de pestañas, como QTabBar.
QStyle::CT_TabWidget17Un widget de pestaña, como QTabWidget.
QStyle::CT_ToolButton3Un botón de herramienta, como QToolButton.
QStyle::CT_GroupBox20Un cuadro de grupo, como QGroupBox.
QStyle::CT_ItemViewItem22Un elemento dentro de una vista de elementos.
QStyle::CT_CustomBase0xf0000000Valor base para tipos de contenido personalizados. Los valores personalizados deben ser mayores que este valor.
QStyle::CT_MdiControls21Los botones de minimizar, normal y cerrar de la barra de menús de una subventana MDI maximizada.

Véase también sizeFromContents().

enum QStyle::ControlElement

Esta enumeración representa un elemento de control. Un elemento de control es una parte de un widget que realiza alguna acción o muestra información al usuario.

ConstanteValorDescripción
QStyle::CE_PushButton0Un « QPushButton » dibuja CE_PushButtonBevel, CE_PushButtonLabel y PE_FrameFocusRect.
QStyle::CE_PushButtonBevel1El bisel y el indicador predeterminado de un « QPushButton ».
QStyle::CE_PushButtonLabel2La etiqueta (un icono con texto o un mapa de píxeles) de un « QPushButton ».
QStyle::CE_DockWidgetTitle30Título de la ventana de acoplamiento.
QStyle::CE_Splitter28Controlador del separador; véase también QSplitter.
QStyle::CE_CheckBox3Un ` QCheckBox` dibuja un ` PE_IndicatorCheckBox`, un `CE_CheckBoxLabel` y un ` PE_FrameFocusRect`.
QStyle::CE_CheckBoxLabel4La etiqueta (texto o mapa de píxeles) de un ` QCheckBox`.
QStyle::CE_RadioButton5Un ` QRadioButton` dibuja un ` PE_IndicatorRadioButton`, un `CE_RadioButtonLabel` y un ` PE_FrameFocusRect`.
QStyle::CE_RadioButtonLabel6La etiqueta (texto o mapa de píxeles) de un QRadioButton.
QStyle::CE_TabBarTab7La pestaña y la etiqueta dentro de un « QTabBar ».
QStyle::CE_TabBarTabShape8La forma de la pestaña dentro de una barra de pestañas.
QStyle::CE_TabBarTabLabel9La etiqueta dentro de una pestaña.
QStyle::CE_ProgressBar10Un ` QProgressBar` dibuja `CE_ProgressBarGroove`, `CE_ProgressBarContents` y `CE_ProgressBarLabel`.
QStyle::CE_ProgressBarGroove11La ranura en la que se dibuja el indicador de progreso en una barra de progreso ( QProgressBar).
QStyle::CE_ProgressBarContents12El indicador de progreso de un QProgressBar.
QStyle::CE_ProgressBarLabel13La etiqueta de texto de un « QProgressBar ».
QStyle::CE_ToolButtonLabel22La etiqueta de un botón de herramienta.
QStyle::CE_MenuBarItem20Un elemento de menú de un QMenuBar.
QStyle::CE_MenuBarEmptyArea21El área vacía de un « QMenuBar ».
QStyle::CE_MenuItem14Un elemento de menú en un QMenu.
QStyle::CE_MenuScroller15Áreas de desplazamiento en un « QMenu » cuando el estilo admite el desplazamiento.
QStyle::CE_MenuTearoff18Un elemento de menú que representa la sección desprendible de un « QMenu ».
QStyle::CE_MenuEmptyArea19El área de un menú que no contiene elementos de menú.
QStyle::CE_MenuHMargin17El espacio adicional horizontal a la izquierda o a la derecha de un menú.
QStyle::CE_MenuVMargin16El espacio adicional vertical en la parte superior o inferior de un menú.
QStyle::CE_ToolBoxTab26La pestaña y la etiqueta de la caja de herramientas dentro de un « QToolBox ».
QStyle::CE_SizeGrip27Controlador de redimensionamiento de ventana; véase también « QSizeGrip ».
QStyle::CE_Header23Un encabezado.
QStyle::CE_HeaderSection24Una sección de encabezado.
QStyle::CE_HeaderLabel25La etiqueta del encabezado.
QStyle::CE_ScrollBarAddLine31Indicador de aumento de la línea de la barra de desplazamiento. (es decir, desplazarse hacia abajo); véase también QScrollBar.
QStyle::CE_ScrollBarSubLine32Indicador de disminución de la barra de desplazamiento (es decir, desplazamiento hacia arriba).
QStyle::CE_ScrollBarAddPage33Indicador de avance de página de la barra de desplazamiento (es decir, «página abajo»).
QStyle::CE_ScrollBarSubPage34Indicador de disminución de página de la barra de desplazamiento (es decir, «página arriba»).
QStyle::CE_ScrollBarSlider35Control deslizante de la barra de desplazamiento.
QStyle::CE_ScrollBarFirst36Indicador de la primera línea de la barra de desplazamiento (es decir, inicio).
QStyle::CE_ScrollBarLast37Indicador de la última línea de la barra de desplazamiento (es decir, fin).
QStyle::CE_RubberBand29Banda elástica utilizada, por ejemplo, en una vista de iconos.
QStyle::CE_FocusFrame38Marco de enfoque cuyo estilo se puede controlar.
QStyle::CE_ItemViewItem45Un elemento dentro de una vista de elementos.
QStyle::CE_CustomBase0xf0000000Valor base para elementos de control personalizados; los valores personalizados deben ser mayores que este valor.
QStyle::CE_ComboBoxLabel39La etiqueta de un « QComboBox » no editable.
QStyle::CE_ToolBar40Una barra de herramientas similar a QToolBar.
QStyle::CE_ToolBoxTabShape41La forma de la pestaña del cuadro de herramientas.
QStyle::CE_ToolBoxTabLabel42La etiqueta de la pestaña de la caja de herramientas.
QStyle::CE_HeaderEmptyArea43El área de una vista de encabezado donde no hay secciones de encabezado.
QStyle::CE_ShapedFrame46El marco con la forma especificada en QStyleOptionFrame; véase QFrame.

Véase también drawControl().

enum QStyle::PixelMetric

Esta enumeración describe las distintas métricas de píxeles disponibles. Una métrica de píxeles es un tamaño que depende del estilo y que se representa mediante un único valor de píxel.

ConstanteValorDescripción
QStyle::PM_ButtonMargin0Espacio en blanco entre las etiquetas de los botones y el marco.
QStyle::PM_DockWidgetTitleBarButtonMargin73Espacio en blanco entre las etiquetas de los botones de la barra de título del widget acoplado y el marco.
QStyle::PM_ButtonDefaultIndicator1Ancho del marco del indicador del botón predeterminado.
QStyle::PM_MenuButtonIndicator2Ancho del indicador del botón de menú, proporcional a la altura del widget.
QStyle::PM_ButtonShiftHorizontal3Desplazamiento horizontal del contenido de un botón cuando este está pulsado.
QStyle::PM_ButtonShiftVertical4Desplazamiento vertical del contenido de un botón cuando está pulsado.
QStyle::PM_DefaultFrameWidth5Ancho predeterminado del marco (normalmente 2).
QStyle::PM_SpinBoxFrameWidth6Ancho del marco de un cuadro giratorio; el valor por defecto es PM_DefaultFrameWidth.
QStyle::PM_ComboBoxFrameWidth7Ancho del marco de un cuadro combinado; el valor por defecto es PM_DefaultFrameWidth.
QStyle::PM_MdiSubWindowFrameWidth44Ancho del marco de una ventana MDI.
QStyle::PM_MdiSubWindowMinimizedWidth45Ancho de una ventana MDI minimizada.
QStyle::PM_LayoutLeftMargin75left margin por defecto para un QLayout.
QStyle::PM_LayoutTopMargin76top margin por defecto para un QLayout.
QStyle::PM_LayoutRightMargin77right margin por defecto para un QLayout.
QStyle::PM_LayoutBottomMargin78bottom margin predeterminado para un QLayout.
QStyle::PM_LayoutHorizontalSpacing79horizontal spacing predeterminado para un QLayout.
QStyle::PM_LayoutVerticalSpacing80vertical spacing por defecto para un QLayout.
QStyle::PM_MaximumDragDistance8Distancia máxima permitida entre el ratón y una barra de desplazamiento al arrastrar. Si se supera la distancia especificada, el control deslizante volverá a la posición original; un valor de -1 desactiva este comportamiento.
QStyle::PM_ScrollBarExtent9Ancho de una barra de desplazamiento vertical y altura de una barra de desplazamiento horizontal.
QStyle::PM_ScrollBarSliderMin10La altura mínima del control deslizante de una barra de desplazamiento vertical y el ancho mínimo del control deslizante de una barra de desplazamiento horizontal.
QStyle::PM_SliderThickness11Grosor total del control deslizante.
QStyle::PM_SliderControlThickness12Grosor del controlador de la barra de desplazamiento.
QStyle::PM_SliderLength13Longitud del control deslizante.
QStyle::PM_SliderTickmarkOffset14El desplazamiento entre las marcas de graduación y el control deslizante.
QStyle::PM_SliderSpaceAvailable15El espacio disponible para que se desplace el control deslizante.
QStyle::PM_DockWidgetSeparatorExtent16Ancho de un separador en una ventana acoplada horizontal y altura de un separador en una ventana acoplada vertical.
QStyle::PM_DockWidgetHandleExtent17Ancho del controlador en una ventana acoplada horizontal y altura del controlador en una ventana acoplada vertical.
QStyle::PM_DockWidgetFrameWidth18Ancho del marco de una ventana acoplada.
QStyle::PM_DockWidgetTitleMargin70El margen del título de la ventana acoplada.
QStyle::PM_MenuBarPanelWidth33Ancho del marco de una barra de menús; el valor por defecto es PM_DefaultFrameWidth.
QStyle::PM_MenuBarItemSpacing34Espaciado entre los elementos de la barra de menús.
QStyle::PM_MenuBarHMargin36Espaciado entre los elementos de la barra de menús y a la izquierda y a la derecha de la barra.
QStyle::PM_MenuBarVMargin35Espaciado entre los elementos de la barra de menús y la parte superior e inferior de la barra.
QStyle::PM_ToolBarFrameWidth52Ancho del marco que rodea las barras de herramientas.
QStyle::PM_ToolBarHandleExtent53Ancho del controlador de una barra de herramientas horizontal y altura del controlador en una barra de herramientas vertical.
QStyle::PM_ToolBarItemMargin55Espaciado entre el marco de la barra de herramientas y los elementos.
QStyle::PM_ToolBarItemSpacing54Espaciado entre los elementos de la barra de herramientas.
QStyle::PM_ToolBarSeparatorExtent56Ancho de un separador de barra de herramientas en una barra de herramientas horizontal y altura de un separador en una barra de herramientas vertical.
QStyle::PM_ToolBarExtensionExtent57Ancho de un botón de extensión de la barra de herramientas en una barra horizontal y altura del botón en una barra vertical.
QStyle::PM_TabBarTabOverlap19Número de píxeles en los que deben solaparse las pestañas. (Actualmente solo se utiliza en estilos, no dentro de QTabBar)
QStyle::PM_TabBarTabHSpace20Espacio adicional añadido al ancho de la pestaña.
QStyle::PM_TabBarTabVSpace21Espacio adicional añadido a la altura de la pestaña.
QStyle::PM_TabBarBaseHeight22Altura del área entre la barra de pestañas y las páginas de las pestañas.
QStyle::PM_TabBarBaseOverlap23Número de píxeles en los que la barra de pestañas se superpone a la base de la barra de pestañas.
QStyle::PM_TabBarScrollButtonWidth51 
QStyle::PM_TabBarTabShiftHorizontal49Desplazamiento horizontal en píxeles al seleccionar una pestaña.
QStyle::PM_TabBarTabShiftVertical50Desplazamiento vertical en píxeles al seleccionar una pestaña.
QStyle::PM_ProgressBarChunkWidth24Ancho de un segmento en un indicador de barra de progreso.
QStyle::PM_SplitterWidth25Ancho de un separador.
QStyle::PM_TitleBarHeight26Altura de la barra de título.
QStyle::PM_IndicatorWidth37Ancho de un indicador de casilla de selección.
QStyle::PM_IndicatorHeight38Altura del indicador de casilla de selección.
QStyle::PM_ExclusiveIndicatorWidth39Ancho de un indicador de botón de opción.
QStyle::PM_ExclusiveIndicatorHeight40Altura del indicador de un botón de opción.
QStyle::PM_MenuPanelWidth30Ancho del borde (aplicado a todos los lados) de un « QMenu ».
QStyle::PM_MenuHMargin28Borde adicional (utilizado a la izquierda y a la derecha) para un « QMenu ».
QStyle::PM_MenuVMargin29Borde adicional (utilizado en la parte inferior y superior) para un « QMenu ».
QStyle::PM_MenuScrollerHeight27Altura del área de desplazamiento en un « QMenu ».
QStyle::PM_MenuTearoffHeight31Altura de un área desprendible en un QMenu.
QStyle::PM_MenuDesktopFrameWidth32Ancho del marco del menú en el escritorio.
QStyle::PM_HeaderMarkSize47El tamaño del indicador de ordenación en un encabezado.
QStyle::PM_HeaderGripMargin48El tamaño del controlador de redimensionamiento en una cabecera.
QStyle::PM_HeaderMargin46El tamaño del margen entre el indicador de ordenación y el texto.
QStyle::PM_SpinBoxSliderHeight58La altura del control deslizante opcional del cuadro giratorio.
QStyle::PM_ToolBarIconSize59Tamaño predeterminado de los iconos de la barra de herramientas
QStyle::PM_SmallIconSize62Tamaño predeterminado de los iconos pequeños
QStyle::PM_LargeIconSize63Tamaño predeterminado de los iconos grandes
QStyle::PM_FocusFrameHMargin65Margen horizontal por el que el marco de foco sobresaldrá del widget.
QStyle::PM_FocusFrameVMargin64Margen vertical por el que el marco de selección sobresaldrá del widget.
QStyle::PM_IconViewIconSize61El tamaño predeterminado de los iconos en una vista de iconos.
QStyle::PM_ListViewIconSize60El tamaño predeterminado de los iconos en una vista de lista.
QStyle::PM_ToolTipLabelFrameWidth66Ancho del marco de una etiqueta de información sobre herramientas.
QStyle::PM_CheckBoxLabelSpacing67El espaciado entre el indicador de una casilla de selección y su etiqueta.
QStyle::PM_RadioButtonLabelSpacing74El espaciado entre el indicador de un botón de opción y su etiqueta.
QStyle::PM_TabBarIconSize68El tamaño predeterminado de los iconos de una barra de pestañas.
QStyle::PM_SizeGripSize69El tamaño de un controlador de tamaño.
QStyle::PM_MessageBoxIconSize71El tamaño de los iconos estándar en un cuadro de mensaje
QStyle::PM_ButtonIconSize72El tamaño predeterminado de los iconos de los botones
QStyle::PM_TextCursorWidth82El ancho del cursor en un campo de edición de línea o de texto.
QStyle::PM_TabBar_ScrollButtonOverlap81La distancia entre los botones izquierdo y derecho de una barra de pestañas.
QStyle::PM_TabCloseIndicatorWidth83El ancho predeterminado de un botón de cierre en una pestaña de una barra de pestañas.
QStyle::PM_TabCloseIndicatorHeight84La altura predeterminada del botón de cierre de una pestaña en una barra de pestañas.
QStyle::PM_ScrollView_ScrollBarSpacing85Distancia entre el marco y la barra de desplazamiento cuando se establece « SH_ScrollView_FrameOnlyAroundContents ».
QStyle::PM_ScrollView_ScrollBarOverlap86Superposición entre las barras de desplazamiento y el contenido que se desplaza
QStyle::PM_SubMenuOverlap87La superposición horizontal entre un submenú y su menú principal.
QStyle::PM_TreeViewIndentation (since Qt 5.4)88La sangría de los elementos en una vista de árbol.
QStyle::PM_HeaderDefaultSectionSizeHorizontal89El tamaño predeterminado de las secciones en un encabezado horizontal. Este valor de enumeración se ha introducido en Qt 5.5.
QStyle::PM_HeaderDefaultSectionSizeVertical90El tamaño por defecto de las secciones en un encabezado vertical. Este valor de enumeración se ha introducido en Qt 5.5.
QStyle::PM_TitleBarButtonIconSize (since Qt 5.8)91El tamaño de los iconos de los botones en una barra de título.
QStyle::PM_TitleBarButtonSize (since Qt 5.8)92El tamaño de los botones en una barra de título.
QStyle::PM_LineEditIconSize (since Qt 6.2)93El tamaño predeterminado de los iconos en un campo de edición de línea.
QStyle::PM_LineEditIconMargin (since Qt 6.3)94El margen alrededor de los iconos en un campo de edición de línea.
QStyle::PM_CustomBase0xf0000000Valor base para las métricas de píxeles personalizadas. Los valores personalizados deben ser superiores a este valor.

Véase también pixelMetric().

enum QStyle::PrimitiveElement

Esta enumeración describe los distintos elementos primitivos. Un elemento primitivo es un elemento habitual de la interfaz gráfica de usuario, como el indicador de una casilla de selección o el bisel de un botón.

ConstanteValorDescripción
QStyle::PE_PanelButtonCommand13Botón utilizado para iniciar una acción; por ejemplo, un « QPushButton ».
QStyle::PE_FrameDefaultButton1Marco que rodea un botón predeterminado, por ejemplo, en un cuadro de diálogo.
QStyle::PE_PanelButtonBevel14Panel genérico con un botón biselado.
QStyle::PE_PanelButtonTool15Panel para un botón de herramienta, utilizado con « QToolButton ».
QStyle::PE_PanelLineEdit18Panel para un « QLineEdit ».
QStyle::PE_IndicatorButtonDropDown24Indicador para un botón desplegable, por ejemplo, un botón de herramienta que muestra un menú.
QStyle::PE_FrameFocusRect3Indicador de foco genérico.
QStyle::PE_IndicatorArrowUp22Flecha arriba genérica.
QStyle::PE_IndicatorArrowDown19Flecha hacia abajo genérica.
QStyle::PE_IndicatorArrowRight21Flecha derecha genérica.
QStyle::PE_IndicatorArrowLeft20Flecha genérica hacia la izquierda.
QStyle::PE_IndicatorSpinUp35Símbolo de «arriba» para un widget giratorio, por ejemplo, un « QSpinBox ».
QStyle::PE_IndicatorSpinDown32Símbolo de «abajo» para un widget giratorio.
QStyle::PE_IndicatorSpinPlus34Símbolo de aumento para un control giratorio.
QStyle::PE_IndicatorSpinMinus33Símbolo de disminución para un control giratorio.
QStyle::PE_IndicatorItemViewItemCheck25Indicador de activado/desactivado para un elemento de vista.
QStyle::PE_IndicatorCheckBox26Indicador de activado/desactivado, por ejemplo, un QCheckBox.
QStyle::PE_IndicatorRadioButton31Indicador exclusivo de activado/desactivado, por ejemplo, un « QRadioButton ».
QStyle::PE_IndicatorDockWidgetResizeHandle27Control de redimensionamiento para ventanas acopladas.
QStyle::PE_Frame0Marco genérico
QStyle::PE_FrameMenu6Marco para ventanas y menús emergentes; véase también « QMenu ».
QStyle::PE_PanelMenuBar16Panel para barras de menú.
QStyle::PE_PanelScrollAreaCorner40Panel situado en la esquina inferior derecha (o inferior izquierda) de un área de desplazamiento.
QStyle::PE_FrameDockWidget2Marco de panel para ventanas acopladas y barras de herramientas.
QStyle::PE_FrameTabWidget8Marco para widgets de pestañas.
QStyle::PE_FrameLineEdit5Marco de panel para campos de edición de línea.
QStyle::PE_FrameGroupBox4Marco de panel alrededor de cuadros de grupo.
QStyle::PE_FrameButtonBevel10Marco de panel para el bisel de un botón.
QStyle::PE_FrameButtonTool11Marco de panel para un botón de herramienta.
QStyle::PE_IndicatorHeaderArrow28Flecha utilizada para indicar la ordenación en el encabezado de una lista o tabla.
QStyle::PE_FrameStatusBarItem7Marco para un elemento de la barra de estado; véase también QStatusBar.
QStyle::PE_FrameWindow9Marco alrededor de una ventana MDI o una ventana acoplable.
QStyle::PE_IndicatorMenuCheckMark29Marca de verificación utilizada en un menú.
QStyle::PE_IndicatorProgressChunk30Sección de un indicador de barra de progreso; véase también QProgressBar.
QStyle::PE_IndicatorBranch23Líneas que representan las ramas de un árbol en una vista de árbol.
QStyle::PE_IndicatorToolBarHandle36El controlador de una barra de herramientas.
QStyle::PE_IndicatorToolBarSeparator37El separador de una barra de herramientas.
QStyle::PE_PanelToolBar17El panel de una barra de herramientas.
QStyle::PE_PanelTipLabel38El panel de una etiqueta de sugerencia.
QStyle::PE_FrameTabBarBase12El marco que se dibuja para una barra de pestañas, normalmente para una barra de pestañas que no forma parte de un control de pestañas.
QStyle::PE_IndicatorTabTear39Obsoleto. Utiliza PE_IndicatorTabTearLeft en su lugar.
QStyle::PE_IndicatorTabTearLeftPE_IndicatorTabTearUn indicador de que una pestaña está parcialmente desplazada hacia fuera por el lado izquierdo de la barra de pestañas visible cuando hay muchas pestañas.
QStyle::PE_IndicatorTabTearRight49Un indicador que muestra que una pestaña está parcialmente desplazada hacia fuera por el lado derecho de la barra de pestañas visible cuando hay muchas pestañas.
QStyle::PE_IndicatorColumnViewArrow42Una flecha en un QColumnView.
QStyle::PE_Widget41Un « QWidget » sin formato.
QStyle::PE_CustomBase0xf000000Valor base para elementos primitivos personalizados. Todos los valores superiores a este están reservados para uso personalizado. Los valores personalizados deben ser mayores que este valor.
QStyle::PE_IndicatorItemViewItemDrop43Un indicador que se dibuja para mostrar dónde se va a soltar un elemento de una vista de elementos durante una operación de arrastrar y soltar en dicha vista.
QStyle::PE_PanelItemViewItem44El fondo de un elemento en una vista de elementos.
QStyle::PE_PanelItemViewRow45El fondo de una fila en una vista de elementos.
QStyle::PE_PanelStatusBar46El panel de una barra de estado.
QStyle::PE_IndicatorTabClose47El botón de cierre de una barra de pestañas.
QStyle::PE_PanelMenu48El panel de un menú.

Véase también drawPrimitive().

enum QStyle::RequestSoftwareInputPanel

Esta enumeración describe en qué circunstancias los widgets con capacidad de entrada solicitarán un panel de entrada de software.

ConstanteValorDescripción
QStyle::RSIP_OnMouseClickAndAlreadyFocused0Solicita un panel de entrada si el usuario hace clic en el widget, pero solo si este ya tiene el foco.
QStyle::RSIP_OnMouseClick1Solicita un panel de entrada si el usuario hace clic en el widget.

Véase también QInputMethod.

enum QStyle::StandardPixmap

Esta enumeración describe los mapas de píxeles estándar disponibles. Un mapa de píxeles estándar es aquel que se ajusta a algún estilo o directriz de interfaz gráfica de usuario (GUI) ya existente.

ConstanteValorDescripción
QStyle::SP_TitleBarMinButton1Botón de minimizar en las barras de título (por ejemplo, en QMdiSubWindow).
QStyle::SP_TitleBarMenuButton0Botón de menú en una barra de título.
QStyle::SP_TitleBarMaxButton2Botón de maximizar en las barras de título.
QStyle::SP_TitleBarCloseButton3Botón de cierre en las barras de título.
QStyle::SP_TitleBarNormalButton4Botón «Normal» (restaurar) en las barras de título.
QStyle::SP_TitleBarShadeButton5Botón de oscurecer en las barras de título.
QStyle::SP_TitleBarUnshadeButton6Botón «Desocultar» en las barras de título.
QStyle::SP_TitleBarContextHelpButton7El botón de ayuda contextual en las barras de título.
QStyle::SP_MessageBoxInformation9El icono de «información».
QStyle::SP_MessageBoxWarning10El icono de «advertencia».
QStyle::SP_MessageBoxCritical11El icono de «problema grave».
QStyle::SP_MessageBoxQuestion12El icono de «pregunta».
QStyle::SP_DesktopIcon13El icono de «escritorio».
QStyle::SP_TrashIcon14El icono de la «papelera».
QStyle::SP_ComputerIcon15El icono «Mi PC».
QStyle::SP_DriveFDIcon16El icono del disquete.
QStyle::SP_DriveHDIcon17El icono del disco duro.
QStyle::SP_DriveCDIcon18El icono del CD.
QStyle::SP_DriveDVDIcon19El icono del DVD.
QStyle::SP_DriveNetIcon20El icono de red.
QStyle::SP_DirHomeIcon56El icono del directorio de inicio.
QStyle::SP_DirOpenIcon21El icono del directorio abierto.
QStyle::SP_DirClosedIcon22El icono del directorio cerrado.
QStyle::SP_DirIcon38El icono del directorio.
QStyle::SP_DirLinkIcon23El icono de enlace a un directorio.
QStyle::SP_DirLinkOpenIcon24El icono de enlace a un directorio abierto.
QStyle::SP_FileIcon25El icono de archivo.
QStyle::SP_FileLinkIcon26El icono de enlace a un archivo.
QStyle::SP_FileDialogStart29El icono «Inicio» en un cuadro de diálogo de archivos.
QStyle::SP_FileDialogEnd30El icono de «fin» en un cuadro de diálogo de archivos.
QStyle::SP_FileDialogToParent31El icono de «directorio principal» en un cuadro de diálogo de archivos.
QStyle::SP_FileDialogNewFolder32El icono de «crear nueva carpeta» en un cuadro de diálogo de archivos.
QStyle::SP_FileDialogDetailedView33El icono de vista detallada en un cuadro de diálogo de archivos.
QStyle::SP_FileDialogInfoView34El icono de información del archivo en un cuadro de diálogo de archivos.
QStyle::SP_FileDialogContentsView35El icono de vista de contenido en un cuadro de diálogo de archivos.
QStyle::SP_FileDialogListView36El icono de vista de lista en un cuadro de diálogo de archivos.
QStyle::SP_FileDialogBack37La flecha de retroceso en un cuadro de diálogo de archivos.
QStyle::SP_DockWidgetCloseButton8Botón de cierre en ventanas acopladas (véase también QDockWidget).
QStyle::SP_ToolBarHorizontalExtensionButton27Botón de extensión para las barras de herramientas horizontales.
QStyle::SP_ToolBarVerticalExtensionButton28Botón de extensión para barras de herramientas verticales.
QStyle::SP_DialogOkButton39Icono del botón «Aceptar» estándar en un QDialogButtonBox.
QStyle::SP_DialogCancelButton40Icono del botón «Cancelar» estándar en un QDialogButtonBox.
QStyle::SP_DialogHelpButton41Icono para un botón «Ayuda» estándar en un QDialogButtonBox.
QStyle::SP_DialogOpenButton42Icono del botón estándar «Abrir» en una ventana « QDialogButtonBox ».
QStyle::SP_DialogSaveButton43Icono de un botón «Guardar» estándar en un « QDialogButtonBox ».
QStyle::SP_DialogCloseButton44Icono del botón «Cerrar» estándar en un QDialogButtonBox.
QStyle::SP_DialogApplyButton45Icono del botón «Aplicar» estándar en un QDialogButtonBox.
QStyle::SP_DialogResetButton46Icono del botón «Restablecer» estándar en QDialogButtonBox.
QStyle::SP_DialogDiscardButton47Icono del botón «Descartar» estándar en un QDialogButtonBox.
QStyle::SP_DialogYesButton48Icono del botón estándar «Sí» en un QDialogButtonBox.
QStyle::SP_DialogNoButton49Icono de un botón «No» estándar en QDialogButtonBox.
QStyle::SP_ArrowUp50Icono de flecha que apunta hacia arriba.
QStyle::SP_ArrowDown51Icono de flecha que apunta hacia abajo.
QStyle::SP_ArrowLeft52Icono de flecha que apunta hacia la izquierda.
QStyle::SP_ArrowRight53Icono de flecha que apunta hacia la derecha.
QStyle::SP_ArrowBack54Equivalente a SP_ArrowLeft cuando la dirección de diseño actual es « Qt::LeftToRight »; en caso contrario, SP_ArrowRight.
QStyle::SP_ArrowForward55Equivalente a SP_ArrowRight cuando la dirección de diseño actual es Qt::LeftToRight; en caso contrario, SP_ArrowLeft.
QStyle::SP_CommandLink57Icono utilizado para indicar un glifo de enlace de comando al estilo de Vista.
QStyle::SP_VistaShield58Icono utilizado para indicar las solicitudes de UAC en Windows Vista. Devolverá un mapa de píxeles nulo o un icono en todas las demás plataformas.
QStyle::SP_BrowserReload59Icono que indica que se debe volver a cargar la página actual.
QStyle::SP_BrowserStop60Icono que indica que debe detenerse la carga de la página.
QStyle::SP_MediaPlay61Icono que indica que debe iniciarse la reproducción del contenido multimedia.
QStyle::SP_MediaStop62Icono que indica que debe detenerse la reproducción del contenido multimedia.
QStyle::SP_MediaPause63Icono que indica que se debe poner en pausa la reproducción del contenido multimedia.
QStyle::SP_MediaSkipForward64Icono que indica que se debe avanzar en el contenido multimedia.
QStyle::SP_MediaSkipBackward65Icono que indica que el contenido multimedia debe retroceder.
QStyle::SP_MediaSeekForward66Icono que indica que el contenido multimedia debe avanzar rápidamente.
QStyle::SP_MediaSeekBackward67Icono que indica que el contenido multimedia debe buscar hacia atrás.
QStyle::SP_MediaVolume68Icono que indica el control de volumen.
QStyle::SP_MediaVolumeMuted69Icono que indica el control de volumen silenciado.
QStyle::SP_LineEditClearButton (since Qt 5.2)70Icono de un botón de borrado estándar en un « QLineEdit ».
QStyle::SP_DialogYesToAllButton (since Qt 5.14)71Icono de un botón estándar «Sí a todos» en un « QDialogButtonBox ».
QStyle::SP_DialogNoToAllButton (since Qt 5.14)72Icono de un botón estándar «No a todo» en un « QDialogButtonBox ».
QStyle::SP_DialogSaveAllButton (since Qt 5.14)73Icono de un botón estándar «Guardar todo» en un « QDialogButtonBox ».
QStyle::SP_DialogAbortButton (since Qt 5.14)74Icono para un botón «Abortar» estándar en una ventana emergente de « QDialogButtonBox ».
QStyle::SP_DialogRetryButton (since Qt 5.14)75Icono para un botón «Reintentar» estándar en un QDialogButtonBox.
QStyle::SP_DialogIgnoreButton (since Qt 5.14)76Icono para un botón «Ignorar» estándar en un QDialogButtonBox.
QStyle::SP_RestoreDefaultsButton (since Qt 5.14)77Icono para un botón estándar «Restablecer valores predeterminados» en un QDialogButtonBox.
QStyle::SP_TabCloseButton (since Qt 6.3)78Icono del botón «Cerrar» en la pestaña de un QTabBar.
QStyle::SP_TabScrollLeftButton (since Qt 6.12)79Icono del botón de desplazamiento hacia la izquierda de un QTabBar.
QStyle::SP_TabScrollRightButton (since Qt 6.12)80Icono para el botón de desplazamiento a la derecha de un « QTabBar ».
QStyle::SP_TabScrollUpButton (since Qt 6.12)81Icono del botón de desplazamiento hacia arriba de un QTabBar.
QStyle::SP_TabScrollDownButton (since Qt 6.12)82Icono del botón de desplazamiento hacia abajo de un « QTabBar ».
QStyle::SP_CustomBase0xf0000000Valor base para los mapas de píxeles estándar personalizados; los valores personalizados deben ser mayores que este valor.

Véase también standardIcon().

enum QStyle::StateFlag
flags QStyle::State

Esta enumeración describe los indicadores que se utilizan al dibujar elementos primitivos.

Ten en cuenta que no todas las primitivas utilizan todos estos indicadores y que estos pueden tener significados distintos según el elemento.

ConstanteValorDescripción
QStyle::State_None0x00000000Indica que el widget no tiene un estado.
QStyle::State_Active0x00010000Indica que el widget está activo.
QStyle::State_AutoRaise0x00001000Se utiliza para indicar si se debe aplicar la apariencia de «auto-raise» a un botón de herramienta.
QStyle::State_Children0x00080000Se utiliza para indicar si una rama de la vista de elementos tiene elementos secundarios.
QStyle::State_DownArrow0x00000040Se utiliza para indicar si debe aparecer una flecha hacia abajo en el widget.
QStyle::State_Editing0x00400000Obsoleto. Ya no se utiliza, ya que el editor se dibuja sobre la celda de la vista de elemento.
QStyle::State_Enabled0x00000001Se utiliza para indicar si el widget está habilitado.
QStyle::State_HasFocus0x00000100Se utiliza para indicar si el widget tiene el foco.
QStyle::State_Horizontal0x00000080Se utiliza para indicar si el widget tiene una disposición horizontal, por ejemplo, una barra de herramientas.
QStyle::State_KeyboardFocusChange0x00800000Se utiliza para indicar si el foco se ha cambiado con el teclado, p. ej., con la tecla Tab, la tecla Backspace o un atajo de teclado.
QStyle::State_MouseOver0x00002000Se utiliza para indicar si el widget se encuentra bajo el cursor del ratón.
QStyle::State_NoChange0x00000010Se utiliza para indicar una casilla de selección de tres estados.
QStyle::State_Off0x00000008Se utiliza para indicar si el widget no está marcado.
QStyle::State_On0x00000020Se utiliza para indicar si el widget está marcado.
QStyle::State_Raised0x00000002Se utiliza para indicar si un botón está resaltado.
QStyle::State_ReadOnly0x02000000Se utiliza para indicar si un widget es de solo lectura.
QStyle::State_Selected0x00008000Se utiliza para indicar si un widget está seleccionado.
QStyle::State_Item0x00100000Lo utilizan las vistas de elementos para indicar si debe dibujarse una rama horizontal.
QStyle::State_Open0x00040000Lo utilizan las vistas de elementos para indicar si la rama del árbol está abierta.
QStyle::State_Sibling0x00200000Lo utilizan las vistas de elementos para indicar si es necesario dibujar una línea vertical (para elementos del mismo nivel).
QStyle::State_Sunken0x00000004Se utiliza para indicar si el widget está hundido o pulsado.
QStyle::State_UpArrow0x00004000Se utiliza para indicar si debe aparecer una flecha hacia arriba en el widget.
QStyle::State_Mini0x08000000Se utiliza para indicar un widget o botón de estilo «mini» de Mac.
QStyle::State_Small0x04000000Se utiliza para indicar un widget o botón de estilo «pequeño» de Mac.

El tipo `State` es una definición de tipo (`typedef`) para ` QFlags<StateFlag>`. Almacena una combinación OR de valores de `StateFlag`.

Véase también drawPrimitive().

enum QStyle::StyleHint

Esta enumeración describe las sugerencias de estilo disponibles. Una sugerencia de estilo es una indicación general sobre el aspecto y/o la sensación que debe transmitir.

ConstanteValorDescripción
QStyle::SH_EtchDisabledText0El texto desactivado aparece «grabado», igual que en Windows.
QStyle::SH_DitherDisabledText1El texto desactivado se muestra con efecto de tramado, tal y como ocurre en Motif.
QStyle::SH_ScrollBar_ContextMenu62Indica si una barra de desplazamiento tiene o no un menú contextual.
QStyle::SH_ScrollBar_MiddleClickAbsolutePosition2Un valor booleano. Si es verdadero, al hacer clic con el botón central en una barra de desplazamiento, el control deslizante salta a esa posición. Si es falso, se ignora el clic con el botón central.
QStyle::SH_ScrollBar_LeftClickAbsolutePosition39Un valor booleano. Si es verdadero, al hacer clic con el botón izquierdo en una barra de desplazamiento, el control deslizante saltará a esa posición. Si es falso, el clic con el botón izquierdo se comportará según corresponda a cada control.
QStyle::SH_ScrollBar_ScrollWhenPointerLeavesControl3Un valor booleano. Si es «true», al hacer clic en una barra de desplazamiento SubControl, mantener pulsado el botón del ratón y mover el puntero fuera de SubControl, la barra de desplazamiento seguirá desplazándose. Si es «false», la barra de desplazamiento dejará de desplazarse cuando el puntero salga de SubControl.
QStyle::SH_ScrollBar_RollBetweenButtons63Un valor booleano. Si es «true», al hacer clic en un botón de la barra de desplazamiento (SC_ScrollBarAddLine o SC_ScrollBarSubLine) y arrastrar el puntero hasta el botón opuesto (desplazamiento), se pulsará el nuevo botón y se soltará el anterior. Si es «false», se suelta el botón original y no ocurre nada (como en un botón pulsador).
QStyle::SH_TabBar_Alignment5La alineación de las pestañas en un QTabWidget. Los valores posibles son Qt::AlignLeft, Qt::AlignCenter y Qt::AlignRight.
QStyle::SH_Header_ArrowAlignment6La ubicación del indicador de ordenación puede aparecer en los encabezados de listas o tablas. Los valores posibles son los valores de Qt::Alignment (es decir, una combinación OR de los indicadores de Qt::AlignmentFlag ).
QStyle::SH_Slider_SnapToValue7Los controles deslizantes se ajustan a los valores mientras se mueven, al igual que en Windows.
QStyle::SH_Slider_SloppyKeyEvents8Las pulsaciones de teclas se gestionan de forma aproximada; por ejemplo, al pulsar a la izquierda en un control deslizante vertical se resta una línea.
QStyle::SH_ProgressDialog_CenterCancelButton9Botón central en los cuadros de diálogo de progreso; en los demás casos, alineación a la derecha.
QStyle::SH_ProgressDialog_TextLabelAlignment10La alineación de las etiquetas de texto en los cuadros de diálogo de progreso: « Qt::AlignCenter » en Windows y « Qt::AlignVCenter » en los demás casos.
QStyle::SH_PrintDialog_RightAlignButtons11Alinear a la derecha los botones del cuadro de diálogo de impresión, tal y como se hace en Windows.
QStyle::SH_MainWindow_SpaceBelowMenuBar12Espacio de uno o dos píxeles entre la barra de menús y el área de acoplamiento, tal y como se hace en Windows.
QStyle::SH_FontDialog_SelectAssociatedText13Selecciona el texto del campo de edición de línea, al seleccionar un elemento del cuadro de lista o cuando el campo de edición de línea recibe el foco, tal y como se hace en Windows.
QStyle::SH_Menu_KeyboardSearch66Al escribir, el menú busca elementos relevantes; en caso contrario, solo se tiene en cuenta el mnemónico.
QStyle::SH_Menu_AllowActiveAndDisabled14Permite que los elementos de menú desactivados estén activos.
QStyle::SH_Menu_SpaceActivatesItem15Al pulsar la barra espaciadora se activa el elemento, tal y como ocurre en Motif.
QStyle::SH_Menu_SubMenuPopupDelay16El número de milisegundos que hay que esperar antes de abrir un submenú (256 en Windows, 96 en Motif).
QStyle::SH_Menu_Scrollable30Si los menús emergentes deben admitir el desplazamiento.
QStyle::SH_Menu_SloppySubMenus33Si los menús emergentes deben permitir que el usuario mueva el cursor del ratón hacia un submenú mientras pasa por encima de otros elementos del menú. Esto es compatible con la mayoría de las plataformas de escritorio modernas.
QStyle::SH_Menu_SubMenuUniDirection105Desde Qt 5.5. Si el cursor tiene que desplazarse hacia el submenú (como ocurre en macOS), o si el cursor puede moverse en cualquier dirección siempre que llegue al submenú antes de que se agote el tiempo de espera de desplazamiento impreciso.
QStyle::SH_Menu_SubMenuUniDirectionFailCount106Desde Qt 5.5. Cuando se define SH_Menu_SubMenuUniDirection, esta enumeración define el número de movimientos fallidos del ratón antes de que se descarte el submenú «sloppy». Esto se puede utilizar para controlar el «rigor» del algoritmo unidireccional.
QStyle::SH_Menu_SubMenuSloppySelectOtherActions107Desde Qt 5.5. Si deben seleccionarse otros elementos de acción cuando el ratón se desplaza hacia un submenú «sloppy».
QStyle::SH_Menu_SubMenuSloppyCloseTimeout108Desde Qt 5.5. El tiempo de espera utilizado para cerrar los submenús «sloppy».
QStyle::SH_Menu_SubMenuResetWhenReenteringParent109Desde Qt 5.5. Al pasar de un submenú secundario a su submenú principal, ¿debe restablecerse el estado «sloppy», cerrando así el submenú secundario y activando el submenú principal?
QStyle::SH_Menu_SubMenuDontStartSloppyOnLeave110Desde Qt 5.5. No iniciar los temporizadores de «sloppy» cuando el ratón sale de un submenú.
QStyle::SH_ScrollView_FrameOnlyAroundContents17Si las vistas de desplazamiento dibujan su marco solo alrededor del contenido (como en Motif) o alrededor del contenido, las barras de desplazamiento y los widgets de las esquinas (como en Windows).
QStyle::SH_MenuBar_AltKeyNavigation18Se puede navegar por los elementos de las barras de menú pulsando Alt y, a continuación, utilizando las teclas de flecha para seleccionar el elemento deseado.
QStyle::SH_ComboBox_ListMouseTracking_CurrentSH_ComboBox_ListMouseTrackingSeguimiento del ratón en las listas desplegables de los cuadros combinados: el elemento situado bajo el cursor se convierte en el elemento actual (QStyle::State_Selected).
QStyle::SH_ComboBox_ListMouseTracking19Obsoleto. Utiliza en su lugar SH_ComboBox_ListMouseTracking_Current.
QStyle::SH_ComboBox_ListMouseTracking_Active120Seguimiento del ratón en las listas desplegables de los cuadros combinados: el elemento situado bajo el cursor no se convierte en el elemento actual, sino que solo se activa (QStyle::State_MouseOver).
QStyle::SH_Menu_MouseTracking20Seguimiento del ratón en menús emergentes.
QStyle::SH_MenuBar_MouseTracking21Seguimiento del ratón en las barras de menús.
QStyle::SH_Menu_FillScreenWithScroll45Si los menús emergentes con desplazamiento deben ocupar toda la pantalla a medida que se desplazan.
QStyle::SH_Menu_SelectionWrap73Si las ventanas emergentes deben permitir que las selecciones se ajusten, es decir, que al seleccionar un elemento, el siguiente sea el primero.
QStyle::SH_ItemView_ChangeHighlightOnFocus22Atenuación de los elementos seleccionados al perder el foco.
QStyle::SH_Widget_ShareActivation23Activar la activación compartida con cuadros de diálogo flotantes no modales.
QStyle::SH_TabBar_SelectMouseType4Qué tipo de evento del ratón debe provocar que se seleccione una pestaña.
QStyle::SH_ListViewExpand_SelectMouseType40¿Qué tipo de evento del ratón debe provocar que se seleccione la expansión de la vista de lista?
QStyle::SH_TabBar_PreferNoArrows38Si la barra de pestañas debe sugerir un tamaño para evitar las flechas de desplazamiento.
QStyle::SH_ComboBox_Popup25Permite que las ventanas emergentes aparezcan como un menú desplegable de un cuadro combinado.
QStyle::SH_Workspace_FillSpaceOnMaximize24El espacio de trabajo debe maximizar el área de cliente.
QStyle::SH_TitleBar_NoBorder26La barra de título no tiene borde.
QStyle::SH_Slider_StopMouseOverSlider27Detiene la repetición automática cuando el control deslizante alcanza la posición del ratón.
QStyle::SH_BlinkCursorWhenTextSelected28Si el cursor debe parpadear cuando se selecciona texto.
QStyle::SH_RichText_FullWidthSelection29Si las selecciones de texto enriquecido deben extenderse a todo el ancho del documento.
QStyle::SH_GroupBox_TextLabelVerticalAlignment31Cómo alinear verticalmente la etiqueta de texto de un cuadro de grupo.
QStyle::SH_GroupBox_TextLabelColor32Cómo dibujar la etiqueta de texto de un cuadro de grupo.
QStyle::SH_DialogButtons_DefaultButton36Qué botón obtiene el estado predeterminado en el control de botones de un cuadro de diálogo.
QStyle::SH_ToolBox_SelectedPageTitleBold37El grosor del título de la página seleccionada en un « QToolBox ».
QStyle::SH_LineEdit_PasswordCharacter35El carácter Unicode que se utilizará para las contraseñas.
QStyle::SH_LineEdit_PasswordMaskDelay103Determina el retraso, en milisegundos, antes de que el carácter visible se enmascare con un carácter de contraseña. Este valor de enumeración se añadió en Qt 5.4.
QStyle::SH_Table_GridLineColor34El valor RGBA de la cuadrícula de una tabla.
QStyle::SH_UnderlineShortcut41Si los atajos de teclado aparecen subrayados.
QStyle::SH_SpinBox_AnimateButton42Anima el clic cuando se pulsa «arriba» o «abajo» en un cuadro giratorio.
QStyle::SH_SpinBox_KeyPressAutoRepeatRate43Intervalo de repetición automática para las pulsaciones de teclas en el cuadro giratorio.
QStyle::SH_SpinBox_ClickAutoRepeatRate44Intervalo de repetición automática para los clics del ratón en el cuadro giratorio.
QStyle::SH_SpinBox_ClickAutoRepeatThreshold83Umbral de repetición automática para los clics del ratón en el cuadro giratorio.
QStyle::SH_SpinBox_SelectOnStep (since Qt 6.3)119Si al cambiar el valor con los botones o las teclas de arriba/abajo se selecciona automáticamente el texto.
QStyle::SH_ToolTipLabel_Opacity46Un número entero que indica la opacidad de la etiqueta de ayuda; 0 significa totalmente transparente y 255, totalmente opaco.
QStyle::SH_DrawMenuBarSeparator47Indica si la barra de menús muestra separadores o no.
QStyle::SH_TitleBar_ModifyNotification48Indica si la barra de título debe mostrar un «*» en las ventanas que se han modificado.
QStyle::SH_Button_FocusPolicy49La política de foco predeterminada para los botones.
QStyle::SH_CustomBase0xf0000000Valor base para las sugerencias de estilo personalizadas. Los valores personalizados deben ser superiores a este valor.
QStyle::SH_MessageBox_UseBorderForButtonSpacing50Un valor booleano que indica si se debe utilizar el borde de los botones (calculado como la mitad de la altura del botón) para el espaciado del botón en un cuadro de mensaje.
QStyle::SH_MessageBox_CenterButtons72Un valor booleano que indica si los botones del cuadro de mensaje deben estar centrados o no (véase QDialogButtonBox::setCentered()).
QStyle::SH_MessageBox_TextInteractionFlags70Un valor booleano que indica si el texto de un cuadro de mensaje debe permitir interacciones del usuario (por ejemplo, selección) o no.
QStyle::SH_TitleBar_AutoRaise51Un valor booleano que indica si los controles de la barra de título deben actualizarse cuando el ratón pasa por encima de ellos.
QStyle::SH_ToolButton_PopupDelay52Un entero que indica el retraso en milisegundos de la aparición de los menús asociados a los botones de herramientas.
QStyle::SH_FocusFrame_Mask53La máscara del marco de foco.
QStyle::SH_RubberBand_Mask54La máscara de la banda elástica.
QStyle::SH_WindowFrame_Mask55La máscara del marco de la ventana.
QStyle::SH_SpinControls_DisableOnBounds56Determina si los controles giratorios se mostrarán como desactivados al alcanzar el límite del rango de giro.
QStyle::SH_Dial_BackgroundRole57Define el papel de fondo preferido del estilo (como QPalette::ColorRole) para un control de dial.
QStyle::SH_ComboBox_LayoutDirection58La dirección de disposición del cuadro combinado. Por defecto, debe ser la misma que la indicada por la variable ` QStyleOption::direction `.
QStyle::SH_ItemView_EllipsisLocation59La ubicación donde deben añadirse los puntos suspensivos para el texto de un elemento que sea demasiado largo para caber en un elemento de vista.
QStyle::SH_ItemView_ShowDecorationSelected60Cuando se seleccione un elemento de una vista de elementos, resalta también la rama u otra decoración.
QStyle::SH_ItemView_ActivateItemOnSingleClick61Emite la señal «activated» cuando el usuario hace un clic simple en un elemento de una vista de elementos. De lo contrario, la señal se emite cuando el usuario hace un doble clic en un elemento.
QStyle::SH_Slider_AbsoluteSetButtons64Qué botones del ratón hacen que un control deslizante establezca el valor en la posición en la que se ha hecho clic.
QStyle::SH_Slider_PageSetButtons65Qué botones del ratón hacen que un control deslizante cambie el valor por pasos.
QStyle::SH_TabBar_ElideMode67El estilo de omisión predeterminado para una barra de pestañas.
QStyle::SH_DialogButtonLayout68Controla cómo se disponen los botones en un « QDialogButtonBox »; devuelve una enumeración « QDialogButtonBox::ButtonLayout ».
QStyle::SH_WizardStyle78Controla el aspecto de un « QWizard ». Devuelve una enumeración « QWizard::WizardStyle ».
QStyle::SH_FormLayoutWrapPolicy85Proporciona un valor predeterminado para el ajuste de las filas en un « QFormLayout ». Devuelve una enumeración « QFormLayout::RowWrapPolicy ».
QStyle::SH_FormLayoutFieldGrowthPolicy88Establece un valor predeterminado para cómo pueden ampliarse los campos en un ` QFormLayout`. Devuelve una enumeración ` QFormLayout::FieldGrowthPolicy `.
QStyle::SH_FormLayoutFormAlignment89Establece un valor predeterminado para la forma en que un ` QFormLayout ` alinea su contenido dentro del espacio disponible. Devuelve una enumeración ` Qt::Alignment `.
QStyle::SH_FormLayoutLabelAlignment90Establece un valor predeterminado para la forma en que un « QFormLayout » alinea las etiquetas dentro del espacio disponible. Devuelve una enumeración de « Qt::Alignment ».
QStyle::SH_ItemView_ArrowKeysNavigateIntoChildren79Controla si la vista de árbol seleccionará el primer elemento secundario cuando se expanda y se pulse la tecla de flecha derecha.
QStyle::SH_ComboBox_PopupFrameStyle69El estilo de marco utilizado al dibujar el menú emergente de un cuadro combinado.
QStyle::SH_DialogButtonBox_ButtonsHaveIcons71Indica si los botones estándar (StandardButtons) de un control « QDialogButtonBox » deben tener iconos o no.
QStyle::SH_ItemView_MovementWithoutUpdatingSelection74La vista de elementos puede indicar el elemento actual sin cambiar la selección.
QStyle::SH_ToolTip_Mask75La máscara de una información sobre herramientas.
QStyle::SH_FocusFrame_AboveWidget76El FocusFrame se superpone al widget en el que se encuentra el «foco».
QStyle::SH_TextControl_FocusIndicatorTextCharFormat77Especifica el formato de texto utilizado para resaltar los enlaces seleccionados en documentos de texto enriquecido mostrados, por ejemplo, en QTextBrowser. El formato debe ser un objeto de tipo ` QTextCharFormat ` devuelto en la variante del valor de retorno ` QStyleHintReturnVariant `. La propiedad ` QTextFormat::OutlinePen ` se utiliza para el contorno y ` QTextFormat::BackgroundBrush ` para el fondo del área resaltada.
QStyle::SH_Menu_FlashTriggeredItem81Elemento activado por Flash.
QStyle::SH_Menu_FadeOutOnHide82Atenúa el menú en lugar de ocultarlo inmediatamente.
QStyle::SH_TabWidget_DefaultTabPosition86Posición predeterminada de la barra de pestañas en un widget de pestañas.
QStyle::SH_ToolBar_Movable87Determina si la barra de herramientas es movible por defecto.
QStyle::SH_ItemView_PaintAlternatingRowColorsForEmptyArea84Si QTreeView pinta los colores de las filas de forma alterna para el área que no contiene ningún elemento.
QStyle::SH_Menu_Mask80La máscara para un menú emergente.
QStyle::SH_ItemView_DrawDelegateFrame91Determina si debe haber un marco para un widget delegado.
QStyle::SH_TabBar_CloseButtonPosition92Determina la posición del botón de cierre en una pestaña de una barra de pestañas.
QStyle::SH_DockWidget_ButtonsHaveFrame93Determina si los botones de dockwidget deben tener marcos. El valor predeterminado es «true».
QStyle::SH_ToolButtonStyle94Determina el estilo predeterminado del sistema para los botones de herramientas que utilizan ` Qt::ToolButtonFollowStyle`.
QStyle::SH_RequestSoftwareInputPanel95Determina cuándo deben solicitar los widgets de entrada un panel de entrada de software. Devuelve una enumeración de tipo ` QStyle::RequestSoftwareInputPanel`.
QStyle::SH_ScrollBar_Transient96Determina si el estilo admite barras de desplazamiento transitorias. Las barras de desplazamiento transitorias aparecen cuando se desplaza el contenido y desaparecen cuando ya no son necesarias.
QStyle::SH_Menu_SupportsSections97Determina si el estilo muestra secciones en los menús o las trata como simples separadores. Las secciones son separadores con una sugerencia de texto e icono.
QStyle::SH_ToolTip_WakeUpDelay98Determina el retraso, en milisegundos, antes de que se muestre una información sobre herramientas.
QStyle::SH_ToolTip_FallAsleepDelay99Determina el retraso (en milisegundos) antes de que sea necesario un nuevo tiempo de activación cuando se muestra una información sobre herramientas (nota: se muestra, no se oculta). Cuando no se necesita una nueva activación, la información sobre herramientas solicitada por el usuario se mostrará casi al instante.
QStyle::SH_Widget_Animate100Obsoleto. Utiliza SH_Widget_Animation_Duration en su lugar.
QStyle::SH_Splitter_OpaqueResize101Determina si los widgets se redimensionan dinámicamente (de forma opaca) mientras se mueve interactivamente el separador. Este valor de enumeración se introdujo en Qt 5.2.
QStyle::SH_TabBar_ChangeCurrentDelay104Determina el retraso, en milisegundos, antes de que cambie la pestaña actual al arrastrar sobre la barra de pestañas. Este valor de enumeración se introdujo en Qt 5.4
QStyle::SH_ItemView_ScrollMode111El modo de desplazamiento vertical y horizontal predeterminado, tal y como lo especifica el estilo. Se puede anular con ` QAbstractItemView::setVerticalScrollMode()` y ` QAbstractItemView::setHorizontalScrollMode()`. Este valor de enumeración se introdujo en Qt 5.7.
QStyle::SH_TitleBar_ShowToolTipsOnButtons112Determina si se muestran descripciones emergentes en los botones de la barra de título de la ventana. El estilo de Mac, por ejemplo, establece este valor en «false». Este valor de enumeración se introdujo en Qt 5.10.
QStyle::SH_Widget_Animation_Duration113Determina la duración de una animación (en ms). Un valor igual a cero significa que las animaciones estarán desactivadas. Este valor de enumeración se introdujo en Qt 5.10.
QStyle::SH_ComboBox_AllowWheelScrolling114Determina si se puede utilizar la rueda del ratón para desplazarse dentro de un cuadro de edición de línea ( QComboBox). Esta opción está activada por defecto en todos los estilos, excepto en el estilo Mac. Este valor de enumeración se introdujo en Qt 5.10.
QStyle::SH_SpinBox_ButtonsInsideFrame115Determina si los botones del cuadro de selección se encuentran dentro del marco del cuadro de edición de línea. Este valor de enumeración se introdujo en Qt 5.11.
QStyle::SH_SpinBox_StepModifier116« Qt::KeyboardModifier » aumenta la velocidad de paso de « QAbstractSpinBox ». Los valores posibles son « Qt::NoModifier », « Qt::ControlModifier » (por defecto) o « Qt::ShiftModifier ». « Qt::NoModifier » desactiva esta función. Este valor de enumeración se ha introducido en Qt 5.12.
QStyle::SH_TabBar_AllowWheelScrolling117Determina si se puede utilizar la rueda del ratón para desplazarse por las pestañas de un ` QTabBar`. Este valor de enumeración se introdujo en Qt 6.1.
QStyle::SH_Table_AlwaysDrawLeftTopGridLines118Determina si se dibujan o no las líneas de cuadrícula del extremo izquierdo y superior de una tabla cuando el encabezado está oculto. El valor por defecto es false. Este valor de enumeración se ha introducido en Qt 6.3.

Véase también styleHint().

enum QStyle::SubControl
flags QStyle::SubControls

Esta enumeración describe los subcontroles disponibles. Un subcontrol es un elemento de control que forma parte de un control complejo (ComplexControl).

ConstanteValorDescripción
QStyle::SC_None0x00000000Valor especial que no se corresponde con ningún otro subcontrol.
QStyle::SC_ScrollBarAddLine0x00000001Barra de desplazamiento: añadir línea (es decir, flecha abajo/derecha); véase también QScrollBar.
QStyle::SC_ScrollBarSubLine0x00000002Sublínea de la barra de desplazamiento (es decir, flecha arriba/izquierda).
QStyle::SC_ScrollBarAddPage0x00000004Añadir página en la barra de desplazamiento (es decir, «Avanzar página»).
QStyle::SC_ScrollBarSubPage0x00000008Subpágina de la barra de desplazamiento (es decir, «página arriba»).
QStyle::SC_ScrollBarFirst0x00000010Primera línea de la barra de desplazamiento (es decir, inicio).
QStyle::SC_ScrollBarLast0x00000020Última línea de la barra de desplazamiento (es decir, fin).
QStyle::SC_ScrollBarSlider0x00000040Mango del control deslizante de la barra de desplazamiento.
QStyle::SC_ScrollBarGroove0x00000080Subcontrol especial que contiene el área en la que puede moverse el control deslizante.
QStyle::SC_SpinBoxUp0x00000001Widget giratorio hacia arriba/aumentar; véase también « QSpinBox ».
QStyle::SC_SpinBoxDown0x00000002Widget de selección hacia abajo/disminuir.
QStyle::SC_SpinBoxFrame0x00000004Marco del control giratorio.
QStyle::SC_SpinBoxEditField0x00000008Campo de edición del widget de rueda giratoria.
QStyle::SC_ComboBoxEditField0x00000002Campo de edición del cuadro combinado; véase también QComboBox.
QStyle::SC_ComboBoxArrow0x00000004Botón de flecha del cuadro combinado.
QStyle::SC_ComboBoxFrame0x00000001Marco del cuadro combinado.
QStyle::SC_ComboBoxListBoxPopup0x00000008Rectángulo de referencia para el menú emergente del cuadro combinado. Se utiliza para calcular la posición del menú emergente.
QStyle::SC_SliderGroove0x00000001Subcontrol especial que contiene el área en la que puede desplazarse el control deslizante.
QStyle::SC_SliderHandle0x00000002Control deslizante.
QStyle::SC_SliderTickmarks0x00000004Marcas de graduación del control deslizante.
QStyle::SC_ToolButton0x00000001Botón de herramienta (véase también « QToolButton »).
QStyle::SC_ToolButtonMenu0x00000002Subcontrol para abrir un menú emergente en un botón de herramientas.
QStyle::SC_TitleBarSysMenu0x00000001Botón de menú del sistema (es decir, restaurar, cerrar, etc.).
QStyle::SC_TitleBarMinButton0x00000002Botón de minimizar.
QStyle::SC_TitleBarMaxButton0x00000004Botón de maximizar.
QStyle::SC_TitleBarCloseButton0x00000008Botón de cierre.
QStyle::SC_TitleBarLabel0x00000100Etiqueta del título de la ventana.
QStyle::SC_TitleBarNormalButton0x00000010Botón «Normal» (restaurar).
QStyle::SC_TitleBarShadeButton0x00000020Botón de ocultar.
QStyle::SC_TitleBarUnshadeButton0x00000040Botón «Mostrar».
QStyle::SC_TitleBarContextHelpButton0x00000080Botón de ayuda contextual.
QStyle::SC_DialHandle0x00000002El tirador del dial (es decir, lo que se utiliza para controlar el dial).
QStyle::SC_DialGroove0x00000001La ranura para el dial.
QStyle::SC_DialTickmarks0x00000004Las marcas de graduación del dial.
QStyle::SC_GroupBoxFrame0x00000008El marco de un cuadro de grupo.
QStyle::SC_GroupBoxLabel0x00000002El título de un cuadro de grupo.
QStyle::SC_GroupBoxCheckBox0x00000001La casilla de selección opcional de un cuadro de grupo.
QStyle::SC_GroupBoxContents0x00000004El contenido del cuadro de grupo.
QStyle::SC_MdiNormalButton0x00000002El botón normal de una subventana MDI en la barra de menús.
QStyle::SC_MdiMinButton0x00000001El botón de minimizar de una subventana MDI en la barra de menús.
QStyle::SC_MdiCloseButton0x00000004El botón de cierre de una subventana MDI en la barra de menús.
QStyle::SC_All0xffffffffValor especial que coincide con todos los subcontroles.

El tipo `SubControls` es una definición de tipo para ` QFlags<SubControl>`. Almacena una combinación OR de valores de `SubControl`.

Véase también ComplexControl.

enum QStyle::SubElement

Esta enumeración representa una subárea de un widget. Las implementaciones de estilos utilizan estas áreas para dibujar las diferentes partes de un widget.

ConstanteValorDescripción
QStyle::SE_PushButtonContents0Área que contiene la etiqueta (icono con texto o mapa de píxeles).
QStyle::SE_PushButtonFocusRect1Área para el rectángulo de foco (normalmente más grande que el rectángulo de contenido).
QStyle::SE_PushButtonLayoutItem37Área que forma parte del diseño padre.
QStyle::SE_PushButtonBevel (since Qt 5.15)56Área utilizada para el bisel del botón.
QStyle::SE_CheckBoxIndicator2Área para el indicador de estado (por ejemplo, una marca de verificación).
QStyle::SE_CheckBoxContents3Área destinada a la etiqueta (texto o mapa de píxeles).
QStyle::SE_CheckBoxFocusRect4Área del indicador de foco.
QStyle::SE_CheckBoxClickRect5Área en la que se puede hacer clic; por defecto es SE_CheckBoxFocusRect.
QStyle::SE_CheckBoxLayoutItem32Área que se tiene en cuenta para el diseño principal.
QStyle::SE_DateTimeEditLayoutItem34Área que se tiene en cuenta para el diseño padre.
QStyle::SE_RadioButtonIndicator6Área para el indicador de estado.
QStyle::SE_RadioButtonContents7Área para la etiqueta.
QStyle::SE_RadioButtonFocusRect8Área para el indicador de foco.
QStyle::SE_RadioButtonClickRect9Área en la que se puede hacer clic; el valor por defecto es SE_RadioButtonFocusRect.
QStyle::SE_RadioButtonLayoutItem38Área que cuenta para el diseño principal.
QStyle::SE_ComboBoxFocusRect10Área para el indicador de foco.
QStyle::SE_SliderFocusRect11Área para el indicador de foco.
QStyle::SE_SliderLayoutItem39Área que se tiene en cuenta para el diseño principal.
QStyle::SE_SpinBoxLayoutItem40Área que cuenta para el diseño principal.
QStyle::SE_ProgressBarGroove12Área para la ranura.
QStyle::SE_ProgressBarContents13Área para el indicador de progreso.
QStyle::SE_ProgressBarLabel14Área para la etiqueta de texto.
QStyle::SE_ProgressBarLayoutItem36Área que cuenta para el diseño principal.
QStyle::SE_FrameContents27Área para el contenido de un marco.
QStyle::SE_ShapedFrameContents51Área para el contenido de un marco utilizando la forma de QStyleOptionFrame; véase QFrame
QStyle::SE_FrameLayoutItem42Área que forma parte del diseño principal.
QStyle::SE_HeaderArrow17Área para el indicador de ordenación de un encabezado.
QStyle::SE_HeaderLabel16Área para la etiqueta de una cabecera.
QStyle::SE_LabelLayoutItem35Área que cuenta para el diseño principal.
QStyle::SE_LineEditContents26Área para el contenido de un campo de edición de línea.
QStyle::SE_TabWidgetLeftCorner21Área para el widget de la esquina izquierda en un widget de pestaña.
QStyle::SE_TabWidgetRightCorner22Área para el widget de la esquina derecha en un widget de pestañas.
QStyle::SE_TabWidgetTabBar18Área destinada al widget de barra de pestañas en un widget de pestañas.
QStyle::SE_TabWidgetTabContents20Área destinada al contenido del widget de pestañas.
QStyle::SE_TabWidgetTabPane19Área destinada al panel de un widget de pestañas.
QStyle::SE_TabWidgetLayoutItem44Área que forma parte del diseño principal.
QStyle::SE_ToolBoxTabContents15Área para el icono y la etiqueta de una pestaña de la caja de herramientas.
QStyle::SE_ToolButtonLayoutItem41Área que forma parte del diseño principal.
QStyle::SE_ItemViewItemCheckIndicator23Área para la marca de verificación de un elemento de vista.
QStyle::SE_TabBarTearIndicator24Obsoleto. Utiliza SE_TabBarTearIndicatorLeft en su lugar.
QStyle::SE_TabBarTearIndicatorLeftSE_TabBarTearIndicatorÁrea destinada al indicador de desprendimiento situado a la izquierda de una barra de pestañas con flechas de desplazamiento.
QStyle::SE_TabBarTearIndicatorRight55Área destinada al indicador de desgarro situado en el lado derecho de una barra de pestañas con flechas de desplazamiento.
QStyle::SE_TabBarScrollLeftButton53Área para el botón de desplazamiento a la izquierda en una barra de pestañas con botones de desplazamiento.
QStyle::SE_TabBarScrollRightButton54Área para el botón de desplazamiento a la derecha en una barra de pestañas con botones de desplazamiento.
QStyle::SE_TreeViewDisclosureItem25Área para el elemento de expansión real en una rama del árbol.
QStyle::SE_GroupBoxLayoutItem43Área que cuenta para el diseño principal.
QStyle::SE_CustomBase0xf0000000Valor base para los subelementos personalizados. Los valores personalizados deben ser mayores que este valor.
QStyle::SE_DockWidgetFloatButton29El botón flotante de un widget acoplable.
QStyle::SE_DockWidgetTitleBarText30Los límites de texto del título de los widgets de acoplamiento.
QStyle::SE_DockWidgetCloseButton28El botón de cierre de un widget de dock.
QStyle::SE_DockWidgetIcon31El icono de un widget de dock.
QStyle::SE_ComboBoxLayoutItem33Área que se tiene en cuenta para el diseño principal.
QStyle::SE_ItemViewItemDecoration45Área destinada a la decoración (icono) de un elemento de vista.
QStyle::SE_ItemViewItemText46Área destinada al texto de un elemento de vista.
QStyle::SE_ItemViewItemFocusRect47Área destinada al rectángulo de enfoque de un elemento de vista.
QStyle::SE_TabBarTabLeftButton48Área destinada a un widget situado a la izquierda de una pestaña en una barra de pestañas.
QStyle::SE_TabBarTabRightButton49Área destinada a un widget situado a la derecha de una pestaña en una barra de pestañas.
QStyle::SE_TabBarTabText50Área para el texto de una pestaña en una barra de pestañas.
QStyle::SE_ToolBarHandle52Área para el controlador de una barra de herramientas.

Véase también ` subElementRect()`.

Documentación de funciones de miembro

QStyle::QStyle()

Crea un objeto de estilo.

[virtual noexcept] QStyle::~QStyle()

Elimina el objeto de estilo.

[static] QRect QStyle::alignedRect(Qt::LayoutDirection direction, Qt::Alignment alignment, const QSize &size, const QRect &rectangle)

Devuelve un nuevo rectángulo con las dimensiones especificadas en size, alineado con el rectangle dado, de acuerdo con lo especificado en alignment y direction.

int QStyle::combinedLayoutSpacing(QSizePolicy::ControlTypes controls1, QSizePolicy::ControlTypes controls2, Qt::Orientation orientation, QStyleOption *option = nullptr, QWidget *widget = nullptr) const

Devuelve el espaciado que debe utilizarse entre controls1 y controls2 en una disposición. orientation especifica si los controles se disponen uno al lado del otro o apilados verticalmente. El parámetro option puede utilizarse para pasar información adicional sobre el widget padre. El parámetro widget es opcional y también puede utilizarse si option es nullptr.

controls1 y controls2 son una combinación OR de cero o más control types.

Esta función es llamada por el sistema de maquetación. Solo se utiliza si PM_LayoutHorizontalSpacing o PM_LayoutVerticalSpacing devuelven un valor negativo.

Véase también layoutSpacing().

[pure virtual] void QStyle::drawComplexControl(QStyle::ComplexControl control, const QStyleOptionComplex *option, QPainter *painter, const QWidget *widget = nullptr) const

Dibuja el elemento « control » indicado utilizando el « painter » proporcionado, con las opciones de estilo especificadas en « option ».

El argumento ` widget ` es opcional y puede utilizarse como ayuda para dibujar el control.

El parámetro ` option ` es un puntero a un objeto ` QStyleOptionComplex ` que puede convertirse a la subclase correcta mediante la función ` qstyleoption_cast()`. Tenga en cuenta que el miembro ` rect ` del ` option ` especificado debe estar en coordenadas lógicas. Las reimplementaciones de esta función deben utilizar ` visualRect()` para convertir las coordenadas lógicas en coordenadas de pantalla antes de llamar a las funciones ` drawPrimitive()` o ` drawControl()`.

La tabla siguiente enumera los elementos de control complejos y su subclase de opciones de estilo asociada. Las opciones de estilo contienen todos los parámetros necesarios para dibujar los controles, incluido QStyleOption::state, que contiene los style flags que se utilizan al dibujar. La tabla también describe qué indicadores se establecen al convertir el option dado a la subclase adecuada.

Control complejoQStyleOptionComplex SubclaseIndicador de estiloObservación
CC_SpinBoxQStyleOptionSpinBoxState_EnabledSe establece si el cuadro giratorio está habilitado.
State_HasFocusActívala si el cuadro giratorio tiene el foco de entrada.
CC_ComboBoxQStyleOptionComboBoxState_EnabledActívala si el cuadro combinado está habilitado.
State_HasFocusActívala si el cuadro combinado tiene el foco de entrada.
CC_ScrollBarQStyleOptionSliderState_EnabledActívese si la barra de desplazamiento está habilitada.
State_HasFocusEstablece si la barra de desplazamiento tiene el foco de entrada.
CC_SliderQStyleOptionSliderState_EnabledEstablece si el control deslizante está habilitado.
State_HasFocusEstablece si el control deslizante tiene el foco de entrada.
CC_DialQStyleOptionSliderState_EnabledEstablece si el dial está habilitado.
State_HasFocusEstablece si el dial tiene el foco de entrada.
CC_ToolButtonQStyleOptionToolButtonState_EnabledEstablece si el botón de herramienta está habilitado.
State_HasFocusEstablecer si el botón de herramienta tiene el foco de entrada.
State_DownArrowEstablece si el botón de herramienta está pulsado (es decir, si se ha pulsado un botón del ratón o la barra espaciadora).
State_OnEstablecer si el botón de herramienta es un botón de alternancia y está activado.
State_AutoRaiseEstablece si el botón de herramienta tiene activada la función de activación automática.
State_RaisedEstablece si el botón no está pulsado, no está activado y no contiene el cursor del ratón cuando la elevación automática está activada.
CC_TitleBarQStyleOptionTitleBarState_EnabledSe establece si la barra de título está activada.

Véase también drawPrimitive() y drawControl().

[pure virtual] void QStyle::drawControl(QStyle::ControlElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = nullptr) const

Dibuja el « element » indicado con el « painter » proporcionado y con las opciones de estilo especificadas en « option ».

El argumento ` widget ` es opcional y puede utilizarse como ayuda para dibujar el control. El parámetro ` option ` es un puntero a un objeto ` QStyleOption ` que puede convertirse a la subclase correcta mediante la función ` qstyleoption_cast()`.

La tabla siguiente enumera los elementos de control y su subclase de opciones de estilo asociada. Las opciones de estilo contienen todos los parámetros necesarios para dibujar los controles, incluido ` QStyleOption::state `, que contiene los indicadores de estilo que se utilizan al dibujar. La tabla también describe qué indicadores se establecen al convertir la opción dada a la subclase adecuada.

Ten en cuenta que, si un elemento de control no aparece en esta lista, es porque utiliza un objeto ` QStyleOption ` sin modificar.

Elemento de controlQStyleOption SubclaseIndicador de estiloObservación
CE_MenuItem, CE_MenuBarItemQStyleOptionMenuItemState_SelectedEl elemento del menú es el elemento seleccionado actualmente.
State_EnabledEl elemento está habilitado.
State_DownArrowIndica que debe dibujarse una flecha de desplazamiento hacia abajo.
State_UpArrowIndica que se debe dibujar una flecha de desplazamiento hacia arriba
State_HasFocusSe establece si la barra de menú tiene el foco de entrada.
CE_PushButton, CE_PushButtonBevel, CE_PushButtonLabelQStyleOptionButtonState_EnabledSe establece si el botón está habilitado.
State_HasFocusSe establece si el botón tiene el foco de entrada.
State_RaisedSe establece si el botón no está pulsado, no está activado y no tiene aspecto plano.
State_OnEstablecer si el botón es un botón de alternancia y está activado.
State_SunkenSe establece si el botón está pulsado (es decir, si se ha pulsado el botón del ratón o la barra espaciadora sobre el botón).
CE_RadioButton, CE_RadioButtonLabel, CE_CheckBox, CE_CheckBoxLabelQStyleOptionButtonState_EnabledSe establece si el botón está habilitado.
State_HasFocusSe establece si el botón tiene el foco de entrada.
State_OnEstablecer si el botón está marcado.
State_OffSe establece si el botón no está marcado.
State_NoChangeSe establece si el botón se encuentra en el estado «NoChange».
State_SunkenEstablecer si el botón está pulsado (es decir, si se ha pulsado el botón del ratón o la barra espaciadora sobre el botón).
CE_ProgressBarContents, CE_ProgressBarLabel, CE_ProgressBarGrooveQStyleOptionProgressBarState_EnabledEstablecer si la barra de progreso está habilitada.
State_HasFocusSe establece si la barra de progreso tiene el foco de entrada.
CE_Header, CE_HeaderSection, CE_HeaderLabelQStyleOptionHeader
CE_TabBarTab, CE_TabBarTabShape, CE_TabBarTabLabelQStyleOptionTabState_EnabledSe establece si la barra de pestañas está activada.
State_SelectedLa barra de pestañas es la barra de pestañas seleccionada actualmente.
State_HasFocusEstablece si la pestaña de la barra de pestañas tiene el foco de entrada.
CE_ToolButtonLabelQStyleOptionToolButtonState_EnabledSe establece si el botón de herramientas está habilitado.
State_HasFocusEstablecer si el botón de herramientas tiene el foco de entrada.
State_SunkenEstablecer si el botón de herramienta está pulsado (es decir, si se ha pulsado un botón del ratón o la barra espaciadora).
State_OnEstablece si el botón de herramienta es un botón de alternancia y está activado.
State_AutoRaiseEstablece si el botón de herramienta tiene activada la función de elevación automática.
State_MouseOverSe establece si el puntero del ratón se encuentra sobre el botón de herramienta.
State_RaisedEstablecer si el botón no está pulsado y no está activado.
CE_ToolBoxTabQStyleOptionToolBoxState_SelectedLa pestaña es la seleccionada actualmente.
CE_HeaderSectionQStyleOptionHeaderState_SunkenIndica que la sección está pulsada.
State_UpArrowIndica que el indicador de ordenación debe apuntar hacia arriba.
State_DownArrowIndica que el indicador de ordenación debe apuntar hacia abajo.

Véase también drawPrimitive() y drawComplexControl().

[virtual] void QStyle::drawItemPixmap(QPainter *painter, const QRect &rectangle, int alignment, const QPixmap &pixmap) const

Dibuja el « pixmap » proporcionado en el « rectangle » especificado, de acuerdo con el « alignment » especificado, utilizando el « painter » proporcionado.

Véase también drawItemText().

[virtual] void QStyle::drawItemText(QPainter *painter, const QRect &rectangle, int alignment, const QPalette &palette, bool enabled, const QString &text, QPalette::ColorRole textRole = QPalette::NoRole) const

Dibuja el texto « text » en el espacio « rectangle » especificado, utilizando los valores proporcionados para « painter » y « palette ».

El texto se dibuja utilizando el lápiz del pintor, y se alinea y ajusta según el alignment especificado. Si se especifica un textRole explícito, el texto se dibuja utilizando el color del palette para el rol dado. El parámetro enabled indica si el elemento está habilitado o no; al reimplementar esta función, el parámetro enabled debería influir en cómo se dibuja el elemento.

Véase también Qt::Alignment y drawItemPixmap().

[pure virtual] void QStyle::drawPrimitive(QStyle::PrimitiveElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = nullptr) const

Dibuja la primitiva indicada element con el painter proporcionado, utilizando las opciones de estilo especificadas en option.

El argumento widget es opcional y puede contener un widget que ayude a dibujar el elemento primitivo.

La tabla siguiente enumera los elementos primitivos y sus subclases de opciones de estilo asociadas. Las opciones de estilo contienen todos los parámetros necesarios para dibujar los elementos, incluido ` QStyleOption::state `, que contiene los indicadores de estilo que se utilizan al dibujar. La tabla también describe qué indicadores se establecen al convertir la opción dada a la subclase adecuada.

Ten en cuenta que, si un elemento primitivo no aparece en esta lista, es porque utiliza un objeto ` QStyleOption ` simple.

Elemento primitivoQStyleOption SubclaseIndicador de estiloObservación
PE_FrameFocusRectQStyleOptionFocusRectState_FocusAtBorderIndica si el foco se encuentra en el borde o en el interior del widget.
PE_IndicatorCheckBoxQStyleOptionButtonState_NoChangeIndica una casilla de selección de «tres estados».
State_OnIndica que el indicador está marcado.
PE_IndicatorRadioButtonQStyleOptionButtonState_OnIndica que un botón de opción está seleccionado.
State_NoChangeIndica un control de «tres estados».
State_EnabledIndica que el control está habilitado.
PE_IndicatorBranchQStyleOptionState_ChildrenIndica que debe dibujarse el control para expandir el árbol y mostrar los elementos secundarios.
State_ItemIndica que debe dibujarse una rama horizontal (para mostrar un elemento secundario).
State_OpenIndica que la rama del árbol está expandida.
State_SiblingIndica que se debe dibujar una línea vertical (para mostrar un elemento hermano).
PE_IndicatorHeaderArrowQStyleOptionHeaderState_UpArrowIndica que la flecha debe dibujarse hacia arriba; en caso contrario, debe dibujarse hacia abajo.
PE_FrameGroupBox, PE_Frame, PE_FrameLineEdit, PE_FrameMenu, PE_FrameDockWidget, PE_FrameWindowQStyleOptionFrameState_SunkenIndica que el marco debe estar hundido.
PE_IndicatorToolBarHandleQStyleOptionState_HorizontalIndica que el controlador de la ventana es horizontal en lugar de vertical.
PE_IndicatorSpinPlus, PE_IndicatorSpinMinus, PE_IndicatorSpinUp, PE_IndicatorSpinDown,QStyleOptionSpinBoxState_SunkenIndica que el botón está pulsado.
PE_PanelButtonCommandQStyleOptionButtonState_EnabledSe establece si el botón está habilitado.
State_HasFocusActívalo si el botón tiene el foco de entrada.
State_RaisedActívalo si el botón no está pulsado, no está encendido ni está plano.
State_OnSe establece si el botón es un botón de alternancia y está activado.
State_SunkenSe establece si el botón está pulsado (es decir, si se ha pulsado el botón del ratón o la barra espaciadora sobre el botón).

Véase también drawComplexControl() y drawControl().

[pure virtual] QPixmap QStyle::generatedIconPixmap(QIcon::Mode iconMode, const QPixmap &pixmap, const QStyleOption *option) const

Devuelve una copia del ` pixmap` proporcionado, con un estilo que se ajusta a la ` iconMode ` especificada y teniendo en cuenta la paleta especificada por ` option`.

El parámetro ` option ` puede pasar información adicional, pero debe contener una paleta.

Ten en cuenta que no todos los mapas de píxeles cumplirán estos requisitos; en tal caso, el mapa de píxeles devuelto será una copia sin formato.

Véase también QIcon.

[pure virtual] QStyle::SubControl QStyle::hitTestComplexControl(QStyle::ComplexControl control, const QStyleOptionComplex *option, const QPoint &position, const QWidget *widget = nullptr) const

Devuelve el subcontrol situado en la posición « position » indicada, en el sistema de coordenadas complejo « control » especificado (con las opciones de estilo definidas en « option »).

Tenga en cuenta que el position se expresa en coordenadas de pantalla.

El argumento ` option ` es un puntero a un objeto ` QStyleOptionComplex ` (o a una de sus subclases). El objeto puede convertirse al tipo adecuado utilizando la función ` qstyleoption_cast()`. Véase ` drawComplexControl()` para más detalles. El argumento ` widget ` es opcional y puede contener información adicional para la función.

Véanse también drawComplexControl() y subControlRect().

[virtual] QRect QStyle::itemPixmapRect(const QRect &rectangle, int alignment, const QPixmap &pixmap) const

Devuelve el área dentro del « rectangle » indicado en la que se dibujará el « pixmap » especificado, de acuerdo con el « alignment » definido.

[virtual] QRect QStyle::itemTextRect(const QFontMetrics &metrics, const QRect &rectangle, int alignment, bool enabled, const QString &text) const

Devuelve el área dentro del rectangle dado en la que se dibujará el text proporcionado, de acuerdo con la fuente especificada metrics y alignment. El parámetro enabled indica si el elemento asociado está habilitado o no.

Si el rectangle proporcionado es mayor que el área necesaria para renderizar el text, el rectángulo devuelto se desplazará dentro de rectangle según lo especificado en alignment. Por ejemplo, si alignment es Qt::AlignCenter, el rectángulo devuelto se centrará dentro de rectangle. Si el rectangle proporcionado es menor que el área necesaria, el rectángulo devuelto será el rectángulo más pequeño lo suficientemente grande como para renderizar el text.

Véase también Qt::Alignment.

[pure virtual] int QStyle::layoutSpacing(QSizePolicy::ControlType control1, QSizePolicy::ControlType control2, Qt::Orientation orientation, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const

Devuelve el espaciado que debe utilizarse entre control1 y control2 en un diseño. orientation especifica si los controles se disponen uno al lado del otro o apilados verticalmente. El parámetro option puede utilizarse para pasar información adicional sobre el widget padre. El parámetro widget es opcional y también puede utilizarse si option es nullptr.

Esta función es llamada por el sistema de diseño. Solo se utiliza si PM_LayoutHorizontalSpacing o PM_LayoutVerticalSpacing devuelve un valor negativo.

Véase también combinedLayoutSpacing().

[since 6.1] QString QStyle::name() const

Devuelve el nombre del estilo.

Este valor se puede utilizar para crear un estilo con ` QStyleFactory::create()`.

Esta función se introdujo en Qt 6.1.

Véase también ` QStyleFactory::create()`.

[pure virtual] int QStyle::pixelMetric(QStyle::PixelMetric metric, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const

Devuelve el valor del píxel indicado metric.

Para calcular la métrica se pueden utilizar los valores especificados en « option » y « widget ». El valor de « option » se puede convertir al tipo adecuado mediante la función « qstyleoption_cast()». Ten en cuenta que el valor de « option » puede ser cero incluso en el caso de PixelMetrics que puedan hacer uso de él. Consulta la tabla siguiente para conocer las conversiones adecuadas de « option »:

Algunas métricas de píxeles se invocan desde widgets y otras solo se invocan internamente por el estilo. Si la métrica no es invocada por un widget, queda a discreción del autor del estilo utilizarla. Para algunos estilos, esto puede no ser adecuado.

[virtual] void QStyle::polish(QWidget *widget)

Inicializa la apariencia del elemento « widget » especificado.

Esta función se invoca para cada widget en algún momento después de que se haya creado por completo, pero justo antes de que se muestre por primera vez.

Ten en cuenta que la implementación por defecto no hace nada. Una acción razonable en esta función podría ser llamar a la función QWidget::setBackgroundMode() para el widget. No utilices esta función para establecer, por ejemplo, la geometría. Reimplementar esta función proporciona una vía alternativa a través de la cual se puede modificar la apariencia de un widget, pero con el motor de estilos de Qt rara vez es necesario implementar esta función; en su lugar, reimplementa drawItemPixmap(), drawItemText(), drawPrimitive(), etc.

La función QWidget::inherits() puede proporcionar información suficiente para permitir personalizaciones específicas de la clase. Sin embargo, dado que se espera que las nuevas subclases de QStyle funcionen de forma razonable con todos los widgets actuales y futuros, se recomienda un uso limitado de la personalización codificada de forma fija.

Véase también unpolish().

[virtual] void QStyle::polish(QApplication *application)

Inicialización tardía del objeto « application » indicado.

Esta es una función sobrecargada.

[virtual] void QStyle::polish(QPalette &palette)

Modifica la función « palette » según los requisitos específicos de estilo para las paletas de colores (si las hay).

Esta es una función sobrecargada.

Véanse también QPalette y QApplication::setPalette().

const QStyle *QStyle::proxy() const

Esta función devuelve el proxy actual de este estilo. Por defecto, la mayoría de los estilos devuelven el propio estilo. Sin embargo, cuando se utiliza un estilo proxy, este permite que el estilo vuelva a llamar a su proxy.

[pure virtual] QSize QStyle::sizeFromContents(QStyle::ContentsType type, const QStyleOption *option, const QSize &contentsSize, const QWidget *widget = nullptr) const

Devuelve el tamaño del elemento descrito por los parámetros especificados ` option ` y ` type`, basándose en el objeto ` contentsSize` proporcionado.

El argumento ` option ` es un puntero a un ` QStyleOption ` o a una de sus subclases. El ` option ` puede convertirse al tipo adecuado mediante la función ` qstyleoption_cast()`. El ` widget ` es un argumento opcional y puede contener información adicional utilizada para calcular el tamaño.

Consulta la tabla siguiente para conocer los conversiones adecuadas de option:

Véase también ContentsType y QStyleOption.

[static] int QStyle::sliderPositionFromValue(int min, int max, int logicalValue, int span, bool upsideDown = false)

Convierte el valor dado de « logicalValue » en una posición de píxel. El parámetro « min » se asigna a 0, « max » se asigna a « span » y los demás valores se distribuyen uniformemente entre ambos.

Esta función puede manejar todo el rango de números enteros sin desbordamiento, siempre que span sea inferior a 4096.

Por defecto, esta función asume que el valor máximo se encuentra a la derecha en el caso de los elementos horizontales y en la parte inferior en el caso de los elementos verticales. Establece el parámetro upsideDown en «true» para invertir este comportamiento.

Véase también sliderValueFromPosition().

[static] int QStyle::sliderValueFromPosition(int min, int max, int position, int span, bool upsideDown = false)

Convierte el valor de píxel dado position en un valor lógico. El valor 0 se asigna al parámetro min, el valor span se asigna a max y los demás valores se distribuyen uniformemente entre ambos.

Esta función puede manejar todo el rango de números enteros sin desbordamiento.

Por defecto, esta función asume que el valor máximo se encuentra a la derecha para los elementos horizontales y en la parte inferior para los elementos verticales. Establece el parámetro upsideDown en «true» para invertir este comportamiento.

Véase también sliderPositionFromValue().

[pure virtual] QIcon QStyle::standardIcon(QStyle::StandardPixmap standardIcon, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const

Devuelve un icono para el « standardIcon » indicado.

El ` standardIcon ` es un mapa de píxeles estándar que puede seguir algún estilo o directriz de interfaz gráfica de usuario (GUI) ya existente. El argumento ` option ` puede utilizarse para pasar información adicional necesaria a la hora de definir el icono adecuado. El argumento ` widget ` es opcional y también puede utilizarse para facilitar la determinación del icono.

[virtual] QPalette QStyle::standardPalette() const

Devuelve la paleta estándar del estilo.

Ten en cuenta que, en los sistemas que admiten colores del sistema, no se utiliza la paleta estándar del estilo. En concreto, los estilos de Windows Vista y Mac no utilizan la paleta estándar, sino que recurren a motores de temas nativos. Con estos estilos, no debes establecer la paleta con QApplication::setPalette().

Véase también QApplication::setPalette().

[pure virtual] int QStyle::styleHint(QStyle::StyleHint hint, const QStyleOption *option = nullptr, const QWidget *widget = nullptr, QStyleHintReturn *returnData = nullptr) const

Devuelve un entero que representa el estilo especificado hint para el widget dado, descrito por el estilo proporcionado option.

returnData Se utiliza cuando el widget que realiza la consulta necesita datos más detallados que el entero que devuelve styleHint(). Consulta la descripción de la clase QStyleHintReturn para obtener más detalles.

[pure virtual] QRect QStyle::subControlRect(QStyle::ComplexControl control, const QStyleOptionComplex *option, QStyle::SubControl subControl, const QWidget *widget = nullptr) const

Devuelve el rectángulo que contiene el « subControl » especificado del « control » complejo dado (con el estilo especificado por « option »). El rectángulo se define en coordenadas de pantalla.

El argumento ` option ` es un puntero a ` QStyleOptionComplex ` o a una de sus subclases, y puede convertirse al tipo adecuado utilizando la función ` qstyleoption_cast()`. Véase ` drawComplexControl()` para más detalles. El argumento ` widget ` es opcional y puede contener información adicional para la función.

Véase también drawComplexControl().

[pure virtual] QRect QStyle::subElementRect(QStyle::SubElement element, const QStyleOption *option, const QWidget *widget = nullptr) const

Devuelve la subárea correspondiente al objeto ` element ` dado, tal y como se describe en el estilo proporcionado ` option`. El rectángulo devuelto se define en coordenadas de pantalla.

El argumento widget es opcional y puede utilizarse para ayudar a determinar el área. El objeto QStyleOption puede convertirse al tipo adecuado mediante la función qstyleoption_cast(). Consulte la tabla siguiente para conocer las conversiones adecuadas de option:

[virtual] void QStyle::unpolish(QWidget *widget)

Desinicializa la apariencia del widget « widget » indicado.

Esta función es la contrapartida de ` polish()`. Se invoca para cada widget pulido cada vez que se cambia dinámicamente el estilo; el estilo anterior debe desactivar sus ajustes antes de que el nuevo estilo pueda volver a aplicarlos.

Ten en cuenta que unpolish() solo se invocará si se destruye el widget. Esto puede causar problemas en algunos casos, por ejemplo, si eliminas un widget de la interfaz de usuario, lo almacenas en caché y luego lo vuelves a insertar después de que el estilo haya cambiado; algunas clases de Qt almacenan sus widgets en caché.

Véase también polish().

[virtual] void QStyle::unpolish(QApplication *application)

Desinicializa la función « application » indicada.

Esta es una función sobrecargada.

[static] Qt::Alignment QStyle::visualAlignment(Qt::LayoutDirection direction, Qt::Alignment alignment)

Transforma un ` alignment ` de ` Qt::AlignLeft ` o ` Qt::AlignRight ` sin ` Qt::AlignAbsolute ` en ` Qt::AlignLeft ` o ` Qt::AlignRight ` con ` Qt::AlignAbsolute `, de acuerdo con el diseño ` direction`. El resto de indicadores de alineación no se modifican.

Si no se ha especificado ninguna alineación horizontal, la función devuelve la alineación por defecto para el diseño dado direction.

QWidget::layoutDirection

[static] QPoint QStyle::visualPos(Qt::LayoutDirection direction, const QRect &boundingRectangle, const QPoint &logicalPosition)

Devuelve el ` logicalPosition ` indicado, convertido a coordenadas de pantalla según el ` direction` especificado. El ` boundingRectangle ` se utiliza al realizar la traslación.

Véase también QWidget::layoutDirection.

[static] QRect QStyle::visualRect(Qt::LayoutDirection direction, const QRect &boundingRectangle, const QRect &logicalRectangle)

Devuelve el valor de ` logicalRectangle ` dado, convertido a coordenadas de pantalla según el valor especificado en ` direction`. Para realizar la traslación se utiliza ` boundingRectangle `.

Esta función se proporciona para dar soporte a los entornos de escritorio de escritura de derecha a izquierda y se utiliza habitualmente en implementaciones de la función subControlRect().

Véase también QWidget::layoutDirection.

© 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.