Класс 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. Панель инструментов отображается вне области QWindow.

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

void QMacToolBar::detachFromWindow()

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

QList<QMacToolBarItem *> QMacToolBar::items()

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

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

NSToolbar *QMacToolBar::nativeToolbar() const

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

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

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

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

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

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

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