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 点的操作。如果未找到任何操作，该函数将返回 0。

另请参见 QWidget::childAt()。

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

这是一个重载函数。

返回x,y 处的动作。如果未找到动作，该函数将返回 0。

[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)

在与before 操作相关联的工具栏项目前插入给定的widget 。

注意：应使用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 关联的 widget。

另请参阅 addWidget()。