Класс QMacToolBar

Класс QMacToolBar оборачивает родной класс NSToolbar. Подробнее...

Этот класс был представлен в Qt 5.3.

• Список всех членов, включая унаследованные

Открытые функции

Подробное описание

QMacToolBar предоставляет Qt-базовый API для NSToolBar. Панель инструментов отображает один или несколько элементов.

Каждый элемент панели инструментов имеет значок и метку.

Панель инструментов должна быть прикреплена к QWindow с помощью метода attachToWindow(), чтобы быть видимой. Панель инструментов прикреплена к родной NSWindow и отображается над QWindow. Видимость QMacToolBar следует за видимостью окна.

Добавьте элементы, вызвав addItem(). Панель инструментов имеет меню настройки, доступное пользователю из контекстного меню панели инструментов. Используйте addAllowedItem(), чтобы добавить элементы в меню настроек.

Использование: (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)

Создает QMacToolBar с заданным идентификатором identifier и родительским объектом parent. Идентификатор используется для уникальной идентификации панели инструментов в приложении, например, при автоматическом сохранении конфигурации панели инструментов.

QMacToolBar::QMacToolBar(QObject *parent = nullptr)

Создаёт QMacToolBar с заданным родительским объектом parent.

[virtual] QMacToolBar::~QMacToolBar()

Уничтожает панель инструментов.

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

Добавляет элемент панели инструментов со значком icon и текстом text в меню настроек панели инструментов.

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

Добавляет элемент панели инструментов со значком icon и текстом text.

void QMacToolBar::addSeparator()

Добавляет разделитель панели инструментов.

QList<QMacToolBarItem *> QMacToolBar::allowedItems()

Возвращает список элементов панели инструментов, отображаемых в меню настроек панели инструментов.

См. также setAllowedItems().

void QMacToolBar::attachToWindow(QWindow *window)

Прикрепляет панель инструментов к окну window. Панель инструментов будет отображаться в верхней части родного окна, под и прикрепленной к строке заголовка над QWindow. Панель инструментов отображается вне области QWidnow.

Используйте QWidget::windowHandle(), чтобы получить указатель QWindow из экземпляра QWidget. В начале приложения QWindow может еще не быть создан, вызовите QWidget::winId(), чтобы убедиться, что он есть.

void QMacToolBar::detachFromWindow()

Открепляет панель инструментов от текущего окна.

QList<QMacToolBarItem *> QMacToolBar::items()

Возвращает список стандартных элементов панели инструментов.

См. также setItems().

NSToolbar *QMacToolBar::nativeToolbar() const

Возвращает родной объект NSToolbar.

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

Устанавливает список элементов панели инструментов, отображаемых в меню настроек панели инструментов, в allowedItems.

См. также allowedItems().

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

Устанавливает список стандартных элементов панели инструментов items.

См. также items().