QStyleOptionToolBar Class
La clase QStyleOptionToolBar se utiliza para describir los parámetros para dibujar una barra de herramientas. Más...
| Cabecera: | #include <QStyleOptionToolBar> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | QStyleOption |
Tipos Públicos
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | ToolBarFeature { None, Movable } |
| flags | ToolBarFeatures |
| enum | ToolBarPosition { Beginning, Middle, End, OnlyOne } |
Funciones Públicas
| QStyleOptionToolBar() | |
| QStyleOptionToolBar(const QStyleOptionToolBar &other) |
Variables Públicas
| QStyleOptionToolBar::ToolBarFeatures | features |
| int | lineWidth |
| int | midLineWidth |
| QStyleOptionToolBar::ToolBarPosition | positionOfLine |
| QStyleOptionToolBar::ToolBarPosition | positionWithinLine |
| Qt::ToolBarArea | toolBarArea |
Descripción Detallada
QStyleOptionToolBar contiene toda la información que las funciones QStyle necesitan para dibujar QToolBar.
La clase QStyleOptionToolBar contiene el lineWidth y el midLineWidth para dibujar el widget. También almacena información sobre en qué area debe estar situada la barra de herramientas, si es movible o no, qué posición debe tener la línea de la barra de herramientas (positionOfLine), y la posición de la barra de herramientas dentro de la línea (positionWithinLine).
Además, la clase proporciona un par de enums: El enum ToolBarFeature se utiliza para describir si una barra de herramientas es movible o no, y el enum ToolBarPosition se utiliza para describir la posición de una línea de la barra de herramientas, así como la posición de la barra de herramientas dentro de la línea.
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 sencillas de utilizar y pone de relieve que se trata simplemente de parámetros utilizados por las funciones de estilo.
Véase también QStyleOption.
Documentación de los tipos miembros
enum QStyleOptionToolBar::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 |
|---|---|---|
QStyleOptionToolBar::Type | SO_ToolBar | El tipo de opción de estilo proporcionada (SO_ToolBar 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 QStyleOptionToolBar::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 |
|---|---|---|
QStyleOptionToolBar::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 QStyleOptionToolBar::ToolBarFeature
flags QStyleOptionToolBar::ToolBarFeatures
Este enum se utiliza para describir si una barra de herramientas es movible o no.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionToolBar::None | 0x0 | La barra de herramientas no se puede mover. Valor por defecto. |
QStyleOptionToolBar::Movable | 0x1 | La barra de herramientas es movible, y aparecerá un manejador cuando se mantenga el cursor sobre el límite de la barra de herramientas. |
El tipo ToolBarFeatures es un typedef para QFlags<ToolBarFeature>. Almacena una combinación OR de valores ToolBarFeature.
Ver también features y QToolBar::isMovable().
enum QStyleOptionToolBar::ToolBarPosition

Este enum se utiliza para describir la posición de una línea de la barra de herramientas, así como la posición de la barra de herramientas dentro de la línea.
El orden de las posiciones dentro de una línea comienza en la parte superior de una línea vertical, y desde la izquierda dentro de una línea horizontal. El orden de las posiciones para las líneas es siempre desde los bordes del widget padre.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionToolBar::Beginning | 0 | La barra de herramientas está situada al principio de la línea, o la línea de la barra de herramientas es la primera de varias líneas. Sólo puede haber una barra de herramientas (y sólo una línea) con esta posición. |
QStyleOptionToolBar::Middle | 1 | La barra de herramientas está situada en medio de la línea, o la línea de la barra de herramientas está en medio de varias líneas. Puede haber varias barras de herramientas (y líneas) con esta posición. |
QStyleOptionToolBar::End | 2 | La barra de herramientas está situada al final de la línea, o la línea de la barra de herramientas es la última de varias líneas. Sólo puede haber una barra de herramientas (y sólo una línea) con esta posición. |
QStyleOptionToolBar::OnlyOne | 3 | Sólo hay una barra de herramientas o una línea. Este es el valor por defecto de las variables positionOfLine y positionWithinLine. |
Véase también positionWithinLine y positionOfLine.
Documentación de las funciones miembro
QStyleOptionToolBar::QStyleOptionToolBar()
Construye una QStyleOptionToolBar, inicializando las variables miembros a sus valores por defecto.
QStyleOptionToolBar::QStyleOptionToolBar(const QStyleOptionToolBar &other)
Construye una copia de la opción de estilo other.
Documentación de la variable miembro
QStyleOptionToolBar::ToolBarFeatures QStyleOptionToolBar::features
Esta variable indica si la barra de herramientas es móvil o no.
El valor por defecto es None.
int QStyleOptionToolBar::lineWidth
Esta variable contiene el ancho de línea para dibujar la barra de herramientas.
El valor por defecto es 0.
int QStyleOptionToolBar::midLineWidth
Esta variable contiene el ancho de la línea media para dibujar la barra de herramientas.
El valor por defecto es 0.
QStyleOptionToolBar::ToolBarPosition QStyleOptionToolBar::positionOfLine
Esta variable contiene la posición de la línea de la barra de herramientas.
El valor por defecto es QStyleOptionToolBar::OnlyOne.
QStyleOptionToolBar::ToolBarPosition QStyleOptionToolBar::positionWithinLine
Esta variable contiene la posición de la barra de herramientas dentro de una línea.
El valor por defecto es QStyleOptionToolBar::OnlyOne.
Qt::ToolBarArea QStyleOptionToolBar::toolBarArea
Esta variable contiene la ubicación para dibujar la barra de herramientas.
El valor por defecto es Qt::TopToolBarArea.
Véase también Qt::ToolBarArea.
© 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.