QStyleOptionToolButton Class
La clase QStyleOptionToolButton se utiliza para describir los parámetros para dibujar un botón de herramienta. Más...
| Cabecera: | #include <QStyleOptionToolButton> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | 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) |
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 las funciones QStyle necesitan para dibujar QToolButton.
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, QStyleOptionComplex, y QStyleOptionButton.
Documentación de tipos de miembros
enum QStyleOptionToolButton::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.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionToolButton::Type | SO_ToolButton | El tipo de opción de estilo proporcionada (SO_ToolButton 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 QStyleOptionToolButton::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.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionToolButton::Version | 1 | 1 |
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.
Ver también StyleOptionType.
enum QStyleOptionToolButton::ToolButtonFeature
flags QStyleOptionToolButton::ToolButtonFeatures
Describe las distintas características 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 retardo para mostrar el menú. |
QStyleOptionToolButton::HasMenu | 0x10 | El botón tiene un menú emergente. |
QStyleOptionToolButton::MenuButtonPopup | Menu | El botón debe mostrar una flecha para indicar que hay un menú presente. |
El tipo ToolButtonFeatures es un typedef para QFlags<ToolButtonFeature>. Almacena una combinación OR de valores ToolButtonFeature.
Ver también features, QToolButton::toolButtonStyle(), y QToolButton::popupMode().
Documentación de las funciones miembro
QStyleOptionToolButton::QStyleOptionToolButton()
Construye un QStyleOptionToolButton, inicializando las variables miembros a sus valores por defecto.
QStyleOptionToolButton::QStyleOptionToolButton(const QStyleOptionToolButton &other)
Construye una copia de la opción de estilo other.
Documentación de la variable miembro
Qt::ArrowType QStyleOptionToolButton::arrowType
Esta variable contiene la dirección de la flecha para el botón de la herramienta
Este valor sólo se utiliza si features incluye Arrow. El valor por defecto es Qt::DownArrow.
QStyleOptionToolButton::ToolButtonFeatures QStyleOptionToolButton::features
Esta variable contiene una combinación OR 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 sólo se utiliza si toolButtonStyle es Qt::ToolButtonTextUnderIcon, Qt::ToolButtonTextBesideIcon, o Qt::ToolButtonTextOnly. Por defecto, se utiliza la fuente por defecto 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 sin 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 un punto nulo, es decir (0, 0)
QString QStyleOptionToolButton::text
Esta variable contiene el texto del botón de la herramienta
Este valor sólo 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 Qt::ToolButtonStyle que describe la apariencia 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.
