QStyleOption Class
La clase `QStyleOption` almacena los parámetros que utilizan las funciones de ` QStyle `. Más información...
| Encabezado: | #include <QStyleOption> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado por: | 16 tiposQStyleOptionButton, QStyleOptionComplex, QStyleOptionDockWidget, QStyleOptionFocusRect, QStyleOptionFrame, QStyleOptionGraphicsItem, QStyleOptionHeader, QStyleOptionMenuItem, QStyleOptionProgressBar, QStyleOptionRubberBand, QStyleOptionTab, QStyleOptionTabBarBase, QStyleOptionTabWidgetFrame, QStyleOptionToolBar, QStyleOptionToolBox y QStyleOptionViewItem |
Tipos públicos
| enum | OptionType { SO_Button, SO_ComboBox, SO_Complex, SO_Default, SO_DockWidget, …, SO_ComplexCustomBase } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
Funciones públicas
| QStyleOption(int version = QStyleOption::Version, int type = SO_Default) | |
| QStyleOption(const QStyleOption &other) | |
| ~QStyleOption() | |
| void | initFrom(const QWidget *widget) |
| QStyleOption & | operator=(const QStyleOption &other) |
Variables públicas
| Qt::LayoutDirection | direction |
| QFontMetrics | fontMetrics |
| QPalette | palette |
| QRect | rect |
| QStyle::State | state |
| QObject * | styleObject |
| int | type |
| int | version |
Elementos no miembros relacionados
| T | qstyleoption_cast(const QStyleOption *option) |
| T | qstyleoption_cast(QStyleOption *option) |
Descripción detallada
QStyleOption y sus subclases contienen toda la información que las funciones de « QStyle » necesitan para dibujar un elemento gráfico.
Por motivos de rendimiento, hay pocas funciones miembro y el acceso a las variables miembro es directo (es decir, mediante el operador « . » o « -> »). Esto hace que las estructuras sean fáciles de usar y pone de relieve que se trata simplemente de parámetros utilizados por las funciones de estilo.
Quien invoca una función ` QStyle ` suele crear objetos `QStyleOption` en la pila. Esto, combinado con el amplio uso que hace Qt del uso compartido implícito para tipos como ` QString`, ` QPalette` y ` QColor `, garantiza que no se produzca ninguna asignación de memoria innecesaria.
El siguiente fragmento de código muestra cómo utilizar una subclase específica de `QStyleOption` para dibujar un botón:
void MyPushButton::paintEvent(QPaintEvent *)
{
QStyleOptionButton option;
option.initFrom(this);
option.state = isDown() ? QStyle::State_Sunken : QStyle::State_Raised;
if (isDefault())
option.features |= QStyleOptionButton::DefaultButton;
option.text = text();
option.icon = icon();
QPainter painter(this);
style()->drawControl(QStyle::CE_PushButton, &option, &painter, this);
}En nuestro ejemplo, el control es un ` QStyle::CE_PushButton` y, según la documentación de ` QStyle::drawControl()`, la clase correspondiente es ` QStyleOptionButton`.
Al reimplementar funciones de ` QStyle ` que admiten un parámetro de tipo `QStyleOption`, a menudo es necesario convertir el `QStyleOption` a una subclase. Por seguridad, puedes utilizar ` qstyleoption_cast()` para asegurarte de que el tipo de puntero es correcto. Por ejemplo:
void MyStyle::drawPrimitive(PrimitiveElement element,
const QStyleOption *option,
QPainter *painter,
const QWidget *widget)
{
if (element == PE_FrameFocusRect) {
const QStyleOptionFocusRect *focusRectOption =
qstyleoption_cast<const QStyleOptionFocusRect *>(option);
if (focusRectOption) {
// ...
}
}
// ...
}La función qstyleoption_cast() devolverá 0 si el objeto al que apunta option no es del tipo correcto.
Véase también QStyle y QStylePainter.
Documentación sobre tipos de miembros
enum QStyleOption::OptionType
Esta enumeración la utilizan internamente QStyleOption, sus subclases y qstyleoption_cast() para determinar el tipo de opción de estilo. En general, no tienes que preocuparte por esto a menos que quieras crear tu propia subclase de QStyleOption y tus propios estilos.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOption::SO_Button | 2 | QStyleOptionButton |
QStyleOption::SO_ComboBox | 0xf0004 | QStyleOptionComboBox |
QStyleOption::SO_Complex | 0xf0000 | QStyleOptionComplex |
QStyleOption::SO_Default | 0 | QStyleOption |
QStyleOption::SO_DockWidget | 9 | QStyleOptionDockWidget |
QStyleOption::SO_FocusRect | 1 | QStyleOptionFocusRect |
QStyleOption::SO_Frame | 5 | QStyleOptionFrame |
QStyleOption::SO_GraphicsItem | 15 | QStyleOptionGraphicsItem |
QStyleOption::SO_GroupBox | 0xf0006 | QStyleOptionGroupBox |
QStyleOption::SO_Header | 8 | QStyleOptionHeader |
QStyleOption::SO_MenuItem | 4 | QStyleOptionMenuItemV2 |
QStyleOption::SO_ProgressBar | 6 | QStyleOptionProgressBar |
QStyleOption::SO_RubberBand | 13 | QStyleOptionRubberBand |
QStyleOption::SO_SizeGrip | 0xf0007 | QStyleOptionSizeGrip |
QStyleOption::SO_Slider | 0xf0001 | QStyleOptionSlider |
QStyleOption::SO_SpinBox | 0xf0002 | QStyleOptionSpinBox |
QStyleOption::SO_Tab | 3 | QStyleOptionTab |
QStyleOption::SO_TabBarBase | 12 | QStyleOptionTabBarBase |
QStyleOption::SO_TabWidgetFrame | 11 | QStyleOptionTabWidgetFrame |
QStyleOption::SO_TitleBar | 0xf0005 | QStyleOptionTitleBar |
QStyleOption::SO_ToolBar | 14 | QStyleOptionToolBar |
QStyleOption::SO_ToolBox | 7 | QStyleOptionToolBox |
QStyleOption::SO_ToolButton | 0xf0003 | QStyleOptionToolButton |
QStyleOption::SO_ViewItem | 10 | QStyleOptionViewItem (utilizada en entrevistas) |
Los siguientes valores se utilizan para los controles personalizados:
| Constante | Valor | Descripción |
|---|---|---|
QStyleOption::SO_CustomBase | 0xf00 | Reservado para QStyleOptions personalizadas; todos los valores de los controles personalizados deben ser superiores a este valor |
QStyleOption::SO_ComplexCustomBase | 0xf000000 | Reservado para QStyleOptions personalizadas; todos los valores de los controles complejos personalizados deben ser superiores a este valor |
Véase también type.
enum QStyleOption::StyleOptionType
Esta enumeración se utiliza para almacenar información sobre el tipo de la opción de estilo y se define para cada subclase de ` QStyleOption `.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOption::Type | SO_Default | El tipo de opción de estilo proporcionada (SO_Default para esta clase). |
El tipo lo utilizan internamente ` QStyleOption`, sus subclases y ` qstyleoption_cast()` para determinar el tipo de opción de estilo. En general, no es necesario que te preocupes por esto a menos que quieras crear tu propia subclase de ` QStyleOption ` y tus propios estilos.
Véase también StyleOptionVersion.
enum QStyleOption::StyleOptionVersion
Esta enumeración se utiliza para almacenar información sobre la versión de la opción de estilo y se define para cada subclase de ` QStyleOption `.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOption::Version | 1 | 1 |
Las subclases de ` QStyleOption ` utilizan esta versión para implementar extensiones sin romper la compatibilidad. Si utilizas ` qstyleoption_cast()`, normalmente no es necesario que la compruebes.
Véase también StyleOptionType.
Documentación de funciones miembro
QStyleOption::QStyleOption(int version = QStyleOption::Version, int type = SO_Default)
Crea un objeto `QStyleOption` con los valores especificados para ` version ` y ` type`.
La versión no tiene ningún significado especial para QStyleOption; las subclases pueden utilizarla para distinguir entre diferentes versiones del mismo tipo de opción.
La variable miembro state se inicializa con el valor QStyle::State_None.
QStyleOption::QStyleOption(const QStyleOption &other)
Crea una copia de other.
[noexcept] QStyleOption::~QStyleOption()
Elimina este objeto de opciones de estilo.
void QStyleOption::initFrom(const QWidget *widget)
Inicializa las variables miembro state, direction, rect, palette, fontMetrics y styleObject en función del widget especificado.
Se trata de una función de conveniencia; las variables miembro también pueden inicializarse manualmente.
Véase también QWidget::layoutDirection(), QWidget::rect(), QWidget::palette() y QWidget::fontMetrics().
QStyleOption &QStyleOption::operator=(const QStyleOption &other)
Asigna « other » a este « QStyleOption ».
Documentación sobre variables de miembro
Qt::LayoutDirection QStyleOption::direction
Esta variable contiene la dirección de alineación del texto que debe utilizarse al dibujar texto en el control
Por defecto, la dirección de maquetación es Qt::LeftToRight.
Véase también initFrom().
QFontMetrics QStyleOption::fontMetrics
Esta variable contiene las métricas de fuente que deben utilizarse al dibujar texto en el control
Por defecto, se utiliza la fuente predeterminada de la aplicación.
Véase también initFrom().
QPalette QStyleOption::palette
Esta variable contiene la paleta que debe utilizarse al rellenar el control
Por defecto, se utiliza la paleta predeterminada de la aplicación.
Véase también initFrom().
QRect QStyleOption::rect
Esta variable contiene el área que debe utilizarse para diversos cálculos y para el sombreado
Esto puede tener diferentes significados según el tipo de elemento. Por ejemplo, en el caso de un elemento « QStyle::CE_PushButton », correspondería al rectángulo que abarca todo el botón, mientras que en el caso de un elemento « QStyle::CE_PushButtonLabel », correspondería únicamente al área de la etiqueta del botón pulsador.
El valor por defecto es un rectángulo nulo, es decir, un rectángulo con el ancho y la altura establecidos en 0.
Véase también initFrom().
QStyle::State QStyleOption::state
Esta variable contiene los indicadores de estilo que se utilizan al dibujar el control
El valor por defecto es QStyle::State_None.
Véase también initFrom(), QStyle::drawPrimitive(), QStyle::drawControl(), QStyle::drawComplexControl() y QStyle::State.
QObject *QStyleOption::styleObject
Esta variable contiene el objeto al que se le aplica el estilo
Los estilos integrados admiten los siguientes tipos: QWidget, QGraphicsObject y QQuickItem.
Véase también initFrom().
int QStyleOption::type
Esta variable contiene el tipo de la opción de estilo
El valor por defecto es « SO_Default ».
Véase también « OptionType ».
int QStyleOption::version
Esta variable contiene la versión de la opción de estilo
Las subclases pueden utilizar este valor para implementar extensiones sin romper la compatibilidad. Si utilizas la función qstyleoption_cast(), normalmente no es necesario comprobarlo.
El valor por defecto es 1.
Elementos no miembros relacionados
template <typename T> T qstyleoption_cast(const QStyleOption *option)
Devuelve un valor de tipo T o nullptr, dependiendo de los valores de type y version del objeto option proporcionado.
Ejemplo:
void MyStyle::drawPrimitive(PrimitiveElement element,
const QStyleOption *option,
QPainter *painter,
const QWidget *widget)
{
if (element == PE_FrameFocusRect) {
const QStyleOptionFocusRect *focusRectOption =
qstyleoption_cast<const QStyleOptionFocusRect *>(option);
if (focusRectOption) {
// ...
}
}
// ...
}Véase también QStyleOption::type y QStyleOption::version.
template <typename T> T qstyleoption_cast(QStyleOption *option)
Devuelve un T o un ` nullptr `, dependiendo del tipo del ` option` proporcionado.
Esta es una función sobrecargada.
© 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.