En esta página

QStyleOptionToolButton Class

La clase `QStyleOptionToolButton` se utiliza para definir los parámetros necesarios para dibujar un botón de herramienta. Más información...

Cabecera: #include <QStyleOptionToolButton>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QStyleOptionComplex

Tipos públicos

enum StyleOptionType { Type }
enum StyleOptionVersion { Version }
enum ToolButtonFeature { None, Arrow, Menu, PopupDelay, HasMenu, MenuButtonPopup }
flags ToolButtonFeatures

Funciones públicas

QStyleOptionToolButton()
QStyleOptionToolButton(const QStyleOptionToolButton &other)
QStyleOptionToolButton &operator=(const QStyleOptionToolButton &)

Variables públicas

Qt::ArrowType arrowType
QStyleOptionToolButton::ToolButtonFeatures features
QFont font
QIcon icon
QSize iconSize
QPoint pos
QString text
Qt::ToolButtonStyle toolButtonStyle

Descripción detallada

QStyleOptionToolButton contiene toda la información que necesitan las funciones de QStyle para dibujar QToolButton.

Por motivos de rendimiento, hay pocas funciones miembro y el acceso a las variables miembro es directo (es decir, mediante los operadores . 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, QStyleOptionComplex y QStyleOptionButton.

Documentación sobre los tipos de miembro

enum QStyleOptionToolButton::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 `.

ConstanteValorDescripción
QStyleOptionToolButton::TypeSO_ToolButtonEl tipo de opción de estilo proporcionada (SO_ToolButton 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 QStyleOptionToolButton::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 `.

ConstanteValorDescripción
QStyleOptionToolButton::Version11

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.

enum QStyleOptionToolButton::ToolButtonFeature
flags QStyleOptionToolButton::ToolButtonFeatures

Describe las distintas funciones que puede tener un botón de herramienta.

ConstanteValorDescripción
QStyleOptionToolButton::None0x00Un botón de herramienta normal.
QStyleOptionToolButton::Arrow0x01El botón de herramienta es una flecha.
QStyleOptionToolButton::Menu0x04El botón de herramienta tiene un menú.
QStyleOptionToolButton::PopupDelay0x08Hay un retraso en la aparición del menú.
QStyleOptionToolButton::HasMenu0x10El botón tiene un menú emergente.
QStyleOptionToolButton::MenuButtonPopupMenuEl botón debería mostrar una flecha para indicar que hay un menú.

El tipo `ToolButtonFeatures` es un `typedef` para ` QFlags<ToolButtonFeature>`. Almacena una combinación OR de valores de `ToolButtonFeature`.

Véase también features, QToolButton::toolButtonStyle() y QToolButton::popupMode().

Documentación de las funciones de miembro

QStyleOptionToolButton::QStyleOptionToolButton()

Crea un objeto `QStyleOptionToolButton`, inicializando las variables de miembro con sus valores por defecto.

QStyleOptionToolButton::QStyleOptionToolButton(const QStyleOptionToolButton &other)

Crea una copia de la opción de estilo « other ».

[noexcept default] QStyleOptionToolButton &QStyleOptionToolButton::operator=(const QStyleOptionToolButton &)

Asigna por copia ` other ` a esta instancia de ` QStyleOptionToolButton `.

Documentación de variables de miembro

Qt::ArrowType QStyleOptionToolButton::arrowType

Esta variable contiene la dirección de la flecha del botón de la herramienta

Este valor solo se utiliza si « features » incluye « Arrow ». El valor por defecto es « Qt::DownArrow ».

QStyleOptionToolButton::ToolButtonFeatures QStyleOptionToolButton::features

Esta variable contiene una combinación «O» de las características del botón de la herramienta

El valor por defecto es None.

Véase también ToolButtonFeature.

QFont QStyleOptionToolButton::font

Esta variable contiene la fuente que se utiliza para el texto

Este valor solo se utiliza si ` toolButtonStyle ` es ` Qt::ToolButtonTextUnderIcon`, ` Qt::ToolButtonTextBesideIcon` o ` Qt::ToolButtonTextOnly`. Por defecto, se utiliza la fuente predeterminada de la aplicación.

QIcon QStyleOptionToolButton::icon

Esta variable contiene el icono del botón de la herramienta

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

Véase también iconSize.

QSize QStyleOptionToolButton::iconSize

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

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

QPoint QStyleOptionToolButton::pos

Esta variable contiene la posición del botón de la herramienta

El valor por defecto es el punto nulo, es decir, (0, 0)

QString QStyleOptionToolButton::text

Esta variable contiene el texto del botón de la herramienta

Este valor solo se utiliza si « toolButtonStyle » es « Qt::ToolButtonTextUnderIcon », « Qt::ToolButtonTextBesideIcon » o « Qt::ToolButtonTextOnly ». El valor por defecto es una cadena vacía.

Qt::ToolButtonStyle QStyleOptionToolButton::toolButtonStyle

Esta variable contiene un valor de tipo « Qt::ToolButtonStyle » que describe el aspecto del botón de la herramienta

El valor por defecto es ` Qt::ToolButtonIconOnly`.

Véase también QToolButton::toolButtonStyle().

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