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 `.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionToolButton::Type | SO_ToolButton | El 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 `.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionToolButton::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.
enum QStyleOptionToolButton::ToolButtonFeature
flags QStyleOptionToolButton::ToolButtonFeatures
Describe las distintas funciones que puede tener un botón de herramienta.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionToolButton::None | 0x00 | Un botón de herramienta normal. |
QStyleOptionToolButton::Arrow | 0x01 | El botón de herramienta es una flecha. |
QStyleOptionToolButton::Menu | 0x04 | El botón de herramienta tiene un menú. |
QStyleOptionToolButton::PopupDelay | 0x08 | Hay un retraso en la aparición del menú. |
QStyleOptionToolButton::HasMenu | 0x10 | El botón tiene un menú emergente. |
QStyleOptionToolButton::MenuButtonPopup | Menu | El 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.