QStyleOptionToolBar Class
QStyleOptionToolBar 类用于描述绘制工具栏的参数。更多
Header: | #include <QStyleOptionToolBar> |
CMake.QStyleOptionToolBar 类 | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
qmake: | QT += widgets |
继承: | QStyleOption |
公共类型
enum | StyleOptionType { Type } |
enum | StyleOptionVersion { Version } |
enum | ToolBarFeature { None, Movable } |
flags | ToolBarFeatures |
enum | ToolBarPosition { Beginning, Middle, End, OnlyOne } |
公共函数
QStyleOptionToolBar() | |
QStyleOptionToolBar(const QStyleOptionToolBar &other) |
公共变量
QStyleOptionToolBar::ToolBarFeatures | features |
int | lineWidth |
int | midLineWidth |
QStyleOptionToolBar::ToolBarPosition | positionOfLine |
QStyleOptionToolBar::ToolBarPosition | positionWithinLine |
Qt::ToolBarArea | toolBarArea |
详细说明
QStyleOptionToolBar 包含QStyle 函数绘制QToolBar 所需的所有信息。
QStyleOptionToolBar 类包含用于绘制 widget 的lineWidth 和midLineWidth 。它还存储了以下信息:工具栏应位于哪个area 、是否可移动、工具栏线条应位于哪个位置 (positionOfLine) 以及工具栏在线条中的位置 (positionWithinLine)。
此外,该类还提供了几个枚举:ToolBarFeature 枚举用于描述工具栏是否可移动,ToolBarPosition 枚举用于描述工具栏行的位置以及工具栏在行中的位置。
出于性能考虑,成员函数很少,对成员变量的访问是直接的(即使用.
或->
操作符)。这使得结构使用起来更加简单明了,并强调这些只是样式函数使用的参数。
另请参见 QStyleOption 。
成员类型文档
enum QStyleOptionToolBar::StyleOptionType
该枚举用于保存有关样式选项类型的信息,并为每个QStyleOption 子类定义。
常量 | 值 | 描述 |
---|---|---|
QStyleOptionToolBar::Type | SO_ToolBar | 提供的样式选项的类型(SO_ToolBar 适用于该类)。 |
QStyleOption 及其子类和qstyleoption_cast() 内部使用该类型来确定样式选项的类型。一般来说,除非您想创建自己的QStyleOption 子类和自己的样式,否则不需要担心这个问题。
另请参见 StyleOptionVersion 。
enum QStyleOptionToolBar::StyleOptionVersion
该枚举用于保存有关样式选项版本的信息,并为每个QStyleOption 子类定义。
常量 | 值 | 说明 |
---|---|---|
QStyleOptionToolBar::Version | 1 | 1 |
版本用于QStyleOption 子类在不破坏兼容性的情况下实现扩展。如果使用qstyleoption_cast() ,通常不需要检查它。
另请参阅 StyleOptionType 。
枚举 QStyleOptionToolBar::ToolBarFeature
flagsQStyleOptionToolBar::ToolBarFeatures
该枚举用于描述工具栏是否可移动。
常量 | 值 | 描述 |
---|---|---|
QStyleOptionToolBar::None | 0x0 | 工具栏不可移动。默认值。 |
QStyleOptionToolBar::Movable | 0x1 | 工具栏是可以移动的,当光标停留在工具栏的边界上时,会出现一个句柄。 |
ToolBarFeatures 类型是QFlags<ToolBarFeature> 的类型定义。它存储 ToolBarFeature 值的 OR 组合。
另请参阅 features 和QToolBar::isMovable()。
enum QStyleOptionToolBar::ToolBarPosition
该枚举用于描述工具栏行的位置以及工具栏在行内的位置。
行内位置的顺序是垂直线从顶部开始,水平线从左侧开始。线条的位置顺序总是从父部件的边界边缘开始。
常数 | 值 | 说明 |
---|---|---|
QStyleOptionToolBar::Beginning | 0 | 工具栏位于行的开头,或者工具栏行是几行中的第一行。该位置只能有一个工具栏(也只能有一行)。 |
QStyleOptionToolBar::Middle | 1 | 工具栏位于行的中间,或者工具栏行位于几行的中间。该位置可以有多个工具栏(和行)。 |
QStyleOptionToolBar::End | 2 | 工具栏位于行的末尾,或者工具栏行位于几行中的最后一行。该位置只能有一个工具栏(和一行)。 |
QStyleOptionToolBar::OnlyOne | 3 | 只有一个工具栏或一行。这是positionOfLine 和positionWithinLine 变量的默认值。 |
另请参阅 positionWithinLine 和positionOfLine 。
成员函数文档
QStyleOptionToolBar::QStyleOptionToolBar()
构造一个 QStyleOptionToolBar,将成员变量初始化为默认值。
QStyleOptionToolBar::QStyleOptionToolBar(const QStyleOptionToolBar &other)
构建other 样式选项的副本。
成员变量文档
QStyleOptionToolBar::ToolBarFeatures QStyleOptionToolBar::features
该变量表示工具栏是否可移动。
默认值为None 。
int QStyleOptionToolBar::lineWidth
该变量用于保存绘制工具栏时的线宽。
默认值为 0。
int QStyleOptionToolBar::midLineWidth
该变量用于保存绘制工具栏时的中线宽度。
默认值为 0。
QStyleOptionToolBar::ToolBarPosition QStyleOptionToolBar::positionOfLine
该变量用于保存工具栏行的位置。
默认值为QStyleOptionToolBar::OnlyOne 。
QStyleOptionToolBar::ToolBarPosition QStyleOptionToolBar::positionWithinLine
该变量用于保存工具栏在一行中的位置。
默认值为QStyleOptionToolBar::OnlyOne 。
Qt::ToolBarArea QStyleOptionToolBar::toolBarArea
该变量用于保存绘制工具栏的位置。
默认值为Qt::TopToolBarArea 。
另请参见 Qt::ToolBarArea 。
© 2025 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.