QToolBar Class

成员函数

QToolBar::QToolBar(const QString &title, QWidget *parent = Q_NULLPTR)

Constructs a QToolBar with the given parent.

The given window title identifies the toolbar and is shown in the context menu provided by QMainWindow.

参见 setWindowTitle().

QToolBar::QToolBar(QWidget *parent = Q_NULLPTR)

Constructs a QToolBar with the given parent.

QToolBar::~QToolBar()

Destroys the toolbar.

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

Returns the action at point p. This function returns zero if no action was found.

参见 QWidget::childAt().

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

This is an overloaded function.

Returns the action at the point x, y. This function returns zero if no action was found.

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

重新实现 QWidget::actionEvent().

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

This signal is emitted when an action in this toolbar is triggered. This happens when the action's tool button is pressed, or when the action is triggered in some other way outside the toolbar. The parameter holds the triggered action.

QAction *QToolBar::addAction(const QString &text)

This is an overloaded function.

Creates a new action with the given text. This action is added to the end of the toolbar.

QAction *QToolBar::addAction(const QIcon &icon, const QString &text)

This is an overloaded function.

Creates a new action with the given icon and text. This action is added to the end of the toolbar.

QAction *QToolBar::addAction(const QString &text, const QObject *receiver, const char *member)

This is an overloaded function.

Creates a new action with the given text. This action is added to the end of the toolbar. The action's triggered() signal is connected to member in receiver.

QAction *QToolBar::addAction(const QIcon &icon, const QString &text, const QObject *receiver, const char *member)

This is an overloaded function.

Creates a new action with the given icon and text. This action is added to the end of the toolbar. The action's triggered() signal is connected to member in receiver.

QAction *QToolBar::addAction(const QString &text, const QObject *receiver, PointerToMemberFunction method)

This is an overloaded function.

Creates a new action with the given text. This action is added to the end of the toolbar. The action's triggered() signal is connected to the method of the receiver.

This function was introduced in Qt 5.6.

QAction *QToolBar::addAction(const QString &text, Functor functor)

This is an overloaded function.

Creates a new action with the given text. This action is added to the end of the toolbar. The action's triggered() signal is connected to the functor.

This function was introduced in Qt 5.6.

QAction *QToolBar::addAction(const QString &text, const QObject *context, Functor functor)

This is an overloaded function.

Creates a new action with the given text. This action is added to the end of the toolbar. The action's triggered() signal is connected to the functor.

If context is destroyed, the functor will not be called.

This function was introduced in Qt 5.6.

QAction *QToolBar::addAction(const QIcon &icon, const QString &text, const QObject *receiver, PointerToMemberFunction method)

This is an overloaded function.

Creates a new action with the given icon and text. This action is added to the end of the toolbar. The action's triggered() signal is connected to the method of the receiver.

This function was introduced in Qt 5.6.

QAction *QToolBar::addAction(const QIcon &icon, const QString &text, Functor functor)

This is an overloaded function.

Creates a new action with the given icon and text. This action is added to the end of the toolbar. The action's triggered() signal is connected to the functor.

This function was introduced in Qt 5.6.

QAction *QToolBar::addAction(const QIcon &icon, const QString &text, const QObject *context, Functor functor)

This is an overloaded function.

Creates a new action with the given icon and text. This action is added to the end of the toolbar. The action's triggered() signal is connected to the functor.

If context is destroyed, the functor will not be called.

This function was introduced in Qt 5.6.

QAction *QToolBar::addSeparator()

Adds a separator to the end of the toolbar.

参见 insertSeparator().

QAction *QToolBar::addWidget(QWidget *widget)

Adds the given widget to the toolbar as the toolbar's last item.

The toolbar takes ownership of widget.

If you add a QToolButton with this method, the toolbar's Qt::ToolButtonStyle will not be respected.

Note: You should use QAction::setVisible() to change the visibility of the widget. Using QWidget::setVisible(), QWidget::show() and QWidget::hide() does not work.

参见 insertWidget().

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

This signal is emitted when the collection of allowed areas for the toolbar is changed. The new areas in which the toolbar can be positioned are specified by allowedAreas.

Note: Notifier signal for property allowedAreas.

参见 allowedAreas.

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

重新实现 QWidget::changeEvent().

void QToolBar::clear()

Removes all actions from the toolbar.

参见 removeAction().

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

重新实现 QObject::event().

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

This signal is emitted when the icon size is changed. The iconSize parameter holds the toolbar's new icon size.

Note: Notifier signal for property iconSize.

参见 iconSize and QMainWindow::iconSize.

QAction *QToolBar::insertSeparator(QAction *before)

Inserts a separator into the toolbar in front of the toolbar item associated with the before action.

参见 addSeparator().

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

Inserts the given widget in front of the toolbar item associated with the before action.

Note: You should use QAction::setVisible() to change the visibility of the widget. Using QWidget::setVisible(), QWidget::show() and QWidget::hide() does not work.

参见 addWidget().

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

Returns true if this toolbar is dockable in the given area; otherwise returns false.

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

This signal is emitted when the toolbar becomes movable or fixed. If the toolbar can be moved, movable is true; otherwise it is false.

Note: Notifier signal for property movable.

参见 movable.

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

This signal is emitted when the orientation of the toolbar changes. The orientation parameter holds the toolbar's new orientation.

Note: Notifier signal for property orientation.

参见 orientation.

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

重新实现 QWidget::paintEvent().

QAction *QToolBar::toggleViewAction() const

Returns a checkable action that can be used to show or hide this toolbar.

The action's text is set to the toolbar's window title.

参见 QAction::text and QWidget::windowTitle.

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

This signal is emitted when the tool button style is changed. The toolButtonStyle parameter holds the toolbar's new tool button style.

Note: Notifier signal for property toolButtonStyle.

参见 toolButtonStyle and QMainWindow::toolButtonStyle.

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

This signal is emitted when the floating property changes. The topLevel parameter is true if the toolbar is now floating; otherwise it is false.

This function was introduced in Qt 4.6.

参见 isWindow().

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

This signal is emitted when the toolbar becomes visible (or invisible). This happens when the widget is hidden or shown.

This function was introduced in Qt 4.7.

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

Returns the widget associated with the specified action.

This function was introduced in Qt 4.2.

参见 addWidget().