En esta página

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.

ConstanteValorDescripción
QStyleOptionToolBar::TypeSO_ToolBarEl 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.

ConstanteValorDescripción
QStyleOptionToolBar::Version11

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.

ConstanteValorDescripción
QStyleOptionToolBar::None0x0La barra de herramientas no se puede mover. Valor por defecto.
QStyleOptionToolBar::Movable0x1La 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

Diagrama de la línea de la barra de herramientas y las posiciones relativas a la línea

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.

ConstanteValorDescripción
QStyleOptionToolBar::Beginning0La 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::Middle1La 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::End2La 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::OnlyOne3Só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.