QMacToolBar Class

The QMacToolBar class wraps the native NSToolbar class. 更多...

頭：	#include <QMacToolBar>
qmake:	QT += macextras
Since:	Qt 5.3
繼承：	QObject

該類已過時。 提供它是為使舊源代碼能繼續工作。強烈建議不要在新代碼中使用它。

該類在 Qt 5.3 引入。

所有成員列錶，包括繼承成員

公共函數

	QMacToolBar (const QString & identifier , QObject * parent = nullptr)
	QMacToolBar (QObject * parent = nullptr)
virtual	~QMacToolBar ()
QMacToolBarItem *	addAllowedItem (const QIcon & icon , const QString & text )
QMacToolBarItem *	addItem (const QIcon & icon , const QString & text )
void	addSeparator ()
QList<QMacToolBarItem *>	allowedItems ()
void	attachToWindow (QWindow * window )
void	detachFromWindow ()
QList<QMacToolBarItem *>	items ()
NSToolbar *	nativeToolbar () const
void	setAllowedItems (QList<QMacToolBarItem > & allowedItems* )
void	setItems (QList<QMacToolBarItem > & items* )

詳細描述

QMacToolBar provides a Qt-based API for NSToolBar. The toolbar displays one or more items . Each toolbar item has an icon and a text label.

The toolbar must be attached to a QWindow 使用 attachToWindow() method in order to be visible. The toolbar is attached to the native NSWindow and is displayed above the QWindow . QMacToolBar visibility follows window visibility.

Add items by calling addItem (). The toolbar has a customization menu which is available to the user from the toolbar context menu. Use addAllowedItem () to add items to the customization menu.

Usage: ( QtWidgets )

QMacToolBar *toolBar = new QMacToolBar(this);
QMacToolBarItem *toolBarItem = toolBar->addItem(QIcon(), QStringLiteral("foo"));
connect(toolBarItem, SIGNAL(activated()), this, SLOT(fooClicked()));
this->window()->winId(); // create window->windowhandle()
toolBar->attachToWindow(this->window()->windowHandle());

另請參閱 QMacToolBarItem .

成員函數文檔編製

QMacToolBar:: QMacToolBar (const QString & identifier , QObject * parent = nullptr)

Constructs a QMacToolBar with the given identifier and parent . The identifier is used to uniquely identify the toolbar within the appliation, for example when autosaving the toolbar configuration.

QMacToolBar:: QMacToolBar ( QObject * parent = nullptr)

Constructs a QMacToolBar with the given parent

`[虛擬]` QMacToolBar:: ~QMacToolBar ()

銷毀工具欄。

QMacToolBarItem QMacToolBar:: addAllowedItem (const QIcon & icon* , const QString & text )

Add atoolbar item with icon and text to the toolbar customization menu.

QMacToolBarItem QMacToolBar:: addItem (const QIcon & icon* , const QString & text )

Add a toolbar item with icon and text .

void QMacToolBar:: addSeparator ()

Add a toolbar separator item.

QList < QMacToolBarItem *> QMacToolBar:: allowedItems ()

Returns the list oftoolbar items shown on the the toolbar customization menu.

另請參閱 setAllowedItems ().

void QMacToolBar:: attachToWindow ( QWindow * window )

Attaches the toolbar to window . The toolbar will be displayed at the top of the native window, under and attached to the title bar above the QWindow . The toolbar is displayed outside the QWidnow area.

使用 QWidget::windowHandle () to get a QWindow pointer from a QWidget instance. At app startup the QWindow might not have been created yet, call QWidget::winId () to make sure it is.

void QMacToolBar:: detachFromWindow ()

Detatches the toolbar from the current window.

QList < QMacToolBarItem *> QMacToolBar:: items ()

Returns the list of the default toolbar items.

另請參閱 setItems ().

NSToolbar *QMacToolBar:: nativeToolbar () const

Returns the naitve NSTooolbar object.

void QMacToolBar:: setAllowedItems ( QList < QMacToolBarItem > & allowedItems* )

Sets the list of toolbar items shown on the toolbar customization menu to allowedItems .

另請參閱 allowedItems ().

void QMacToolBar:: setItems ( QList < QMacToolBarItem > & items* )

Sets the list of the default toolbar items .

另請參閱 items ().