Класс 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 и Qt Widgets - Пример приложения.

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

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.

См. также allowedAreas.

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

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

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

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

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

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

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

См. также movable.

[signal] void QToolBar::orientationChanged(Qt::Orientation 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.

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

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

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

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

[since 5.6] template <typename Functor> QAction *QToolBar::addAction(const QString &text, Functor functor)

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

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

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

[since 5.6] template <typename Functor> QAction *QToolBar::addAction(const QString &text, const QObject *context, Functor functor)

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

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

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

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

[since 5.6] template <typename Functor> QAction *QToolBar::addAction(const QIcon &icon, const QString &text, Functor functor)

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

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

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

[since 5.6] template <typename Functor> 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.

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