Класс 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 - Application Example.

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

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 не будет соблюдаться.

См. также 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().