QToolBar Class

成员函数文档

[explicit] QToolBar::QToolBar(QWidget *parent = nullptr)

根据给定的parent ，构建一个QToolBar。

[explicit] QToolBar::QToolBar(const QString &title, QWidget *parent = nullptr)

根据给定的parent 构建一个QToolBar。

给定的窗口title 用于标识该工具栏，并显示在由QMainWindow 提供的上下文菜单中。

另请参阅 setWindowTitle()。

[virtual noexcept] QToolBar::~QToolBar()

删除工具栏。

QAction *QToolBar::actionAt(const QPoint &p) const

返回位于p 处的操作。如果未找到任何操作，该函数将返回零。

另请参阅 QWidget::childAt()。

QAction *QToolBar::actionAt(int x, int y) const

返回坐标为x 、y 处的动作。如果未找到动作，该函数返回零。

[override virtual protected] void QToolBar::actionEvent(QActionEvent *event)

重写了：QWidget::actionEvent(QActionEvent *event)。

[signal] void QToolBar::actionTriggered(QAction *action)

当此工具栏中的某个操作被触发时，会发出此信号。这发生在按下该操作的工具按钮时，或者在工具栏之外通过其他方式触发该操作时。该参数包含被触发的action 。

QAction *QToolBar::addSeparator()

在工具栏末尾添加一个分隔符。

另请参阅 insertSeparator()。

QAction *QToolBar::addWidget(QWidget *widget)

将给定的widget 作为工具栏的最后一个项目添加到工具栏中。

工具栏将拥有widget 的所有权。

如果使用此方法添加QToolButton ，则不会遵循工具栏的Qt::ToolButtonStyle 属性。

另请参阅 insertWidget()。

[signal] void QToolBar::allowedAreasChanged(Qt::ToolBarAreas allowedAreas)

当工具栏的允许区域集合发生变化时，会触发此信号。工具栏可定位的新区域由allowedAreas 指定。

另请参阅 allowedAreas 。

[override virtual protected] void QToolBar::changeEvent(QEvent *event)

重写了：QWidget::changeEvent(QEvent *event)。

void QToolBar::clear()

从工具栏中移除所有操作。

另请参阅 removeAction()。

[override virtual protected] bool QToolBar::event(QEvent *event)

重写了：QWidget::event(QEvent *event)。

[signal] void QToolBar::iconSizeChanged(const QSize &iconSize)

当图标大小发生变化时，会触发此信号。iconSize 参数存储了工具栏的新图标大小。

另请参阅 iconSize 和QMainWindow::iconSize 。

QAction *QToolBar::insertSeparator(QAction *before)

在工具栏中，于与before 操作相关联的工具栏项目前方插入一个分隔符。

另请参阅 addSeparator()。

QAction *QToolBar::insertWidget(QAction *before, QWidget *widget)

将给定的widget 插入到与before 操作关联的工具栏项前面。

注意：应使用QAction::setVisible()来更改控件的可见性。使用QWidget::setVisible()、QWidget::show()和QWidget::hide()均无效。

另请参阅 addWidget()。

bool QToolBar::isAreaAllowed(Qt::ToolBarArea area) const

如果该工具栏可在给定的area 中停靠，则返回true ；否则返回false 。

[signal] void QToolBar::movableChanged(bool movable)

当工具栏变为可移动或固定状态时，会发出此信号。如果工具栏可以移动，则movable 为true；否则为false。

另请参阅 movable 。

[signal] void QToolBar::orientationChanged(Qt::Orientation orientation)

当工具栏的方向发生变化时，会触发此信号。orientation 参数保存了工具栏的新方向。

另请参阅 orientation 。

[override virtual protected] void QToolBar::paintEvent(QPaintEvent *event)

重写了：QWidget::paintEvent(QPaintEvent *event)。

QAction *QToolBar::toggleViewAction() const

返回一个可用于显示或隐藏此工具栏的可选操作。

该操作的文本设置为工具栏的窗口标题。

另请参阅 QAction::text 和QWidget::windowTitle 。

[signal] void QToolBar::toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)

当工具按钮样式发生变化时，会触发此信号。toolButtonStyle 参数保存了工具栏的新工具按钮样式。

另请参阅 toolButtonStyle 和QMainWindow::toolButtonStyle 。

[signal] void QToolBar::topLevelChanged(bool topLevel)

当floating 属性发生变化时，会触发此信号。如果工具栏当前处于浮动状态，则topLevel 参数为true；否则为false。

另请参阅 isWindow()。

[signal] void QToolBar::visibilityChanged(bool visible)

当工具栏变为visible （或不可见）时，会发出此信号。这通常发生在小部件被隐藏或显示时。

QWidget *QToolBar::widgetForAction(QAction *action) const

返回与指定的action 关联的小部件。

另请参阅 addWidget()。