Класс QToolBar

Класс 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(QWidget *parent = nullptr)

Конструктор QToolBar с заданным parent.

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

Конструктор QToolBar с заданным parent.

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

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

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

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

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

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

См. также allowedAreas.

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

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

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

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

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

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

См. также movable.

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

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

См. также orientation.

[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)

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

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

[virtual] QToolBar::~QToolBar()

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

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

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

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

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

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

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

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

Переопределяет: QWidget::actionEvent(QActionEvent *event).

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, Functor functor)

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

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

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

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

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

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

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

Эта функция была добавлена в 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. Functor может быть указателем на член-функцию объекта context.

Если объект 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().

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

Переопределяет: QWidget::changeEvent(QEvent *event).

void QToolBar::clear()

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

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

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

Переопределяет: QWidget::event(QEvent *event).

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.

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

Переопределяет: QWidget::paintEvent(QPaintEvent *event).

QAction *QToolBar::toggleViewAction() const

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

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

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

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

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

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

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