En esta página

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 `.

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

ConstanteValorDescripción
QStyleOptionToolBar::Version11

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.

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

Esquema de la línea de la barra de herramientas y las posiciones respecto a dicha línea

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.

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