QStyleOptionToolBar Class
La clase QStyleOptionToolBar se utiliza para definir los parámetros necesarios para dibujar una barra de herramientas. Más información...
| Encabezado: | #include <QStyleOptionToolBar> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | 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) | |
| QStyleOptionToolBar & | operator=(const QStyleOptionToolBar &) |
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 de « 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 ubicarse 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 enumeraciones: la enumeración « ToolBarFeature » se utiliza para indicar si una barra de herramientas es movible o no, y la enumeración « 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 motivos 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 usar y pone de relieve que se trata simplemente de parámetros utilizados por las funciones de estilo.
Véase también QStyleOption.
Documentación sobre los tipos de miembros
enum QStyleOptionToolBar::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 |
|---|---|---|
QStyleOptionToolBar::Type | SO_ToolBar | El tipo de opción de estilo proporcionada (SO_ToolBar 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 QStyleOptionToolBar::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 |
|---|---|---|
QStyleOptionToolBar::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 QStyleOptionToolBar::ToolBarFeature
flags QStyleOptionToolBar::ToolBarFeatures
Esta enumeración se utiliza para indicar si una barra de herramientas se puede mover o no.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionToolBar::None | 0x0 | La barra de herramientas no se puede mover. Es el valor por defecto. |
QStyleOptionToolBar::Movable | 0x1 | La barra de herramientas se puede mover y aparecerá un controlador al situar el cursor sobre el borde de la barra de herramientas. |
El tipo ToolBarFeatures es una definición de tipo (typedef) para QFlags<ToolBarFeature>. Almacena una combinación OR de valores de ToolBarFeature.
Véase también features y QToolBar::isMovable().
enum QStyleOptionToolBar::ToolBarPosition

Esta enumeración 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 por la izquierda en una línea horizontal. El orden de las posiciones de las líneas se establece siempre a partir de los bordes del widget padre.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionToolBar::Beginning | 0 | La barra de herramientas se encuentra al principio de la línea, o la línea de la barra de herramientas es la primera de varias líneas. Solo puede haber una barra de herramientas (y una sola línea) con esta posición. |
QStyleOptionToolBar::Middle | 1 | La barra de herramientas se encuentra en el centro de la línea, o la línea de la barra de herramientas está en el centro de varias líneas. Puede haber varias barras de herramientas (y líneas) con esta posición. |
QStyleOptionToolBar::End | 2 | La barra de herramientas se encuentra al final de la línea, o la línea de la barra de herramientas es la última de varias líneas. Solo puede haber una barra de herramientas (y una sola línea) con esta posición. |
QStyleOptionToolBar::OnlyOne | 3 | Solo 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 funciones de miembro
QStyleOptionToolBar::QStyleOptionToolBar()
Crea una barra de herramientas `QStyleOptionToolBar`, inicializando las variables de miembro con sus valores por defecto.
QStyleOptionToolBar::QStyleOptionToolBar(const QStyleOptionToolBar &other)
Crea una copia de la opción de estilo « other ».
[noexcept default] QStyleOptionToolBar &QStyleOptionToolBar::operator=(const QStyleOptionToolBar &)
Asigna por copia other a esta instancia de QStyleOptionToolBar.
Documentación sobre variables de miembro
QStyleOptionToolBar::ToolBarFeatures QStyleOptionToolBar::features
Esta variable indica si la barra de herramientas se puede mover 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 central 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 en la que se 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.