QToolBar Class Reference
^{^{[

QtGui

module]}}

The QToolBar class provides a movable panel that contains a set of controls. 更多...

方法

__init__ ( self , QString title , QWidget parent = None)
__init__ ( self , QWidget parent = None)
QAction actionAt ( self , QPoint p )
QAction actionAt ( self , int ax , int ay )
actionEvent ( self , QActionEvent event )
QRect actionGeometry ( self , QAction action )
addAction ( self , QAction action )
QAction addAction ( self , QString text )
QAction addAction ( self , QIcon icon , QString text )
QAction addAction ( self , QString text , QObject receiver , SLOT()SLOT() member )
QAction addAction ( self , QString text , callable receiver )
QAction addAction ( self , QIcon icon , QString text , QObject receiver , SLOT()SLOT() member )
QAction addAction ( self , QIcon icon , QString text , callable receiver )
QAction addSeparator ( self )
QAction addWidget ( self , QWidget widget )
Qt.ToolBarAreas allowedAreas ( self )
changeEvent ( self , QEvent event )
childEvent ( self , QChildEvent event )
clear ( self )
bool event ( self , QEvent event )
QSize iconSize ( self )
initStyleOption ( self , QStyleOptionToolBar option )
QAction insertSeparator ( self , QAction before )
QAction insertWidget ( self , QAction before , QWidget widget )
bool isAreaAllowed ( self , Qt.ToolBarArea area )
bool isFloatable ( self )
bool isFloating ( self )
bool isMovable ( self )
Qt.Orientation orientation ( self )
paintEvent ( self , QPaintEvent event )
resizeEvent ( self , QResizeEvent event )
setAllowedAreas ( self , Qt.ToolBarAreas areas )
setFloatable ( self , bool floatable )
setIconSize ( self , QSize iconSize )
setMovable ( self , bool movable )
setOrientation ( self , Qt.Orientation orientation )
setToolButtonStyle ( self , Qt.ToolButtonStyle toolButtonStyle )
QAction toggleViewAction ( self )
Qt.ToolButtonStyle toolButtonStyle ( self )
QWidget widgetForAction ( self , QAction action )

Qt Signals

void actionTriggered (QAction*)
void allowedAreasChanged (Qt::ToolBarAreas)
void iconSizeChanged (const QSize&)
void movableChanged (bool)
void orientationChanged (Qt::Orientation)
void toolButtonStyleChanged (Qt::ToolButtonStyle)
void topLevelChanged (bool)
void visibilityChanged (bool)

详细描述

The QToolBar class provides a movable panel that contains a set of controls.

工具栏按钮被添加通过添加 actions ，使用 addAction () 或 insertAction (). Groups of buttons can be separated using addSeparator () 或 insertSeparator (). If a toolbar button is not appropriate, a widget can be inserted instead using addWidget () 或 insertWidget (); examples of suitable widgets are QSpinBox , QDoubleSpinBox ，和 QComboBox . When a toolbar button is pressed it 发射 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 ( isMovable ()) between toolbar areas; see 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 does 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 使用 addWidget (). Please use widget actions created by inheriting QWidgetAction and implementing QWidgetAction.createWidget () 代替。

方法文档编制

QToolBar.init ( self , QString title , QWidget parent = None)

parent argument, if not None, causes self to be owned by Qt instead of PyQt.

构造 QToolBar with the given parent .

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

另请参阅 setWindowTitle ().

QToolBar.init ( self , QWidget parent = None)

parent argument, if not None, causes self to be owned by Qt instead of PyQt.

构造 QToolBar with the given parent .

QAction QToolBar.actionAt ( self , QPoint p )

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

另请参阅 QWidget.childAt ().

QAction QToolBar.actionAt ( self , int ax , int ay )

这是重载函数。

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

QToolBar.actionEvent ( self , QActionEvent event )

重实现自 QWidget.actionEvent ().

QRect QToolBar.actionGeometry ( self , QAction action )

QToolBar.addAction ( self , QAction action )

这是重载函数。

追加动作 action to the toolbar's list of actions.

另请参阅 QMenu.addAction () 和 QWidget.addAction ().

QAction QToolBar.addAction ( self , QString text )

这是重载函数。

创建新的动作采用给定 text . This action is added to the end of the toolbar.

QAction QToolBar.addAction ( self , QIcon icon , QString text )

这是重载函数。

创建新的动作采用给定 icon and text . This action is added to the end of the toolbar.

QAction QToolBar.addAction ( self , QString text , QObject receiver , SLOT()SLOT() 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 ( self , QString text , callable receiver )

这是重载函数。

Creates a new action with the icon icon 和文本 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 ( self , QIcon icon , QString text , QObject receiver , SLOT()SLOT() member )

QAction QToolBar.addAction ( self , QIcon icon , QString text , callable receiver )

QAction QToolBar.addSeparator ( self )

Adds a separator to the end of the toolbar.

另请参阅 insertSeparator ().

QAction QToolBar.addWidget ( self , QWidget widget )

widget argument has it's ownership transferred to Qt.

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

The toolbar takes ownership of widget .

若添加 QToolButton with this method, the tools bar'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 ().

Qt.ToolBarAreas QToolBar.allowedAreas ( self )

QToolBar.changeEvent ( self , QEvent event )

重实现自 QWidget.changeEvent ().

QToolBar.childEvent ( self , QChildEvent event )

重实现自 QObject.childEvent ().

QToolBar.clear ( self )

Removes all actions from the toolbar.

另请参阅 removeAction ().

bool QToolBar.event ( self , QEvent event )

重实现自 QObject.event ().

QSize QToolBar.iconSize ( self )

QToolBar.initStyleOption ( self , QStyleOptionToolBar option )

QAction QToolBar.insertSeparator ( self , QAction before )

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

另请参阅 addSeparator ().

QAction QToolBar.insertWidget ( self , QAction before , QWidget widget )

widget argument has it's ownership transferred to Qt.

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 () 和 QWidget.hide () does not work.

另请参阅 addWidget ().

bool QToolBar.isAreaAllowed ( self , Qt.ToolBarArea area )

Returns true if this toolbar is dockable in the given area ；否则返回 false。

bool QToolBar.isFloatable ( self )

bool QToolBar.isFloating ( self )

bool QToolBar.isMovable ( self )

Qt.Orientation QToolBar.orientation ( self )

QToolBar.paintEvent ( self , QPaintEvent event )

重实现自 QWidget.paintEvent ().

QToolBar.resizeEvent ( self , QResizeEvent event )

重实现自 QWidget.resizeEvent ().

QToolBar.setAllowedAreas ( self , Qt.ToolBarAreas areas )

QToolBar.setFloatable ( self , bool floatable )

QToolBar.setIconSize ( self , QSize iconSize )

This method is also a Qt slot with the C++ signature void setIconSize(const QSize&) .

QToolBar.setMovable ( self , bool movable )

QToolBar.setOrientation ( self , Qt.Orientation orientation )

QToolBar.setToolButtonStyle ( self , Qt.ToolButtonStyle toolButtonStyle )

This method is also a Qt slot with the C++ signature void setToolButtonStyle(Qt::ToolButtonStyle) .

QAction QToolBar.toggleViewAction ( self )

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 .

Qt.ToolButtonStyle QToolBar.toolButtonStyle ( self )

QWidget QToolBar.widgetForAction ( self , QAction action )

Returns the widget associated with the specified action .

该函数在 Qt 4.2 引入。

另请参阅 addWidget ().