Класс QToolBar

Класс QToolBar предоставляет перемещаемую панель, содержащую набор элементов управления. Подробнее...

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

Свойства

• 59 свойств, унаследованных от QWidget
• 1 свойство, унаследованное от QObject

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

• 214 открытых функции, унаследованных от QWidget
• 32 открытых функции, унаследованных от QObject
• 14 открытых функции, унаследованных от QPaintDevice

Открытые слоты

• 19 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject

Сигналы

• 3 сигнала, унаследованных от QWidget
• 2 сигнала, унаследованных от QObject

Переопределённые защищённые функции

• 35 защищенных функций, унаследованных от QWidget
• 9 защищенных функций, унаследованных от QObject
• 1 защищенная функция, унаследованная от QPaintDevice

Дополнительные унаследованные члены

• 5 статических публичных членов, унаследованных от QWidget
• 11 статических публичных членов, унаследованных от QObject
• 35 защищенных функций, унаследованных от QWidget
• 9 защищенных функций, унаследованных от QObject
• 1 защищенная функция, унаследованная от QPaintDevice
• 1 защищенный слот, унаследованный от QWidget

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

Класс QToolBar предоставляет перемещаемую панель, содержащую набор элементов управления.

Кнопки на панели инструментов добавляются путём добавления действий, используя addAction() или insertAction(). Группы кнопок можно разделить, используя addSeparator() или insertSeparator(). Если кнопка панели инструментов не подходит, можно вставить виджет вместо неё, используя addWidget() или insertWidget(). Примерами подходящих виджетов являются QSpinBox, QDoubleSpinBox и QComboBox. При нажатии на кнопку панели инструментов генерится сигнал actionTriggered().

Панель инструментов может быть закреплена в определённой области (например, в верхней части окна) или перемещена между областями панели инструментов; см. setMovable(), isMovable(), allowedAreas() и isAreaAllowed().

Когда размер панели инструментов уменьшается до такой степени, что все элементы не могут быть отображены, появляется кнопка расширения, которая отображается в качестве последнего элемента на панели инструментов. Нажатие на кнопку расширения откроет меню, содержащее элементы, которые не помещаются на панели инструментов.

Если QToolBar не является дочерним элементом QMainWindow, то он теряет возможность заполнять всплывающее меню расширения виджетами, добавленными в панель инструментов с помощью addWidget(). Вместо этого используйте действия виджета, созданные путём наследования от QWidgetAction и реализацией QWidgetAction::createWidget().

См. также QToolButton, QMenu, QAction и Пример приложения.

Документация функций-членов

QToolBar::QToolBar(const QString &title, QWidget *parent = Q_NULLPTR)

Создаёт QToolBar с заданным parent.

Заданное окно title идентифицирует панель инструментов и отображается в контекстном меню, предоставляемом QMainWindow.

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

QToolBar::QToolBar(QWidget *parent = Q_NULLPTR)

Создаёт QToolBar с заданным parent.

QToolBar::~QToolBar()

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

QAction *QToolBar::actionAt(const QPoint &p) const

Возвращает действие в точке p. Эта функция возвращает ноль, если действие не найдено.

См. также QWidget::childAt().

QAction *QToolBar::actionAt(int x, int y) const

Это перегруженная функция.

Возвращает действие в точке x, y. Эта функция возвращает ноль, если действие не найдено.

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

Переопределено из QWidget::actionEvent().

[signal] void QToolBar::actionTriggered(QAction *action)

Этот сигнал испускается, когда действие в этой панели инструментов активируется. Это происходит, когда кнопка инструмента действия нажимается, или когда действие активируется каким-либо другим способом вне панели инструментов. Параметр содержит активированное действие.

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

Это перегруженная функция.

Создаёт новое действие с заданным text. Это действие добавляется в конец панели инструментов.

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

Это перегруженная функция.

Создаёт новое действие с заданным icon и text. Это действие добавляется в конец панели инструментов.

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

Это перегруженная функция.

Создаёт новое действие с заданным text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к member в receiver.

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

Это перегруженная функция.

Создаёт новое действие с заданным icon и text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к member в receiver.

QAction *QToolBar::addAction(const QString &text, const QObject *receiver, PointerToMemberFunction method)

Это перегруженная функция.

Создаёт новое действие с заданным text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к method объекта receiver.

Эта функция была добавлена в Qt 5.6.

QAction *QToolBar::addAction(const QString &text, Functor functor)

Это перегруженная функция.

Создаёт новое действие с заданным text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к functor.

Эта функция была добавлена в Qt 5.6.

QAction *QToolBar::addAction(const QString &text, const QObject *context, Functor functor)

Это перегруженная функция.

