内容

• 特性
• 公共函数
• 公共槽
• 信号
• 重实现保护函数
• 详细描述

QToolBar 类

QToolBar 类提供包含一组控件的可移动面板。 更多...

头：	#include <QToolBar>
CMake:	find_package(Qt6 COMPONENTS Widgets REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake:	QT += widgets
继承：	QWidget

• 所有成员列表，包括继承成员

特性

allowedAreas : Qt::ToolBarAreas floatable : bool floating : const bool iconSize : QSize

movable : bool orientation : Qt::Orientation toolButtonStyle : Qt::ToolButtonStyle

公共函数

	QToolBar (QWidget * parent = nullptr)
	QToolBar (const QString & title , QWidget * parent = nullptr)
virtual	~QToolBar ()
QAction *	actionAt (const QPoint & p ) const
QAction *	actionAt (int x , int y ) const
QAction *	addAction (const QString & text )
QAction *	addAction (const QIcon & icon , const QString & text )
QAction *	addAction (const QString & text , const QObject * receiver , const char * member )
QAction *	addAction (const QIcon & icon , const QString & text , const QObject * receiver , const char * member )
QAction *	addAction (const QString & text , Functor functor )
QAction *	addAction (const QString & text , const QObject * context , Functor functor )
QAction *	addAction (const QIcon & icon , const QString & text , Functor functor )
QAction *	addAction (const QIcon & icon , const QString & text , const QObject * context , Functor functor )
QAction *	addSeparator ()
QAction *	addWidget (QWidget * widget )
Qt::ToolBarAreas	allowedAreas () const
void	clear ()
QSize	iconSize () const
QAction *	insertSeparator (QAction * before )
QAction *	insertWidget (QAction * before , QWidget * widget )
bool	isAreaAllowed (Qt::ToolBarArea area ) const
bool	isFloatable () const
bool	isFloating () const
bool	isMovable () const
Qt::Orientation	orientation () const
void	setAllowedAreas (Qt::ToolBarAreas areas )
void	setFloatable (bool floatable )
void	setMovable (bool movable )
void	setOrientation (Qt::Orientation orientation )
QAction *	toggleViewAction () const
Qt::ToolButtonStyle	toolButtonStyle () const
QWidget *	widgetForAction (QAction * action ) const

公共槽

void	setIconSize (const QSize & iconSize )
void	setToolButtonStyle (Qt::ToolButtonStyle toolButtonStyle )

信号

void	actionTriggered (QAction * action )
void	allowedAreasChanged (Qt::ToolBarAreas allowedAreas )
void	iconSizeChanged (const QSize & iconSize )
void	movableChanged (bool movable )
void	orientationChanged (Qt::Orientation orientation )
void	toolButtonStyleChanged (Qt::ToolButtonStyle toolButtonStyle )
void	topLevelChanged (bool topLevel )
void	visibilityChanged (bool visible )

重实现保护函数

virtual void	actionEvent (QActionEvent * event ) override
virtual void	changeEvent (QEvent * event ) override
virtual bool	event (QEvent * event ) override
virtual void	paintEvent (QPaintEvent * event ) override

详细描述

工具栏按钮被添加通过添加 actions ，使用 addAction () 或 insertAction ()。按钮组的分隔可以使用 addSeparator () 或 insertSeparator ()。若工具栏按钮不合适，可以插入 Widget 而不是使用 addWidget () 或 insertWidget (). Examples of suitable widgets are QSpinBox , QDoubleSpinBox ，和 QComboBox . When a toolbar button is pressed, it emits the actionTriggered () 信号。

A toolbar can be fixed in place in a particular area (e.g., at the top of the window), or it can be movable between toolbar areas; see setMovable (), isMovable (), allowedAreas () 和 isAreaAllowed ().

When a toolbar is resized in such a way that it is too small to show all the items it contains, an extension button will appear as the last item in the toolbar. Pressing the extension button will pop up a menu containing the items that do not currently fit in the toolbar.

When a QToolBar is not a child of a QMainWindow , it loses the ability to populate the extension pop up with widgets added to the toolbar using addWidget (). Please use widget actions created by inheriting QWidgetAction and implementing QWidgetAction::createWidget () 代替。

另请参阅 QToolButton , QMenu , QAction ，和 Qt Widgets - 应用程序范例 .

特性文档编制

allowedAreas : Qt::ToolBarAreas

可以放置工具栏的区域

默认为 Qt::AllToolBarAreas .

This property only makes sense if the toolbar is in a QMainWindow .

访问函数：

Qt::ToolBarAreas	allowedAreas () const
void	setAllowedAreas (Qt::ToolBarAreas areas )

通知程序信号：

void	allowedAreasChanged (Qt::ToolBarAreas allowedAreas )

另请参阅 movable .

floatable : bool

This property holds whether the toolbar can be dragged and dropped as an independent window.

默认为 true。

访问函数：

bool	isFloatable () const
void	setFloatable (bool floatable )

[read-only] floating : const bool

This property holds whether the toolbar is an independent window.

默认情况下，此特性为 true .

访问函数：

bool	isFloating () const

另请参阅 QWidget::isWindow ().

iconSize : QSize

size of icons in the toolbar.

The default size is determined by the application's style and is derived from the QStyle::PM_ToolBarIconSize pixel metric. It is the maximum size an icon can have. Icons of smaller size will not be scaled up.

访问函数：

QSize	iconSize () const
void	setIconSize (const QSize & iconSize )

通知程序信号：

void	iconSizeChanged (const QSize & iconSize )

movable : bool

This property holds whether the user can move the toolbar within the toolbar area, or between toolbar areas.

默认情况下，此特性为 true .

This property only makes sense if the toolbar is in a QMainWindow .

访问函数：

bool	isMovable () const
void	setMovable (bool movable )

通知程序信号：

void	movableChanged (bool movable )

另请参阅 allowedAreas .

orientation : Qt::Orientation

工具栏的取向

默认为 Qt::Horizontal .

This function should not be used when the toolbar is managed by QMainWindow 。可以使用 QMainWindow::addToolBar () 或 QMainWindow::insertToolBar () if you wish to move a toolbar that is already added to a main window to another Qt::ToolBarArea .

访问函数：

Qt::Orientation	orientation () const
void	setOrientation (Qt::Orientation orientation )

通知程序信号：

void	orientationChanged (Qt::Orientation orientation )

toolButtonStyle : Qt::ToolButtonStyle

This property holds the style of toolbar buttons

This property defines the style of all tool buttons that are added as QAction s. Note that if you add a QToolButton 采用 addWidget () method, it will not get this button style.

要让工具按钮样式遵循系统设置，将此特性设为 Qt::ToolButtonFollowStyle 。在 Unix，将使用来自桌面环境的用户设置。在其它平台， Qt::ToolButtonFollowStyle 意味着仅图标。

默认为 Qt::ToolButtonIconOnly .

访问函数：

Qt::ToolButtonStyle	toolButtonStyle () const
void	setToolButtonStyle (Qt::ToolButtonStyle toolButtonStyle )

通知程序信号：

void	toolButtonStyleChanged (Qt::ToolButtonStyle toolButtonStyle )

成员函数文档编制

QToolBar:: QToolBar ( QWidget * parent = nullptr)

Constructs a QToolBar with the given parent .

QToolBar:: QToolBar (const QString & title , QWidget * parent = 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 ().

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

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

注意： 通知程序信号对于特性 allowedAreas .

另请参阅 allowedAreas .

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

注意： 通知程序信号对于特性 iconSize .

另请参阅 iconSize and QMainWindow::iconSize .

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

注意： 通知程序信号对于特性 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.

注意： 通知程序信号对于特性 orientation .

另请参阅 orientation .

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

注意： 通知程序信号对于特性 toolButtonStyle .

另请参阅 toolButtonStyle and QMainWindow::toolButtonStyle .

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

此信号被发射当 floating 特性改变。 topLevel parameter is true if the toolbar is now floating; otherwise it is false.

另请参阅 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.

[虚拟] 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

这是重载函数。

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

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

重实现： QWidget::actionEvent (QActionEvent *event).

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

创建新的动作采用给定 text 。此动作将被添加到工具栏末尾。

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

这是重载函数。

创建新的动作采用给定 icon and text 。此动作将被添加到工具栏末尾。

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

这是重载函数。

创建新的动作采用给定 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 )

这是重载函数。

创建新的动作采用给定 icon and text . This action is added to the end of the toolbar. The action's triggered() signal is connected to member in receiver .

[since 5.6] template <typename Functor> QAction *QToolBar:: addAction (const QString & text , Functor functor )

这是重载函数。

创建新的动作采用给定 text . This action is added to the end of the toolbar. The action's triggered() signal is connected to the functor .

该函数在 Qt 5.6 引入。

[since 5.6] template <typename Functor> QAction *QToolBar:: addAction (const QString & text , const QObject * context , Functor functor )

这是重载函数。

创建新的动作采用给定 text . This action is added to the end of the toolbar. The action's triggered() signal is connected to the functor 。 functor can be a pointer to a member function in the context 对象。

若 context object is destroyed, the functor 不会被调用。

该函数在 Qt 5.6 引入。

[since 5.6] template <typename Functor> QAction *QToolBar:: addAction (const QIcon & icon , const QString & text , Functor functor )

这是重载函数。

创建新的动作采用给定 icon and text . This action is added to the end of the toolbar. The action's triggered() signal is connected to the functor .

该函数在 Qt 5.6 引入。

[since 5.6] template <typename Functor> QAction *QToolBar:: addAction (const QIcon & icon , const QString & text , const QObject * context , Functor functor )

这是重载函数。

创建新的动作采用给定 icon and text . This action is added to the end of the toolbar. The action's triggered() signal is connected to the functor 。 functor can be a pointer to a member function of the context 对象。

若 context object is destroyed, the functor 不会被调用。

该函数在 Qt 5.6 引入。

QAction *QToolBar:: addSeparator ()

Adds a separator to the end of the toolbar.

另请参阅 insertSeparator ().

QAction *QToolBar:: addWidget ( QWidget * widget )

添加给定 widget to the toolbar as the toolbar's last item.

The toolbar takes ownership of widget .

若添加 QToolButton with this method, the toolbar's Qt::ToolButtonStyle will not be respected.

注意： 应使用 QAction::setVisible () to change the visibility of the widget. Using QWidget::setVisible (), QWidget::show () 和 QWidget::hide () does not work.

另请参阅 insertWidget ().

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

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 )

插入给定 widget in front of the toolbar item associated with the before action.

注意：应使用 QAction::setVisible () to change the visibility of the widget. Using QWidget::setVisible (), QWidget::show () 和 QWidget::hide () does not work.

另请参阅 addWidget ().

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

返回 true 若此工具栏可停放在给定 area ；否则返回 false .

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

重实现： QWidget::paintEvent (QPaintEvent *event).

QAction *QToolBar:: toggleViewAction () const

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

动作的文本被设为工具栏的窗口标题。

另请参阅 QAction::text and QWidget::windowTitle .

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

返回的 Widget 关联指定 action .

另请参阅 addWidget ().