En esta página

QStyleOptionButton Class

La clase QStyleOptionButton se utiliza para describir los parámetros para dibujar botones. Más...

Cabecera: #include <QStyleOptionButton>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Hereda: QStyleOption

Tipos Públicos

enum ButtonFeature { None, Flat, HasMenu, DefaultButton, AutoDefaultButton, CommandLinkButton }
flags ButtonFeatures
enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

Funciones Públicas

QStyleOptionButton()
QStyleOptionButton(const QStyleOptionButton &other)

Variables Públicas

QStyleOptionButton::ButtonFeatures features
QIcon icon
QSize iconSize
QString text

Descripción Detallada

QStyleOptionButton contiene toda la información que las funciones QStyle necesitan para dibujar elementos gráficos como QPushButton, QCheckBox, y QRadioButton.

Por razones de rendimiento, hay pocas funciones miembro y el acceso a las variables miembro es directo (es decir, utilizando 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.

Véase también QStyleOption y QStyleOptionToolButton.

Documentación de tipos de miembros

enum QStyleOptionButton::ButtonFeature
flags QStyleOptionButton::ButtonFeatures

Esta enum describe los diferentes tipos de características que puede tener un botón.

ConstanteValorDescripción
QStyleOptionButton::None0x00Indica un botón pulsador normal.
QStyleOptionButton::Flat0x01Indica un pulsador plano.
QStyleOptionButton::HasMenu0x02Indica que el botón tiene un menú desplegable.
QStyleOptionButton::DefaultButton0x04Indica que el botón es un botón predeterminado.
QStyleOptionButton::AutoDefaultButton0x08Indica que el botón es un botón predeterminado automático.
QStyleOptionButton::CommandLinkButton0x10Indica que el botón es un enlace de comandos de tipo Windows Vista.

El tipo ButtonFeatures es un typedef para QFlags<ButtonFeature>. Almacena una combinación OR de valores ButtonFeature.

Véase también features.

enum QStyleOptionButton::StyleOptionType

Este enum se utiliza para guardar información sobre el tipo de la opción de estilo, y se define para cada subclase de QStyleOption.

ConstanteValorDescripción
QStyleOptionButton::TypeSO_ButtonEl tipo de opción de estilo proporcionada (SO_Button para esta clase).

El tipo es utilizado internamente por QStyleOption, sus subclases, y qstyleoption_cast() para determinar el tipo de opción de estilo. En general no necesitas preocuparte por esto a menos que quieras crear tu propia subclase QStyleOption y tus propios estilos.

Véase también StyleOptionVersion.

enum QStyleOptionButton::StyleOptionVersion

Este enum se utiliza para guardar información sobre la versión de la opción de estilo, y se define para cada subclase de QStyleOption.

ConstanteValorDescripción
QStyleOptionButton::Version11

La versión es utilizada por las subclases de QStyleOption para implementar extensiones sin romper la compatibilidad. Si utiliza qstyleoption_cast(), normalmente no necesita comprobarla.

Véase también StyleOptionType.

Documentación de funciones miembro

QStyleOptionButton::QStyleOptionButton()

Construye un QStyleOptionButton, inicializando las variables miembros a sus valores por defecto.

QStyleOptionButton::QStyleOptionButton(const QStyleOptionButton &other)

Construye una copia de la opción de estilo other.

Documentación de la variable miembro

QStyleOptionButton::ButtonFeatures QStyleOptionButton::features

Esta variable contiene un bitwise OR de las características que describen este botón

Véase también ButtonFeature.

QIcon QStyleOptionButton::icon

Esta variable contiene el icono del botón

El valor por defecto es un icono vacío, es decir, un icono sin mapa de píxeles ni nombre de archivo.

Véase también iconSize.

QSize QStyleOptionButton::iconSize

Esta variable contiene el tamaño del icono del botón

El valor por defecto es QSize(-1, -1), es decir, un tamaño no válido.

QString QStyleOptionButton::text

Esta variable contiene el texto del botón

El valor por defecto es una cadena vacía.

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