Создаёт новое действие с заданным text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к functor.

Если context уничтожается, functor не будет вызван.

Эта функция была добавлена в Qt 5.6.

QAction *QToolBar::addAction(const QIcon &icon, const QString &text, const QObject *receiver, PointerToMemberFunction method)

Это перегруженная функция.

Создаёт новое действие с заданным icon и text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к method объекта receiver.

Эта функция была добавлена в Qt 5.6.

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

Это перегруженная функция.

Создаёт новое действие с заданным icon и text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к functor.

Эта функция была добавлена в Qt 5.6.

QAction *QToolBar::addAction(const QIcon &icon, const QString &text, const QObject *context, Functor functor)

Это перегруженная функция.

Создаёт новое действие с заданным icon и text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к functor.

Если context уничтожается, functor не будет вызван.

Эта функция была добавлена в Qt 5.6.

QAction *QToolBar::addSeparator()

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

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

QAction *QToolBar::addWidget(QWidget *widget)

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

Панель инструментов принимает владение widget.

Если вы добавляете QToolButton с помощью этого метода, стиль панели инструментов Qt::ToolButtonStyle не будет учтён.

Примечание: Используйте QAction::setVisible(), чтобы изменить видимость виджета. Использование QWidget::setVisible(), QWidget::show() и QWidget::hide() не работает.

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

[signal] void QToolBar::allowedAreasChanged(Qt::ToolBarAreas allowedAreas)

Этот сигнал испускается, когда изменяется набор разрешённых областей для панели инструментов. Новые области, в которых может быть расположена панель инструментов, задаются параметром allowedAreas.

Примечание: Сигнал уведомления для свойства allowedAreas.

См. также allowedAreas.

[virtual protected] void QToolBar::changeEvent(QEvent *event)

Переопределено из QWidget::changeEvent().

void QToolBar::clear()

Удаляет все действия из панели инструментов.

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

[virtual protected] bool QToolBar::event(QEvent *event)

Переопределено из QObject::event().

[signal] void QToolBar::iconSizeChanged(const QSize &iconSize)

Этот сигнал испускается при изменении размера значка. Параметр iconSize содержит новый размер значка панели инструментов.

Примечание: Сигнал уведомления для свойства iconSize.

См. также iconSize и QMainWindow::iconSize.

QAction *QToolBar::insertSeparator(QAction *before)

Вставляет разделитель в панель инструментов перед элементом панели инструментов, связанным с действием before.

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

QAction *QToolBar::insertWidget(QAction *before, QWidget *widget)

Вставляет заданный widget перед элементом панели инструментов, связанным с действием before.

Примечание: для изменения видимости виджета необходимо использовать QAction::setVisible(). Использование QWidget::setVisible(), QWidget::show() и QWidget::hide() не работает.

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

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

Возвращает true , если эта панель инструментов может быть привязана к заданной области area; в противном случае возвращает false.

[signal] void QToolBar::movableChanged(bool movable)

Этот сигнал подаётся, когда панель инструментов становится перемещаемой или закреплённой. Если панель инструментов может быть перемещена, movable имеет значение true; в противном случае — false.

Примечание: Сигнал уведомления для свойства movable.

См. также movable.

[signal] void QToolBar::orientationChanged(Qt::Orientation orientation)

Этот сигнал подаётся, когда ориентация панели инструментов изменяется. Параметр orientation содержит новую ориентацию панели инструментов.

Примечание: Сигнал уведомления для свойства orientation.

См. также orientation.

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

Переопределено из QWidget::paintEvent().

QAction *QToolBar::toggleViewAction() const

Возвращает управляемое действие, которое можно использовать для отображения или скрытия этой панели инструментов.

Текст действия устанавливается в заголовок окна панели инструментов.

См. также QAction::text и QWidget::windowTitle.

[signal] void QToolBar::toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)

Этот сигнал подаётся, когда меняется стиль кнопок инструментов. Параметр toolButtonStyle содержит новый стиль кнопок инструментов панели инструментов.

Примечание: Сигнал уведомления для свойства toolButtonStyle.

См. также toolButtonStyle и QMainWindow::toolButtonStyle.

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

Этот сигнал подаётся, когда меняется свойство floating. Параметр topLevel равен true, если панель инструментов сейчас плавающая; в противном случае — false.

Эта функция была введена в Qt 4.6.

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

[signal] void QToolBar::visibilityChanged(bool visible)

Этот сигнал подаётся, когда панель инструментов становится видимой (или невидимой). Это происходит при скрытии или показе виджета.

Эта функция была введена в Qt 4.7.

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

Возвращает виджет, связанный с заданным действием action.

Эта функция была введена в Qt 4.2.

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